ralph-loop

Generate PRDs, convert them to prd.json, and execute user stories in an autonomous development loop.

2|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/Crokily/pi-backup --skill ralph-loop-crokily
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ralph-loop
Source: https://github.com/Crokily/pi-backup/tree/main/pi-config/agent/skills/ralph-loop
Command: npx skills add https://github.com/Crokily/pi-backup --skill ralph-loop-crokily

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the entire software development lifecycle for a feature, from initial product requirements to final implementation, by breaking down the process into manageable, iterative steps.

Core Features & Use Cases

  • PRD Generation & Conversion: Creates detailed Product Requirements Documents and converts them into a machine-readable prd.json format.
  • Iterative Story Execution: Implements user stories one by one, ensuring each step passes quality gates before proceeding.
  • Autonomous Development Loop: Manages the entire development cycle, including coding, testing, committing, and tracking progress, with minimal human intervention.
  • Use Case: Kickstart a new feature by asking the AI to "create a PRD for a user profile editing feature, convert it to prd.json, and run the autonomous development loop."

Quick Start

Use the ralph loop skill to autonomously develop a feature by asking pi to create a PRD and run the loop.

Frequently Asked Questions about ralph-loop

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

FAQPage Schema
How do I automate iterative development with an AI agent from product requirements?▼

Autonomous iterative development is driven by generating a PRD, converting it into a structured prd.json format, and executing user stories sequentially with integrated quality checks. This loop manages the entire software lifecycle from coding to committing with minimal human intervention.

What is a PRD-driven autonomous development loop?▼

A PRD-driven autonomous development loop is a process where an AI agent breaks down a Product Requirements Document into machine-readable JSON, then iteratively implements user stories, runs quality gates, and tracks progress until the feature is complete.

Can I manually execute iterative development steps instead of running a full autonomous loop?▼

Yes, you can manually execute development steps one by one. The system supports both full autonomous loops via a shell script driver and manual step-by-step execution, ensuring each user story passes quality checks before proceeding.

How do I convert a Product Requirements Document into machine-readable JSON for software engineering?▼

You can convert a PRD into machine-readable JSON by asking the AI agent to generate the requirements document and then format it into a structured prd.json file, which serves as the input for sequential user story execution.

Does autonomous iterative development require any external dependencies or scripts?▼

No external dependencies are required to run the autonomous development loop. The system utilizes internal scripts, references, and assets to manage the shell script driver and execute the iterative PRD-driven software engineering process.

What is the best way to kickstart a new software feature using an AI agent?▼

The best way to kickstart a new feature is to ask the AI to create a PRD for the specific feature, convert it to prd.json, and run the autonomous development loop to handle coding, testing, and progress tracking iteratively.