ralph

Divide complex tasks into verifiable user stories with PRD-driven iteration.

1|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/Hyeonjun0527/yeon --skill ralph-hyeonjun0527
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/Hyeonjun0527/yeon/tree/main/.codex/skills/ralph
Command: npx skills add https://github.com/Hyeonjun0527/yeon --skill ralph-hyeonjun0527

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ralph ensures tasks are completed only after every user story passes verification, preventing premature "done" states and enabling persistent, multi-iteration work until acceptance criteria are met.

Core Features & Use Cases

  • PRD-driven iteration that tracks progress across stories (prd.json) and persists state.
  • Parallel, deterministic task execution with mandatory reviewer verification before completion.
  • Automatic retry, progress tracking (progress.txt), and consistent deslop cleanups.

Quick Start

Provide a task description to Ralph and start the PRD-driven loop so it iterates until all stories pass verification.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I prevent premature task completion in automated task management?

PRD-driven iteration prevents premature task completion by dividing complex tasks into discrete user stories with mandatory reviewer verification. It uses persistent execution and automatic retries to ensure every story passes acceptance criteria before being marked as done.

What is PRD-driven iteration for task verification?

PRD-driven iteration tracks task progress across discrete user stories using a prd.json scaffold. It applies parallel, deterministic execution with mandatory reviewer verification, persisting state in progress.txt until all acceptance criteria pass.

How do I set up PRD-driven task iteration with acceptance criteria?

To set up PRD-driven task iteration, provide a task description to start the loop, then supply a refined prd.json scaffold and concrete acceptance criteria for each user story. The system automatically tracks per-story progress until all stories pass verification.

Does PRD-driven task management support parallel execution and automatic retries?

Yes, PRD-driven task management supports parallel, persistent task execution with automatic retries. It enforces mandatory reviewer verification before completion, applying consistent deslop cleanups throughout the iteration process until all user stories pass.

When should I use PRD-driven iteration over standard task management?

Use PRD-driven iteration when complex tasks require persistent, multi-iteration work to meet strict acceptance criteria. It is ideal for scenarios where preventing premature "done" states is critical and every user story must pass reviewer verification.