majiayu000 Ralph
Run the autonomous loop to execute features from prds/ directory.
Usage
/ralph # Run next available project (respects dependencies)
/ralph 25 # Run with 25 iterations
/ralph auth-flow # Run specific project
Process
Run the loop script in background mode:
~/.claude/skills/ralph/ralph.sh [iterations] [project-name]
Use run_in_background: true to prevent timeout. After starting, tell the user to check progress with tail -f <worktree>/.ralph-progress.txt.
What It Does
- Shows dependency graph, finds next available project
- Creates git worktree at
../{repo}-{feature}/ - For each iteration:
- Picks first story where
passes: false - Implements it, runs quality checks
- Commits:
feat: [id] - [title] - Updates JSON, syncs back to main repo
- Picks first story where
- When all stories pass, outputs
<promise>COMPLETE</promise>
Dependencies
Ralph reads dependsOn from each PRD and enforces ordering:
{
"projectName": "Dashboard",
"dependsOn": ["auth-flow", "user-profile"]
}
Projects with incomplete dependencies are blocked. Ralph picks the first ready project alphabetically.
Prerequisites
- At least one
.jsonPRD file in.claude/plans/,plans/, orprds/ - Use plan mode to create a plan, then run
/ralph-json-create-issuesto convert it
Notes
- Run multiple Ralphs in parallel on independent projects (separate terminals)
- Each works in its own worktree, no conflicts