Prefer the old long-form? See V1 archive.
Lifecycle at a glance
draft ──wb.publish──▶ published ──wb.approve──▶ approved ──▶ ralph consumes
▲ │ │
└──────wb.reject──────────┴────────────────────────┘
Agents write status: draft only. Ralph reads strictly from .workbench-state/approved.json.
Browse by hat
Product (PO) · 3 skills · epic intake → PRD draft → PRD review panel
| Skill |
Purpose |
Input gate |
/epic-intake |
Pull Jira epic as draft context |
none (entry point) |
/prd-draft |
PRD from approved epic |
epic-context approved |
/prd-review-panel |
7-perspective PRD review; blocks approve on P0 |
PRD draft |
UX Design · 4 skills · orchestrator + Figma + screen gen + review
| Skill |
Purpose |
Input gate |
/design-draft |
End-to-end UX; orchestrates the three below |
PRD approved |
/figma-pull |
Park Figma links; optional MCP export |
PRD ID + Figma URL |
/ds-screen-gen |
Hi-fi HTML/JSX from design-system ref (default / empty / loading / error states) |
PRD + design-system ref |
/design-review |
5-perspective screen review; blocks handoff on P0 |
generated screen set |
Engineering · 4 skills · spec → TDD → ERD → ADR
| Skill |
Purpose |
Input gate |
/eng-spec |
Architecture, contracts, data, rollout, observability |
PRD approved |
/tdd |
Technical design doc: file map, interfaces, failure matrix |
eng-spec approved |
/erd |
Mermaid ER + C4-L2 + optional sequence (renders in GitHub) |
SPEC (may be draft) |
/adr |
MADR-lite Architecture Decision Record |
SPEC if exists, else none |
QA · 3 skills · BDDs → test cases → test spec
| Skill |
Purpose |
Input gate |
/bdd-gen |
Gherkin .feature (happy / edge / error / security) |
PRD approved |
/test-cases-gen |
BDDs → priority / type / automation-flag table |
BDDs approved |
/test-spec |
QA engg spec + test ERD: coverage, data, envs, flaky strategy |
PRD + BDDs + test cases approved |
Orchestrator (Ralph) · 2 skills · workspace plan → parallel dispatch
| Skill |
Purpose |
Input gate |
/ralph-workspace-plan |
Sync context, run workspace-mode plan, write per-repo fix_plan.md |
PRD + eng-spec + TDD + test-spec approved |
/ralph-dispatch |
Parallel ralph loops across repos (cross-repo; ralph-native is within-repo) |
approved fix_plans in repos/*/ai/ |
Cross-Cutting · 4 skills · grill-me + PMO status + WTD + precise-readme
| Skill |
Purpose |
Input gate |
/grill-me |
Relentless decision-tree interview on any draft before publish |
any draft artifact |
/pmo-status |
Terminal rollup of epics, PRDs, specs, TDDs, BDDs, fix_plan coverage, dispatch state |
none (read-only) |
/wtd |
What-To-Do: single next command per epic. Trimmer cousin of pmo-status. |
none (read-only) |
/precise-readme |
Precision-mode pass on README + docs/; archives originals under docs/v1/ with cross-banners. |
README + docs/ exist |
Hat-by-hat summary
| Hat |
Skills |
| Product (PO) |
/epic-intake, /prd-draft, /prd-review-panel |
| UX Design |
/design-draft, /figma-pull, /ds-screen-gen, /design-review |
| Engineering |
/eng-spec, /tdd, /erd, /adr |
| QA |
/bdd-gen, /test-cases-gen, /test-spec |
| Orchestrator |
/ralph-workspace-plan, /ralph-dispatch |
| Cross-cutting |
/grill-me, /pmo-status, /wtd, /precise-readme |