ralph-cc
A spec-driven development workflow for Claude Code.
Ralph-cc gives you structured sprint planning, session management, a long-lived audit teammate, and an idea-to-execution pipeline — all running inside Claude Code as native skills and agents.
Based on Geoffrey Huntley's Ralph pattern and snarktank/ralph.
What it does
- No code without a plan. Forces a PRD before any sprint begins.
- One story per session. Each agent gets clean context — no degradation.
- Independent audit. A long-lived auditor teammate verifies every
feat: commit against acceptance criteria (when enabled), writes durable reports, and signs off before the lead advances.
- Session continuity. WIP commits, progress logs, dual-cleanup auditor wraps, and handoff notes mean nothing is lost between sessions.
- Full pipeline. Ideas → backlog → sprints → execution → audit → review → merge.
Quick Start
Install the plugin
/plugin marketplace add YarikChekin/ralph-cc
/plugin install ralph-cc
Set up your project
/ralph-init # Scaffold ralph into your project
/prd-plan # Define your product requirements
/new-sprint # Generate your first sprint
/start # Begin working
Manual install (without plugin)
git clone https://github.com/YarikChekin/ralph-cc
cp -r ralph-cc/skills/ your-project/.claude/skills/
cp -r ralph-cc/agents/ your-project/.claude/agents/
cp -r ralph-cc/templates/* your-project/
Skills Reference
| Skill | Description |
|---|
/ralph-init | Scaffold ralph into a project |
/prd-plan | Create or audit product requirements |
/new-sprint | Generate the next sprint from PRD / backlog / tech debt / GitHub Issues |
/start | Session dispatcher — picks up where you left off, runs the audit gate |
/ralph | Quick sprint dashboard |
/wrap | Clean session handoff (with auditor dual-cleanup) |
/audit | Spawn the auditor agent for ad-hoc story / branch / PRD review |
/log | Quick-capture bugs or improvements |
/new-idea | Brainstorm and research feature ideas |
/promote-idea | Move an idea to the backlog |
/tech-debt-review | Assess tech debt health |
/test | Guided manual testing |
/ralph-help | Quick command reference |
Agents
| Agent | Description |
|---|
auditor | Long-lived audit teammate. 3 modes: per-story (after each feat: commit), sprint-close (branch-level sweep), PRD review (pre-sprint quality gate). Writes durable reports. |
Workflow
/ralph-init Scaffold project files + RALPH.md (with Audit/Merge/Github defaults)
|
v
/prd-plan Define or audit product requirements
| (required before any sprint)
v
/new-sprint Pick source -> generate prd.json with stories
| (Audit.mode=per-story: auditor reviews draft PRD first)
v
/start ──────────────── Session dispatcher (run every session)
| |
| Case A: uncommitted changes -> commit/discard/continue
| Case B: WIP commit -> resume interrupted story
| Case C: normal continuation -> next story
| Case D: sprint complete -> sprint-close audit + merge (local)
| Case D2: open PR -> reviews / changes / merge (pr mode)
v
Ralph loop Worker agent + (optional) auditor teammate
| (one story |
| per session) v
v /wrap (end session cleanly — auditor dual-cleanup if alive)
|
v
/start (next session picks up)
|
v
All stories done?
|
|-- No -> /start again
|
|-- Yes -> /start Case D (or D2) handles audit + merge
|
v
Side workflows (anytime):
/log -> capture bug/improvement
/new-idea -> brainstorm feature idea
/promote-idea -> move idea to backlog
/tech-debt-review -> assess debt health
/test -> manual testing loop
/audit -> ad-hoc auditor invocation
/ralph -> quick sprint dashboard
Configuration (RALPH.md)
Three optional sections control how aggressive the workflow is. All have safe defaults so a v1-style RALPH.md (without these sections) still works.
Audit
## Audit
mode: sprint-close # off | sprint-close | per-story
reports_dir: scripts/ralph/audit-reports
off — no auditor involvement. The lead flips passes: true itself.sprint-close (default) — auditor runs once before merge as a branch-level sweep.per-story — strict. The auditor is spawned as a long-lived teammate; it audits after every feat: commit, and the lead does NOT flip passes: true until the auditor returns SIGN OFF. The lead also sends the draft PRD through the auditor in /new-sprint Step 5.
Merge
