Featured

ralph

Name: ralph
Author: snarktank

Convert PRDs to prd.json format for the Ralph autonomous agent system. Use when you have an existing PRD and need to convert it to Ralph's JSON format. Triggers on: convert this prd, turn this into ralph format, create prd.json from this, ralph json.

TL;DR

Converts PRDs to prd.json format for Ralph autonomous agent, ensuring stories are right-sized and executable in single iterations.

What Is It

Converts markdown PRDs to structured JSON for Ralph execution
Breaks features into iteration-sized user stories
Ensures dependency-ordered story execution
Manages archiving of previous Ralph runs

Key Features

Enforces one-iteration story size (Ralph has no memory between runs)
Orders stories by dependency (schema → backend → UI)
All stories include 'Typecheck passes' criterion
UI stories require 'Verify in browser using dev-browser skill'
Splits large features into focused, independent stories
Sequential story IDs (US-001, US-002, etc.)
Automatic archiving when switching features/branches
Verifiable acceptance criteria only (no vague requirements)
Branch naming convention: ralph/feature-name-kebab-case

How to Use

1.Take existing PRD (markdown or text)
2.Break into small stories (2-3 sentence description each)
3.Order by dependencies (database → logic → UI → aggregations)
4.Write verifiable acceptance criteria for each story
5.Add 'Typecheck passes' to every story
6.Add browser verification to UI stories
7.Archive previous prd.json if different branchName
8.Save as prd.json in ralph directory

Guardrails & Gotchas

Stories MUST be completable in one iteration (one context window)
Never order stories where earlier ones depend on later ones
Always include 'Typecheck passes' as final criterion
UI stories need 'Verify in browser using dev-browser skill'
Acceptance criteria must be checkable, not vague
If story can't be described in 2-3 sentences, split it
Archive before overwriting prd.json with different branch
Ralph has no memory between iterations - size accordingly

GitHub Stats

Author

@snarktank

Repository

snarktank/ralph

Stars

2419

Explore More Skills

api-design-principles

@wshobson

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.

21k

2.3k

3mo ago

ralph

Explore More Skills

api-design-principles

prd

revenuecat