ralph-json-start-loop

Original：🇺🇸 English

Translated

1 scripts

Runs the Ralph autonomous loop. Executes stories from prds/*.json using git worktrees.

2installs

Sourcerichtabor/agent-skills

Added on2026-02-07

NPX Install

npx skill4agent add richtabor/agent-skills ralph-json-start-loop

SKILL.md Content

View Translation Comparison →

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:

bash

~/.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
When all stories pass, outputs
```
<promise>COMPLETE</promise>
```

Dependencies

Ralph reads

dependsOn

from each PRD and enforces ordering:

json

{
  "projectName": "Dashboard",
  "dependsOn": ["auth-flow", "user-profile"]
}

Projects with incomplete dependencies are blocked. Ralph picks the first ready project alphabetically.

Prerequisites

At least one
```
.json
```
PRD file in
```
.claude/plans/
```
,
```
plans/
```
, or
```
prds/
```
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