mcpField
B
bmad-architecture-design

bmad-architecture-design

github.com/bacocoDevelopment6756 installsUpdated 51w ago
Repository

About bmad-architecture-design

This skill turns approved product requirements into a decision architecture for implementation teams. It covers component structure, technology choices, rationale, and guardrails, and requires an approved PRD and defined epics first.

Key features

  1. 01Validate planning prerequisites
  2. 02Identify architecture drivers
  3. 03Design component topology and data flows
  4. 04Record decisions, alternatives, and mitigations
  5. 05Generate or update ARCHITECTURE.md

Use cases

  1. 01Plan architecture from an approved PRD
  2. 02Map system components, data flows, and technology choices
  3. 03Document architecture risks and guardrails before implementation

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bacoco/bmad-skills --skill bmad-architecture-design

After installing, type/bmad-architecture-designin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

CHECKLIST.md
REFERENCE.md
WORKFLOW.md
assets/
architecture-script-template.md.template
scripts/
generate_architecture.py

Details

From the project README

Architecture Design Skill

When to Invoke

Automatically activate when user:

  • Says "How should we build this?", "What's the architecture?"
  • Asks "Tech stack?", "System design?", "How to architect?"
  • Mentions "architecture", "technical decisions", "stack"
  • PRD and epics are approved (Phase 3)
  • Uses words like: architecture, tech stack, design, system, build, technical

Specific trigger phrases:

  • "How should we build this?"
  • "What's the architecture?"
  • "Choose tech stack"
  • "System design for [project]"
  • "Technical architecture"
  • "How to architect [feature]"

Prerequisites:

  • PRD exists and approved
  • Epics defined

Do NOT invoke when:

  • PRD not ready (use bmad-product-planning first)
  • Already have architecture (skip to stories)
  • Simple Level 0-1 project (may not need formal architecture)

Mission

Convert approved product requirements into a Decision Architecture that communicates component structure, technology choices, and rationale for implementation teams.

Inputs Required

  • prd: latest PRD plus epic roadmap from product-requirements skill
  • constraints: non-functional requirements, compliance rules, and integrations
  • existing_assets: repositories, current architecture diagrams, or technology standards
  • project_level: BMAD level sizing to guide depth of design

Missing inputs must be escalated to the orchestrator or originating skill before work proceeds.

Outputs

  • ARCHITECTURE.md written using assets/decision-architecture-template.md.template
  • Updated risk and decision log entries summarized for stakeholders

Deliverables should highlight decisions, rejected options, and implementation guardrails.

Process

  1. Validate prerequisites via CHECKLIST.md and confirm planning artifacts are approved.
  2. Identify architecture drivers (quality attributes, constraints, integrations).
  3. Design component topology, data flows, and technology selections with traceability to requirements.
  4. Record key decisions, alternatives, and mitigation strategies.
  5. Generate or update architecture artifact using scripts/generate_architecture.py if structured data is available.
  6. Review the quality checklist and publish summary plus follow-up actions for delivery-planning and development-execution skills.

Quality Gates

Follow CHECKLIST.md to ensure completeness, feasibility, and stakeholder alignment. Stop if guardrails fail.

Error Handling

When contradictions or gaps exist:

  • Cite the specific requirement or assumption causing the conflict.
  • Request clarifications from product-requirements, UX, or discovery-analysis skills.
  • Recommend holding implementation until resolution is documented.

Comments

Markdown supported