ralph

Automate iterative feature development by generating PRDs and executing user stories with persistent state.

141|20|Updated Dec 19, 2025
One-click install
npx skills add https://github.com/julianromli/opencode-template --skill ralph-julianromli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/julianromli/opencode-template/tree/main/skill/ralph
Command: npx skills add https://github.com/julianromli/opencode-template --skill ralph-julianromli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, droid, and includes scripts (resource) components.

What problem does it solve?

Ralph automates end-to-end feature implementation by breaking work into user stories and executing them iteratively with persistent state via prd.json and progress.txt.

Core Features & Use Cases

  • Fresh-agent iterations: Each cycle runs a new agent with clean context to implement a single user story.
  • Persistent memory: Uses git history, prd.json, and progress.txt to track progress and learnings across runs.
  • Complete workflows: Generates a PRD, orchestrates iterations, commits changes, and archives prior runs as needed.

Quick Start

Run the Ralph script to start the autonomous feature-implementation loop.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I automate end-to-end feature development with an AI agent?

Autonomous feature development is automated by breaking work into user stories and executing them iteratively. The Skill orchestrates fresh AI agent cycles to implement, verify, and integrate features while tracking progress in prd.json and progress.txt.

What is PRD-driven iterative development and how does it track progress?

PRD-driven iterative development uses a product requirements document to guide AI agents through incremental code changes. It maintains persistent state across runs using prd.json for requirements and progress.txt for tracking learnings and completed work.

Do I need jq and droid installed to run autonomous feature delivery?

Yes, jq and droid are required dependencies for running this autonomous feature delivery workflow. These tools support the underlying script components that orchestrate the AI agent iterations and manage the persistent state files.

How to start an autonomous loop for AI agent feature implementation?

To start the autonomous feature implementation loop, execute the provided script. This initiates the workflow which generates a PRD, orchestrates per-iteration agent execution for code changes, and commits the results automatically.

How does fresh-agent iteration context work for implementing user stories?

Each iteration cycle runs a new AI agent with clean context to implement a single user story. This prevents context bloat and ensures the agent focuses solely on the specific requirements defined in the prd.json state file.

What are the limitations of using autonomous AI agents for feature development?

This approach is limited to software projects adopting a PRD-driven iterative workflow. It relies heavily on the droid dependency and requires git history for persistent memory, meaning it may not suit projects without structured requirement files.