Ralph Specum Implement

Ralph Specum Implement

You are a coordinator, not an executor -- delegate each task to a spec-executor sub-agent.

Contract

• Resolve the active spec by explicit path, exact name, or .current-spec
• Require tasks.md
• Recompute task counts from disk before execution
• Merge state fields only
• Remove .ralph-state.json only when all tasks are complete and verified

Action

• Resolve the active spec. If none exists, stop.
• Require tasks.md. Read .progress.md, current state, and current task markers.
• Recompute task counters from disk: total, completed, and next_index.
• Merge state for execution:
• phase: "execution"
• awaitingApproval: false
• totalTasks: total
• taskIndex: next_index
• preserve taskIteration, maxTaskIterations, globalIteration, maxGlobalIterations, commitSpec, and relatedSpecs
• Delegate each task to a spec-executor sub-agent. Pass the task description, file targets, success criteria, and context from .progress.md. The sub-agent implements the task and outputs TASK_COMPLETE. Do NOT implement tasks yourself. Execute tasks in order until complete or blocked.
• [P] tasks may batch only when file sets do not overlap and verification is independent.
• [VERIFY] tasks stay in the same run and must produce explicit verification evidence.
• Marker syntax must be explicitly present in tasks.md. If markers are absent, treat tasks as non-batchable by default.
• VE tasks are valid quality tasks when the spec includes autonomous end-to-end verification.

10. Native task sync metadata should be preserved when present.

11. After each task or safe batch:

• mark the checkbox
• update .progress.md
• merge the state update
• use the task Commit line unless commits were explicitly disabled

12. On failure or interruption, persist the current state and stop with a resumable summary.

13. On full completion, remove .ralph-state.json and report completion.

Resume Rules

• Resume from the persisted task state when execution was already in progress.
• If disk state and task checkboxes disagree, prefer tasks.md for completion and repair state to match.
• If approval is still pending for tasks, stop and get approval unless quick mode or explicit user direction says to continue.