Ralph Loop
Iterative task execution that runs Claude in a loop to complete PRD tasks autonomously.
Usage
~/.claude/skills/ralph/ralph <iterations> <prd_file> [progress_file]
Arguments:
iterations- Maximum loop iterationsprd_file- Path to PRD markdown fileprogress_file- Path to progress file (default: progress.txt in PRD directory)
Examples
~/.claude/skills/ralph/ralph 10 scripts/prd.md
~/.claude/skills/ralph/ralph 10 scripts/prd.md scripts/progress.txt
Each Iteration
- Find highest-priority task and implement it
- Run tests and type checks
- Update PRD with what was done
- Append progress to progress file
- Commit changes
Exit conditions:
- PRD outputs
<promise>COMPLETE</promise> - Max iterations reached
PRD Format
# PRD: Feature Name
## Goal
Brief description of objective.
## Tasks
- [ ] Task 1
- [ ] Task 2
## Success Criteria
1. Criterion 1
2. Criterion 2