What problem does it solve? Complex tasks often get declared done prematurely: partial implementations ship, tests get skipped, and edge cases are forgotten. Ralph enforces guaranteed completion by looping on a task until every user story in a structured PRD passes and a reviewer signs off. ## Core Features & Use Cases - PRD-Driven Execution: Auto-generates and refines a prd.json file that breaks work into user stories with concrete, testable acceptance criteria. - Persistent Iteration Loop: Picks the highest-priority incomplete story, implements it with tiered agent delegation (Haiku/Sonnet/Opus), verifies each acceptance criterion with fresh evidence, and tracks progress in progress.txt. - Reviewer Verification: Requires an architect, critic, or codex reviewer (selectable via --critic flag) to validate work against specific acceptance criteria before completion. - Use Case: You ask the agent to "ralph: migrate the auth module to OAuth2 and don't stop until done." Ralph scaffolds a PRD with stories like token refresh and session handling, implements each one, runs tests, and loops until an architect reviewer approves every story. ## Quick Start Ask the agent to ralph your task, for example: "ralph: add rate limiting to all API endpoints and keep going until done."