Ralph Specum Tasks
Use this for the tasks phase.
Contract
- Resolve the active spec by explicit path, exact name, or
.current-spec - Require
requirements.mdanddesign.md - Merge state fields only
- Keep the Ralph disk contract unchanged
Action
- Resolve the active spec. If none exists, stop.
- Require
requirements.mdanddesign.md. Readresearch.mdwhen present,.progress.md, and current state. - Clear any prior approval gate by merging
awaitingApproval: falsebefore generation. - Respect
granularityfrom state. Allow--tasks-size fine|coarseto override it. In quick mode, default unset granularity tofine. - Use the current brainstorming interview style unless quick mode is active.
- Write or rewrite
tasks.md. - Count tasks and merge state with:
phase: "tasks"awaitingApproval: truetaskIndex: first incomplete or totalTaskstotalTasks: counted tasks
- Update
.progress.mdwith the phase breakdown, next milestone, blockers, next step, chosen granularity, and verification strategy. - If spec commits are enabled, commit only the spec artifacts.
- In quick mode, review quickly, then continue directly into implementation.
Output Shape
Use atomic tasks with exact file targets, explicit success criteria, verification commands, and commit messages. Preserve POC-first ordering. Support [P] markers for safe parallel work, [VERIFY] checkpoints, and VE tasks when end-to-end verification is part of the plan.
Response Handoff
- After writing
tasks.md, nametasks.mdand summarize the task plan briefly. - End with exactly one explicit choice prompt:
approve current artifactrequest changescontinue to implementation
- Treat
continue to implementationas approval oftasks.md.