Ralph Specum Help

Use this to explain the Ralph Specum surface in Codex.

Cover

• Primary skill: $ralph-specum
• Helper skills: $ralph-specum-start, $ralph-specum-triage, $ralph-specum-research, $ralph-specum-requirements, $ralph-specum-design, $ralph-specum-tasks, $ralph-specum-prototype, $ralph-specum-implement, $ralph-specum-status, $ralph-specum-switch, $ralph-specum-cancel, $ralph-specum-index, $ralph-specum-refactor, $ralph-specum-feedback, $ralph-specum-help
• Normal flow: start goal grill, approval, research, artifact approval, requirements grill, approval, design grill, approval, tasks grill, approval, implement
• Large effort flow: triage, then start each unblocked spec
• Quick mode: only exact --quick bypasses interview questions; exact --interactive clears it. Discovery, skill loads, and artifact write gates still run
• Disk contract: ./specs or configured roots, .current-spec, optional .current-epic, per-spec markdown files, .ralph-state.json

Optional Prototype Overlay

• Direct mode: invoke $ralph-specum-prototype from research, requirements, design, tasks, or execution. Preserve the main phase and current checkout.
• Suggested mode: research or requirements may offer continue to prototype, then return to the next normal phase.
• Resume mode: use $ralph-specum-prototype --resume <id>. One active entry resumes automatically; several are listed deterministically for selection.
• Quick mode: run exactly one agent-owned request after requirements, ask no prototype questions, take over the oldest design blocker or select the highest-risk grounded, falsifiable question when no blocker exists, own verdict and handoff decisions, and continue to design for every result.
• Cancel mode: use $ralph-specum-prototype --cancel <id> or safe spec cancellation. Stop at a safe boundary, publish a reviewed immutable cancelled record, and preserve source and partial implementation.