What problem does it solve?
Ralph prevents complex AI work from ending in “mostly done” states by enforcing PRD-based story tracking and fresh reviewer verification before declaring completion.
Core Features & Use Cases
- PRD-driven persistence: Breaks work into prioritized user stories backed by acceptance criteria from prd.json, iterating until every story passes.
- Reviewer-verified completion: Requires mandatory verification against the specific acceptance criteria before marking a story as complete.
- Automatic retry and progress tracking: Wraps parallel execution with session persistence, retry-on-failure behavior, and progress.txt recording for multi-iteration runs.
- Use case: When you need a feature shipped without gaps—e.g., “implement endpoint X, validate behavior, add tests, and confirm reviewer acceptance”—Ralph keeps iterating until the defined criteria are satisfied.
Quick Start
Use the ralph skill to complete and verify your task until all PRD stories pass by telling the AI: “ralph, implement this feature and keep going until it’s verified and done”.