What problem does it solve?
The Ralph autonomous agent system requires product requirement documents (PRDs) to be in a specific structured prd.json format, but most PRDs are written in unstructured markdown or plain text, making manual conversion time-consuming and prone to errors that break autonomous execution.
Core Features & Use Cases
- Structured PRD Conversion: Parses existing markdown or text PRDs and automatically generates the valid prd.json format Ralph expects, with correct project metadata, branch naming, and user story structure.
- Right-Sized Story Splitting: Automatically splits large, unworkable feature requests into small, single-iteration user stories that fit within Ralph's context window limit, preventing failed runs from oversized tasks.
- Dependency Ordering & Validation: Enforces correct story execution order based on technical dependencies, adds mandatory verifiable acceptance criteria (including typecheck and browser verification for UI changes), and includes archiving logic for previous PRD runs to avoid data loss.
- Use Case: If you have a PRD for adding a task status tracking feature to your app, this skill will convert it into 4 properly sized, ordered user stories with all required acceptance criteria ready for Ralph to execute autonomously.
Quick Start
Use the ralph skill to convert the attached task status feature PRD into a prd.json file formatted for Ralph autonomous execution.