ralph

Iterate PRD stories until reviewer-verified acceptance criteria pass.

Updated Apr 29, 2026
One-click install
npx skills add https://github.com/nichobbs/lyric-lang --skill ralph-nichobbs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/nichobbs/lyric-lang/tree/main/.claude/skills/ralph
Command: npx skills add https://github.com/nichobbs/lyric-lang --skill ralph-nichobbs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ralph prevents “looks done” outcomes by driving work story-by-story from a PRD until every user story is marked complete and verified by a reviewer before the task can finish.

Core Features & Use Cases

  • PRD-driven persistence loop that iterates until all prd.json stories have passes: true and reviewer-verified acceptance criteria.
  • Session-scoped state tracking with automatic scaffold generation for prd.json, plus persistence across retries using .omc/state/sessions/{sessionId}/....
  • Mandatory reviewer verification and regression checks, including an unconditional post-approval deslop cleanup pass (unless --no-deslop is provided), followed by re-verification.
  • Use case: When building a service feature across multiple iterations (e.g., implementing an API endpoint with auth and tests), Ralph ensures each acceptance criterion is met and re-validated until the full PRD is truly satisfied.

Quick Start

Tell the system: “ralph, keep going until done, verify with architect, implement the PRD for my feature and ensure all stories pass reviewer verification.”

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I ensure PRD task completion across multiple engineering iterations?

PRD task completion across multiple engineering iterations is ensured by running a PRD-driven persistence loop that iterates over user stories until all acceptance criteria pass reviewer verification. This prevents premature 'looks done' outcomes by tracking session-scoped state and enforcing structured story validation.

What is the best way to prevent 'looks done' outcomes in software development?

Preventing 'looks done' outcomes requires enforcing reviewer-verified acceptance criteria for each user story in a PRD. By requiring mandatory reviewer approval and an automated deslop cleanup pass, the task only finishes when all stories are truly satisfied and re-validated.

How does PRD-backed verification work for multi-iteration feature implementation?

PRD-backed verification for multi-iteration feature implementation works by scaffolding a prd.json file, selecting the next failing story, and running evidence-based verification. It persists state across retries using session-scoped directories, ensuring work resumes correctly until reviewer sign-off.

Does PRD-driven task completion require a specific file format for state persistence?

PRD-driven task completion requires initializing and refining a prd.json file for story tracking. State persistence across retries is handled automatically by saving session data into a structured .omc/state/sessions/{sessionId}/ directory structure.

Can I disable the automated cleanup pass during reviewer-verified regression checks?

You can disable the automated cleanup pass during reviewer-verified regression checks by passing the --no-deslop flag. Without this flag, an unconditional deslop pass runs post-approval, followed by a mandatory regression re-verification of the work.

When should I use a persistence loop for engineering verification?

Use a persistence loop for engineering verification when building service features across multiple iterations, such as implementing an API endpoint with auth and tests. It ensures every acceptance criterion is met, verified by a reviewer, and re-validated until the PRD is fully satisfied.