From bmad-planning
BMAD planning workflow (Brief, Model, Architect, Develop). Triggers on greenfield feature work, product discovery, or "let's design X". Produces a PRD and Tech Spec before any implementation. Pattern adopted by Pillarworks from bmad-code-org; promoted to Orryx cross-cutting.
How this skill is triggered — by the user, by Claude, or both
Slash command
/bmad-planning:bmad-planningThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Four-phase planning before code: **Brief** (problem + audience + outcome), **Model** (data + flows + integrations), **Architect** (components + deployment + tradeoffs), **Develop** (sprint plan + acceptance criteria). Output: a PRD + Tech Spec the team aligns on before anyone writes a line of code. Reduces "we built the wrong thing" rework.
Four-phase planning before code: Brief (problem + audience + outcome), Model (data + flows + integrations), Architect (components + deployment + tradeoffs), Develop (sprint plan + acceptance criteria). Output: a PRD + Tech Spec the team aligns on before anyone writes a line of code. Reduces "we built the wrong thing" rework.
When NOT to use:
Answers:
Output: 1-page PRD section.
Answers:
Output: ERD + flow diagram + integration list.
Answers:
Output: architecture diagram + ADR (Architecture Decision Record).
Answers:
Output: TodoWrite task list + sprint markdown.
By end of BMAD planning:
| File | Lives in |
|---|---|
<feature>-prd.md | docs/specs/ or prompts/ |
<feature>-tech-spec.md | docs/architecture/ |
<feature>-adr-NNN.md | decisions/ |
<feature>-sprint-plan.md | repo root or docs/sprints/ |
BMAD is a forcing function for "alignment before code." Cheap to align on a 1-page Brief; expensive to realign after 2 sprints of code. Pillarworks adopted it from bmad-code-org and reports significant rework reduction.
bmad-planning SKILL — the Orryx Group adaptationmethodology/spec-driven-delivery — for refactors / non-greenfield workmethodology/plan-and-execute — for tactical execution within BMAD's Develop phaseGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub alexmclaren/orryx-knowledge --plugin bmad-planning