ralph-loop

Execute PRD JSON tasks sequentially with dependency checks and quality gates.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/vitoropereira/claude-starter-kit --skill ralph-loop-vitoropereira
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-loop
Source: https://github.com/vitoropereira/claude-starter-kit/tree/main/.claude/skills/workflow/ralph-loop
Command: npx skills add https://github.com/vitoropereira/claude-starter-kit --skill ralph-loop-vitoropereira

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the sequential implementation of tasks defined in a PRD JSON file directly within your Claude Code session, streamlining development workflows.

Core Features & Use Cases

  • In-Session PRD Execution: Runs tasks from a prd-XX.json file one by one.
  • Dependency Management: Checks and respects task dependencies.
  • Quality Gate Integration: Executes defined quality gates after implementation.
  • Error Handling & Recovery: Attempts to fix errors and can retry blocked tasks.
  • Use Case: When you have a prd-01.json with 5 pending tasks, you can use this skill to execute them sequentially, ensuring each task's dependencies are met and quality gates pass before moving to the next.

Quick Start

Execute the tasks defined in prd-01.json starting from the beginning.

Frequently Asked Questions about ralph-loop

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

FAQPage Schema
How do I execute PRD tasks autonomously within a Claude Code session?

Autonomous PRD execution runs development tasks defined in a JSON file sequentially within Claude Code, managing dependencies and quality gates before updating the PRD status.

Can I skip to a specific task in a PRD JSON file instead of running all of them?

Yes, PRD execution supports skipping to specific tasks or running a single task, allowing you to resume workflows or target individual components without repeating completed work.

How does dependency management work when running development tasks from a PRD?

Dependency management checks task prerequisites before execution, ensuring each task's dependencies are met and quality gates pass before the loop proceeds to the next task.

What happens if a task fails a quality gate during PRD execution?

When a quality gate fails, the loop attempts to fix errors automatically and can retry blocked tasks, updating the PRD status to reflect the recovery attempt before continuing.

Do I need any external dependencies to automate task execution with a PRD JSON file?

No external dependencies are required to automate task execution; the skill operates entirely within an active Claude Code session using provided scripts and references to process PRD files.

What is the best way to manage sequential development workflows from a JSON specification?

Sequential development workflows are managed by executing tasks from a PRD JSON file one by one, verifying dependencies and quality gates to ensure structured, autonomous code generation.