What problem does it solve?
Ralph prevents “looks done” outcomes by driving work story-by-story from a PRD until every user story is marked complete and verified by a reviewer before the task can finish.
Core Features & Use Cases
- PRD-driven persistence loop that iterates until all
prd.json stories have passes: true and reviewer-verified acceptance criteria.
- Session-scoped state tracking with automatic scaffold generation for
prd.json, plus persistence across retries using .omc/state/sessions/{sessionId}/....
- Mandatory reviewer verification and regression checks, including an unconditional post-approval deslop cleanup pass (unless
--no-deslop is provided), followed by re-verification.
- Use case: When building a service feature across multiple iterations (e.g., implementing an API endpoint with auth and tests), Ralph ensures each acceptance criterion is met and re-validated until the full PRD is truly satisfied.
Quick Start
Tell the system: “ralph, keep going until done, verify with architect, implement the PRD for my feature and ensure all stories pass reviewer verification.”