ralph

Execute PRD-driven task loops with progress tracking and validation.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/RonanCodes/ronan-skills --skill ralph-ronancodes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/RonanCodes/ronan-skills/tree/main/skills/ralph
Command: npx skills add https://github.com/RonanCodes/ronan-skills --skill ralph-ronancodes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Orchestrates autonomous PRD-driven task execution and progress tracking using a Ralph loop.

Core Features & Use Cases

  • Picks the highest-priority incomplete story from .ralph/ PRD files and advances progress.
  • Validates results (typecheck, lint, tests) before committing.
  • Supports multiple PRD scopes via named PRDs and the --prd flag.
  • Writes progress updates to the respective progress file for visibility and handoffs.

Quick Start

Run the Ralph loop to start processing the next PRD story in the active project, or specify a named PRD with --prd to start a targeted session.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I automate PRD task execution and track progress for multi-phase projects?

Autonomous PRD task execution is handled by reading PRD JSON files from the .ralph/ directory, picking the highest-priority incomplete story, advancing progress, and writing updates to corresponding progress files for visibility.

How do I run a targeted workflow session for a specific PRD file?

You can specify a named PRD using the --prd flag to start a targeted workflow session, allowing you to process and commit changes for a dedicated PRD scope instead of the default active project.

Can I validate code changes before committing during automated PRD execution?

Yes, PRD execution validates results by running typecheck, lint, and tests before committing changes, ensuring that only verified code updates are added to your workflow.

What is a Ralph loop for autonomous task execution?

A Ralph loop is an autonomous workflow mechanism that orchestrates PRD-driven task execution, continuously picking incomplete stories from .ralph/ files and tracking progress through standard commits.

Does autonomous PRD execution work with multiple PRD scopes in one project?

Autonomous PRD execution supports multiple scopes through dedicated PRD files under .ralph and allows targeting specific named PRDs with the --prd flag for isolated progress tracking.

What format should PRD files be in for automated progress tracking?

PRD files should be formatted as JSON and placed in the .ralph/ directory, enabling the autonomous loop to read stories, validate changes, and write progress updates to corresponding progress files.