ralph

Verify PRD user stories against acceptance criteria with reviewer completion.

Updated May 18, 2026
One-click install
npx skills add https://github.com/solitude6060/Yao-skills --skill ralph-solitude6060
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/solitude6060/Yao-skills/tree/main/skills/ralph
Command: npx skills add https://github.com/solitude6060/Yao-skills --skill ralph-solitude6060

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ralph prevents “partial completion” in complex work by forcing a PRD story-by-story loop that only ends after every user story passes and a selected reviewer verifies against the acceptance criteria.

Core Features & Use Cases

  • PRD-driven persistence loop: Iteratively refines and executes work against prd.json, marking each story passes: true only after verification.
  • Acceptance-criteria verification: Runs relevant checks (tests/build/lint/typecheck) per story and validates against task-specific criteria.
  • Reviewer-verified completion: Uses tiered architect/critic/codex-style approval and optionally runs a mandatory deslop cleanup and regression re-verification.

Quick Start

Use the ralph skill when you need this task finished with proof of completion, e.g., start your prompt with: ralph and include the task description (optionally add --critic=architect|critic|codex).

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I enforce reviewer sign-off on PRD user stories before completing a complex task?

You can enforce reviewer sign-off on PRD user stories by using a PRD-driven persistence loop that iterates through prd.json, verifying evidence for each story and requiring tiered critic approval before marking the task complete.

What is the best way to prevent partial completion of multi-iteration code changes?

Preventing partial completion of multi-iteration code changes requires running evidence-based verification and acceptance criteria checks per user story, ensuring every story passes before the workflow concludes.

How do I maintain session persistence across retries for a hotfix workflow?

To maintain session persistence across retries for a hotfix workflow, use a stateful iteration loop that refines prd.json and tracks progress, ensuring mandatory review and regression re-verification upon resumption.

Does ralph support selecting different reviewer profiles for task triage?

Yes, ralph supports selecting different reviewer profiles for task triage by using the --critic flag, allowing you to choose architect, critic, or codex-style approval for completion verification.

How do I run regression testing after deslop cleanup in a PRD workflow?

To run regression testing after deslop cleanup in a PRD workflow, perform an optional cleanup pass followed by a mandatory regression re-verification step to ensure acceptance criteria still pass.

When should I not use a stateful iteration loop for incident triage?

You should avoid using a stateful iteration loop for incident triage when the task requires immediate deployment without mandatory acceptance criteria verification or reviewer approval.