Skip to content

Commit b4f4ce1

Browse files
committed
Require root plan files for Ralph Loop
1 parent 4fa710d commit b4f4ce1

1 file changed

Lines changed: 12 additions & 4 deletions

File tree

docs/templates/AGENTS.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)