ralph-run

Orchestrate the RALPH autonomous development loop to implement features from a PRD.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/doravidan/supreme-ralph --skill ralph-run
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-run
Source: https://github.com/doravidan/supreme-ralph/tree/main/.claude/skills/ralph-run
Command: npx skills add https://github.com/doravidan/supreme-ralph --skill ralph-run

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill streamlines the creation of autonomous development loops to implement PRD-driven features, reducing manual reproduction of tasks and accelerating delivery.

Core Features & Use Cases

  • Greenfield PRD Loop: Iterate from PRD files to full feature implementation via the RALPH loop.
  • Brownfield Single-Task Mode: Execute quick one-off tasks without a PRD, returning targeted outcomes.
  • Quality Gates: Enforce typechecking, linting, and tests to ensure production-grade results.

Quick Start

Run the Greenfield PRD loop: ./scripts/ralph/ralph.sh 20

Run a single-task mode: ./scripts/ralph/ralph.sh --task "Fix the login button styling"

Frequently Asked Questions about ralph-run

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

FAQPage Schema
How do I automate feature implementation from a PRD file?

Automating feature implementation from a PRD involves orchestrating an autonomous development loop to iterate through requirements and deliver production-ready code. The RALPH skill streamlines this by processing prd.json, PRD.md, or tasks.yaml files to drive the workflow.

What is the difference between Greenfield and Brownfield development modes?

Greenfield PRD loop mode iterates from PRD files to implement full features, while Brownfield single-task mode executes quick one-off tasks without a PRD. Both modes guide iterations and enforce quality gates to deliver targeted outcomes.

How do I run a single autonomous task without a PRD?

Running a single autonomous task without a PRD requires using the Brownfield single-task mode. You can execute it via the command line by passing your specific instructions as a task string to get targeted development outcomes.

Do I need jq installed to use the RALPH autonomous loop?

Yes, you need jq installed because it is a required dependency for the RALPH autonomous loop. The skill relies on jq along with scripts under scripts/ralph and a .ralph/config.yaml file to orchestrate the workflow properly.

What configuration and PRD formats are supported for autonomous development?

Supported formats include prd.json, PRD.md, and tasks.yaml for driving the workflow. The autonomous loop also requires a .ralph/config.yaml file for rules and relies on scripts under scripts/ralph to process these inputs.

How are code quality and testing enforced during autonomous implementation?

Code quality and testing are enforced through built-in quality gates during the autonomous loop. The skill ensures production-grade results by applying typechecking, linting, and tests before completing the feature implementation.

Related Skills