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