ralph

Iterate on PRD user stories until reviewer verification passes.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/Pryma-Tech/iris --skill ralph-pryma-tech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/Pryma-Tech/iris/tree/main/cli/skills/ralph
Command: npx skills add https://github.com/Pryma-Tech/iris --skill ralph-pryma-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ralph provides a disciplined loop that keeps iterating on a task until every user story in a PRD is verified and complete by a designated reviewer, preventing incomplete or quality-gapped deliveries.

Core Features & Use Cases

  • PRD-driven iteration with persistent state across retries
  • Automatic retries on failure, structured story tracking, and mandatory verification before completion
  • Supports configurable reviewer roles and PRD prompts for complex multi-step tasks

Quick Start

Describe your task and let Ralph manage iterations, tracking, and reviewer verification until all stories pass.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I guarantee task completion for parallel agent execution until all user stories pass verification?

To guarantee task completion, you can use a PRD-driven persistence loop that continues iterating with parallel agent execution until every user story in prd.json passes reviewer verification. This enforces mandatory verification before final delivery.

How does automatic retry on failure work for multi-step PRD-driven workflows?

Automatic retry on failure in PRD-driven workflows works by wrapping parallel execution with session persistence, maintaining structured story tracking across retries. The loop continues iterations until all user stories pass the designated reviewer's verification.

Can I configure a specific reviewer role to verify user stories during iteration?

Yes, you can configure a specific reviewer to verify user stories during iteration by selecting a reviewer via the --critic flag. This enforces mandatory verification before the workflow can mark the task as complete.

What is the best way to track progress across persistent retries in complex parallel execution?

The best way to track progress across persistent retries is using structured story tracking built into the PRD scaffolding. It monitors the status of each user story in prd.json, ensuring automatic retries only target incomplete or unverified items.

Does PRD-driven iteration support deslop passes to ensure end-to-end quality?

Yes, PRD-driven iteration supports deslop passes to ensure end-to-end quality. The persistence loop enforces PRD scaffolding, progress tracking, and deslop passes before allowing the reviewer to verify and complete the user stories.

When should I not use an automated persistence loop for agent orchestration?

You should not use an automated persistence loop for agent orchestration if your task lacks a structured PRD or clear user stories. The loop strictly enforces PRD scaffolding and mandatory verification, which requires defined criteria to iterate against.