ralph

Automate PRD-driven execution loops until all user stories pass verification.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/INNERJOINT/HarnessSkills --skill ralph-innerjoint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/INNERJOINT/HarnessSkills/tree/main/skills/ralph
Command: npx skills add https://github.com/INNERJOINT/HarnessSkills --skill ralph-innerjoint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ralph ensures complex, multi-iteration tasks do not end prematurely by persisting progress and iterating until every PRD user story passes verified acceptance criteria, preventing silent failures, skipped tests, and scope reduction.

Core Features & Use Cases

  • PRD-driven persistence: Auto-generates or reads prd.json, breaks work into verifiable user stories, and tracks progress in progress.txt across iterations.
  • Automated verification loop: Runs parallel agent work, executes tests/builds, enforces reviewer verification, performs an optional cleanup pass (ai-slop-cleaner), and re-runs regression checks before marking completion.
  • Use case: Use Ralph when a feature or bugfix must be demonstrably complete with passing tests and an explicit reviewer sign-off, such as security fixes, critical integration work, or multi-module refactors.

Quick Start

Invoke the assistant with a natural command like: ralph complete the authentication module with PRD enforcement --critic=architect

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I automate PRD-driven execution loops until all user stories pass verification?

Automated PRD-driven execution loops iterate on user stories by persisting progress in state files, running parallel agent work, and enforcing reviewer sign-off until every story passes verified acceptance criteria. This prevents silent failures and scope reduction in complex development tasks.

What is the best way to prevent premature task completion during multi-iteration development?

Preventing premature completion requires persisting progress across iterations and enforcing a verification loop with explicit reviewer sign-off. State files track user stories, ensuring tasks do not end silently until all acceptance criteria pass and regression checks are re-verified.

How do I enforce reviewer verification and regression re-verification for complex bugfixes?

Reviewer verification and regression re-verification are enforced by running parallel agent work, executing builds and tests, and requiring explicit reviewer sign-off. An optional cleanup pass can run before final regression checks to ensure no scope reduction occurs.

Can I use PRD state tracking for multi-module refactors with parallel agent delegation?

PRD state tracking supports multi-module refactors by auto-generating or reading a PRD file, delegating work to parallel agents, and tracking completion in a progress file. It ensures structured acceptance criteria are met before clean exit and state cleanup.

When do I need structured acceptance criteria and persistent progress tracking for automated testing?

Structured acceptance criteria and persistent progress tracking are needed for multi-iteration development tasks requiring demonstrable completion, such as security fixes, critical integrations, or multi-module refactors where passing tests and reviewer sign-off are mandatory.

Why does multi-iteration task automation require state cleanup and deslop regression passes?

Multi-iteration task automation requires state cleanup and deslop regression passes to remove low-quality AI output and re-verify stability before marking completion. This guarantees the final state reflects genuinely passing tests and explicit reviewer approval.