V1 long-form archive. Pre-precision-pass version, preserved for engineers who prefer the dense narrative.
New (V2) version: ../skills.html.
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 into workbench 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 any P0 |
PRD draft |
UX Design — 4 skills · workflow orchestrator, Figma, screen gen, review
| Skill |
Purpose |
Input gate |
/design-draft |
End-to-end UX workflow; 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 in 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 component + 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 covering happy / edge / error / security paths |
PRD approved |
/test-cases-gen |
Expand BDDs into priority / type / automation-flag table |
BDDs approved |
/test-spec |
QA engineering 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 and run workspace-mode plan; writes per-repo fix_plan.md |
PRD + eng-spec + TDD + test-spec approved |
/ralph-dispatch |
Parallel ralph loops across repos (cross-repo parallelism; ralph native is within-repo) |
approved fix_plans in repos/*/ai/ |
Cross-Cutting — 2 skills · grill-me interview, PMO status rollup
| 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) |
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 |