Ralph Specum

Use this as the primary Codex surface for Ralph Specum. It carries the full reusable workflow and can handle the entire command surface directly when helper skills are not installed.

Read These References

• references/workflow.md for the phase flow, branch and worktree behavior, quick mode, and command routing
• references/state-contract.md for .ralph-state.json, .progress.md, commit rules, and resume semantics
• references/path-resolution.md for specs_dirs, .current-spec, ambiguity handling, and default directory behavior
• references/parity-matrix.md for Claude-to-Codex feature translation and command mapping

Use These Helpers

• scripts/resolve_spec_paths.py for spec roots, current spec, and unique or ambiguous name resolution
• scripts/merge_state.py for safe top-level state merges
• scripts/count_tasks.py for task counts and next incomplete task
• assets/templates/ for the canonical Ralph markdown file shapes
• assets/bootstrap/ when the user wants optional project-local Codex guidance