@@ -167,14 +167,22 @@ Local `AGENTS.md` files may tighten these values, but they must not loosen them
167167 - current state
168168 - required change
169169 - constraints and risks
170- - For non-trivial work, keep a written implementation plan in the feature doc, ADR, issue, or PR description.
170+ - For non-trivial work, create a root-level ` <slug>.plan.md ` file before making code or doc changes.
171+ - Keep the ` <slug>.plan.md ` file as the working plan for the task until completion.
172+ - The plan file MUST contain:
173+ - task goal and scope
174+ - constraints and risks
175+ - ordered implementation steps
176+ - a checklist with explicit done criteria for each step
177+ - ordered final validation skills and commands, with reason for each
171178- Use the Ralph Loop for every non-trivial task:
172- - plan in detail before coding or document edits
173- - include ordered final validation skills in the plan, with reason for each skill
179+ - plan in detail in ` <slug>.plan.md ` before coding or document edits
180+ - include ordered final validation skills in the plan file , with reason for each skill
174181 - require each selected skill to produce a concrete action, artifact, or verification outcome
175182 - execute one planned step at a time
183+ - mark checklist items in ` <slug>.plan.md ` as work progresses
176184 - review findings, apply fixes, and rerun relevant verification
177- - update the plan and repeat until done criteria are met or an explicit exception is documented
185+ - update the plan file and repeat until done criteria are met or an explicit exception is documented
178186- Implement code and tests together.
179187- Run verification in layers:
180188 - changed tests
0 commit comments