What problem does it solve?
Ralph reduces the manual effort of translating PRDs into a machine-readable plan and orchestrating automated execution of user stories via the Ralph agent.
Core Features & Use Cases
- PRD conversion: Convert natural-language PRDs into Ralph's prd.json format for automated execution.
- Autonomous execution: Run sequential user stories using a fresh AI instance per iteration to avoid memory leakage.
- Branch archival: Automatically archive results when the feature branch changes to preserve history.
- Flexible tooling: Supports multiple AI tool backends and iteration controls.
Quick Start
To start Ralph on a PRD, place your PRD or prd.json in the working directory and run the Ralph script: ./scripts/ralph.sh. Optional arguments let you choose the tool and max iterations, for example: ./scripts/ralph.sh --tool claude 15.