mcpField
R
ralph-json-start-loop

ralph-json-start-loop

github.com/richtaborAgent workflows7357 installsUpdated 29w ago
Repository

About ralph-json-start-loop

ralph-json-start-loop is a Claude skill that runs feature work from JSON PRDs in repeated iterations. It orders projects by dependencies and isolates each project in a Git worktree.

Key features

  1. 01Selects the next dependency-ready project
  2. 02Runs a configurable iteration loop
  3. 03Implements stories marked as incomplete
  4. 04Runs quality checks and commits changes
  5. 05Updates PRD JSON and syncs changes

Use cases

  1. 01Run planned feature stories autonomously
  2. 02Sequence projects with dependencies
  3. 03Keep parallel feature work in separate worktrees

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/richtabor/agent-skills --skill ralph-json-start-loop

After installing, type/ralph-json-start-loopin Claude Code to confirm it loaded.

Bundled filesralph.shreferences/prompt.md

Details

From the project README

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

Comments

Markdown supported