richtabor/agent-skills/ralph-json-start-loop

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

1. Shows dependency graph, finds next available project
2. Creates git worktree at ../{repo}-{feature}/
3. 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

1. 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

1. At least one .json PRD file in .claude/plans/, plans/, or prds/
2. Use plan mode to create a plan, then run /ralph-json-create-issues to convert it

Notes

• Run multiple Ralphs in parallel on independent projects (separate terminals)
• Each works in its own worktree, no conflicts