Ralph Wiggum Agent Runner

Run autonomous coding agents that ship code while you sleep.

When to Use

• •Multi-story feature implementation
• •Overnight autonomous coding
• •Batch processing of related tasks
• •When you want AI to work independently

Quick Commands

# Run with current PRD
./scripts/ralph/ralph.sh

# Run with custom PRD
./scripts/ralph/ralph.sh scripts/ralph/my-feature.json

# Watch progress
tail -f scripts/ralph/progress.txt

How It Works

1. •Agent reads PRD, picks highest priority incomplete story
2. •Implements ONLY that one story
3. •Runs build/lint to ensure CI stays green
4. •Commits work, updates PRD, appends to progress.txt
5. •Repeats until all stories pass or max iterations

PRD Structure

{
  "stories": [
    {
      "id": "STORY-001",
      "title": "User can do X",
      "priority": 1,
      "passes": false,
      "acceptance_criteria": ["..."],
      "files_to_modify": ["..."]
    }
  ]
}

Stop Condition

Agent emits <promise>COMPLETE</promise> when all stories pass.

Files

Reference Files

Related Skills

• •empathy-ledger-codebase - Codebase patterns
• •deployment-workflow - CI/CD integration