ralph-json-start-loop

Automate Ralph autonomous loops over PRD JSONs using git worktrees.

69|11|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/richtabor/agent-skills --skill ralph-json-start-loop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-json-start-loop
Source: https://github.com/richtabor/agent-skills/tree/main/skills/ralph-json-start-loop
Command: npx skills add https://github.com/richtabor/agent-skills --skill ralph-json-start-loop

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, claude, gh, git, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Automates running the Ralph autonomous loop to execute features from PRD JSONs using git worktrees, reducing manual orchestration and context switching across multiple worktrees.

Core Features & Use Cases

  • Runs the Ralph loop across prds/*.json with git worktrees for isolated feature delivery.
  • Respects dependencies, tracks progress, and updates PRD state after each iteration.
  • Automates commits and PR creation when all stories are complete.
  • Supports targeting a specific project or limiting iterations for controlled experimentation.

Quick Start

Start the Ralph loop on your worktree to execute the next available project, optionally specifying iterations or a specific project.

Frequently Asked Questions about ralph-json-start-loop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate feature delivery from PRD JSONs across multiple git worktrees?

Automating feature delivery from PRD JSONs is handled by running the Ralph autonomous loop, which isolates execution across git worktrees, tracks progress, and generates automated commits and PRs for each completed story.

How does dependency-aware scheduling work for iterative story execution?

Dependency-aware scheduling in iterative execution works by respecting interdependent story requirements within the PRD JSON, ensuring that prerequisite stories are completed before dependent tasks are executed across isolated worktrees.

Do I need jq and gh installed to run autonomous loops with git worktrees?

Yes, you need jq and gh installed along with git and claude, as these dependencies are required to parse PRD JSON configurations, manage worktree logs, and automate PR generation and status synchronization.

What is the best way to limit iterations for controlled experimentation during continuous delivery?

The best way to limit iterations for controlled experimentation is to specify iteration limits when starting the Ralph loop, allowing you to test autonomous execution and PRD state updates on a specific project without running indefinitely.

Why does PRD state need to be updated after each iteration in an autonomous loop?

PRD state needs updating after each iteration to track progress accurately across interdependent stories, ensuring the autonomous loop knows which features are complete and can synchronize status before generating automated commits and PRs.