ralph

Convert PRDs into prd.json and execute user stories with Ralph.

1|Updated Jun 19, 2026
One-click install
npx skills add https://github.com/gannonh/kata-agents --skill ralph-gannonh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/gannonh/kata-agents/tree/main/skills/ralph
Command: npx skills add https://github.com/gannonh/kata-agents --skill ralph-gannonh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Ralph reduces the manual effort of translating PRDs into a machine-readable plan and orchestrating automated execution of user stories via the Ralph agent.

Core Features & Use Cases

  • PRD conversion: Convert natural-language PRDs into Ralph's prd.json format for automated execution.
  • Autonomous execution: Run sequential user stories using a fresh AI instance per iteration to avoid memory leakage.
  • Branch archival: Automatically archive results when the feature branch changes to preserve history.
  • Flexible tooling: Supports multiple AI tool backends and iteration controls.

Quick Start

To start Ralph on a PRD, place your PRD or prd.json in the working directory and run the Ralph script: ./scripts/ralph.sh. Optional arguments let you choose the tool and max iterations, for example: ./scripts/ralph.sh --tool claude 15.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I convert a PRD into an automated workflow for user stories?

Autonomous execution handles sequential user stories by spawning a fresh AI instance per iteration to avoid memory leakage. Ralph runs these stories from prd.json, iterating through each until completion or until the maximum iteration limit is reached.

How do I start autonomous execution of user stories from a prd.json file?

Autonomous execution handles sequential user stories by spawning a fresh AI instance per iteration to avoid memory leakage. Ralph runs these stories from prd.json, iterating through each until completion or until the maximum iteration limit is reached.

Does the Ralph autonomous agent support different AI tool backends?

Branch archival automatically preserves results when the feature branch name changes during autonomous execution. Ralph triggers this archival process to maintain execution history and prevent data loss across different feature branches.

What happens to autonomous workflow results when the feature branch changes?

Branch archival automatically preserves results when the feature branch name changes during autonomous execution. Ralph triggers this archival process to maintain execution history and prevent data loss across different feature branches.

Do I need to manually format my PRD before running the autonomous agent system?

Ralph spawns a fresh AI instance per iteration during autonomous execution to avoid memory leakage across user stories. This ensures each story runs with a clean state, iterating sequentially until all stories are complete or maximum iterations are reached.

Why does the autonomous agent spawn a fresh AI instance for each iteration?

Ralph spawns a fresh AI instance per iteration during autonomous execution to avoid memory leakage across user stories. This ensures each story runs with a clean state, iterating sequentially until all stories are complete or maximum iterations are reached.