ralph

Convert PRD markdown files into structured prd.json for autonomous development loops.

3|1|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/edfenton/claude-skills --skill ralph-edfenton
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/edfenton/claude-skills/tree/main/shared/ralph
Command: npx skills add https://github.com/edfenton/claude-skills --skill ralph-edfenton

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires claude, jq, gh.

What problem does it solve?

Ralph converts a PRD markdown into a structured prd.json to drive an autonomous development loop.

Core Features & Use Cases

  • Converts PRD markdown into prd.json with user stories, acceptance criteria, and test guidance.
  • Orchestrates feature-branch workflows from main, optional scaffold skills, and detailed commit messages for traceability.
  • Enforces TDD, logs progress, and generates PR bodies to streamline reviews and merges.

Quick Start

Place a PRD markdown at the project root and run Ralph to start the loop.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I automate autonomous code iterations from a PRD markdown file?

To automate autonomous code iterations from a PRD markdown file, you can convert it into a structured prd.json to drive an autonomous development loop. This orchestrates feature-branch workflows, enforces TDD, and generates PR bodies for streamlined reviews.

How does test-driven development workflow automation work with PRDs?

TDD workflow automation with PRDs works by parsing the markdown into user stories, acceptance criteria, and test guidance. It then orchestrates feature branches from main, enforces TDD, and logs iteration progress with detailed commit messages for traceability.

Do I need GitHub CLI and jq to automate feature-branch workflows from main?

Yes, you need GitHub CLI (gh) and jq installed to automate feature-branch workflows from main. These dependencies enable the autonomous loop to create branches, generate PR bodies, and process the structured prd.json required for round-trip reviews.

Can I use Claude to enforce TDD and generate PR bodies automatically?

Yes, you can use Claude to enforce TDD and generate PR bodies automatically. The autonomous development loop uses Claude to orchestrate feature branches from main, log iteration progress, and create detailed commit messages and PR bodies for round-trip reviews.

What is the best way to convert PRD markdown into user stories and acceptance criteria?

The best way to convert PRD markdown into user stories and acceptance criteria is by transforming it into a structured prd.json file. This enables an autonomous loop that uses the structured data to enforce TDD and orchestrate feature-branch workflows.

Why are my autonomous code iterations not tracking progress on feature branches?

Autonomous code iterations may not track progress if the PRD markdown is not properly converted to a structured prd.json. The loop relies on this structured format to generate detailed commit messages and log iteration progress on feature branches from main.