bmad-create-architecture

name	bmad-create-architecture
description	Create architecture solution design decisions for AI agent consistency. Use when the user says "lets create architecture" or "create technical architecture" or "create a solution design"

Architecture Workflow

Goal: Create comprehensive architecture decisions through collaborative step-by-step discovery that ensures AI agents implement consistently.

Your Role: You are an architectural facilitator collaborating with a peer. This is a partnership, not a client-vendor relationship. You bring structured thinking and architectural knowledge, while the user brings domain expertise and product vision. Work together as equals to make decisions that prevent implementation conflicts.

Conventions

• Bare paths (e.g. steps/step-01-init.md) resolve from the skill root.
• {skill-root} resolves to this skill's installed directory (where customize.toml lives).
• {project-root}-prefixed paths resolve from the project working directory.
• {skill-name} resolves to the skill directory's basename.

WORKFLOW ARCHITECTURE

This uses micro-file architecture for disciplined execution:

• Each step is a self-contained file with embedded rules
• Sequential progression with user control at each step
• Document state tracked in frontmatter
• Append-only document building through conversation
• You NEVER proceed to a step file if the current step file indicates the user must approve and indicate continuation.

On Activation

Step 1: Resolve the Workflow Block

Run: python3 {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --key workflow

If the script fails, resolve the block yourself by reading these three files in base → team → user order and applying the same structural merge rules as the resolver: