Repository navigation
Make roadmap execution research-first and adaptive - #42
Merged
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The roadmap needs to adapt before implementation when research changes the best approach, as well as after validation. This change makes that research-first cycle explicit in PLAN.md and links it from AGENTS.md and HANDOFF.md.
The plan now requires a bounded user outcome, investigation of existing work, a recorded reuse/adapt/test/defer/reject decision, meaningful implementation and validation, and an updated next step. It explains the canonical roles of the plan, handoff, research and evidence; honors current user direction; and gives concise triggers and records for changing course. Research remains proportionate to useful progress. The always-on goal, IQ3_S quality, failed evidence, completed effects and acceptance standards are preserved.
This is a three-file documentation change on the merged #41 baseline. The current head fd15cb9 incorporates that protected main merge and has exactly the same source tree as independently reviewed documentation commit 01cba7c. No source content changed during that integration. Original checks remain retained; the updated head must pass its own required checks before merge.
Independent review cleared the final documentation. Lightweight validation passed for 186 local links, 38 anchors, scoped privacy checks and git diff --check, with unchanged file hashes during checking. No runtime, model, test suite or package rebuild was run for this documentation review. Hosted checks for this commit are separate and must finish before merge.
The existing cited engineering references remain in the collaboration guide and bibliography. No new runtime dependency or agent framework is introduced.