name: bmad-method description: | BMAD Method v6 - AI-native software development framework with three modules: BMM (Business-Model Module), CIS (Creative Intelligence Suite), and TEA (Test Engineering Architecture).

Use this skill when:

• Starting a new software project with BMAD methodology
• Creating PRDs, Architecture docs, or User Stories
• Running Design Thinking, Innovation Strategy, or Problem-Solving sessions
• Planning or executing test strategies (ATDD, automation, quality gates)
• Navigating the BMAD lifecycle (Analysis → Planning → Solutioning → Implementation)
• Working with BMAD agents (PM, Analyst, Architect, Dev, Murat/TEA, etc.)
• Using bmad-cli commands or workflows

Triggers: "bmad", "prd", "product brief", "architecture doc", "epics and stories", "test strategy", "design thinking", "quality gate", "sprint planning", "code review", "murat", "tea module"

BMAD Method Skill

BMAD (Business-Model-Architecture-Development) v6 is an AI-native methodology for software development with specialized agents and structured workflows.

Quick Start

# Initialize BMAD in a project
npx bmad-cli init

# Run a workflow
npx bmad-cli workflow <workflow-name>

# List available workflows
npx bmad-cli workflow --list

Core Concepts

Three Modules

| Module | Purpose | Key Agent | |--------|---------|-----------| | BMM | Product/Project Management | PM (John), Analyst (Mary), Architect (Winston) | | CIS | Creative & Innovation | Design Thinking Coach (Maya), Innovation Strategist (Victor) | | TEA | Test Engineering | Murat (Master Test Architect) |

BMAD Lifecycle (4 Phases)

Phase 1: Analysis     → Product Brief, Research
Phase 2: Planning     → PRD, UX Design  
Phase 3: Solutioning  → Architecture, Epics & Stories
Phase 4: Implementation → Dev, Code Review, Sprint Management

Module Reference

For detailed workflows and usage:

• BMM Workflows: See references/bmm.md
• CIS Workflows: See references/cis.md
• TEA Workflows: See references/tea.md
• Agent Profiles: See references/agents.md
• Full Lifecycle: See references/lifecycle.md

Common Workflows

Starting a New Project (Greenfield)

1. create-product-brief  → Capture vision & goals
2. create-prd           → Define requirements
3. create-ux-design     → Plan UI/UX (if applicable)
4. create-architecture  → Technical decisions
5. create-epics-and-stories → Break into implementable units
6. testarch-test-design → Plan test strategy
7. sprint-planning      → Organize work
8. dev-story            → Implement stories

Quick Development (Quick-Flow)

For smaller tasks without full ceremony:

1. quick-spec  → Create lightweight tech spec
2. quick-dev   → Implement directly

Test-Driven Development

1. testarch-atdd      → Write failing acceptance tests first
2. dev-story          → Implement to pass tests
3. testarch-automate  → Expand test coverage
4. testarch-trace     → Verify requirements coverage

Creative Sessions (CIS)

- design-thinking      → Human-centered design process
- innovation-strategy  → Business model innovation
- problem-solving      → Systematic problem analysis
- storytelling         → Narrative development

Project Structure

BMAD projects use this structure:

project/
├── _bmad/                    # BMAD configuration & memory
│   ├── _config/              # Manifests and settings
│   ├── _memory/              # Agent memory and state
│   ├── bmm/                  # BMM module files
│   ├── cis/                  # CIS module files
│   └── tea/                  # TEA module files
├── docs/                     # Generated documentation
│   ├── prd.md               # Product Requirements
│   ├── architecture.md      # Architecture decisions
│   ├── epics/               # Epic and story files
│   └── test-strategy.md     # Test planning
└── src/                      # Source code

Artifact Categories

BMAD organizes artifacts by category:

| Category | Contents | |----------|----------| | planning | Product Brief, PRD | | architecture | Architecture docs, ADRs | | stories | Epics, User Stories | | testing | Test Strategy, Test Plans | | ideation | Design Thinking outputs, Innovation docs |

Key Commands

# Workflow execution
npx bmad-cli workflow create-prd
npx bmad-cli workflow testarch-atdd

# Agent interaction
npx bmad-cli agent pm          # Talk to PM agent
npx bmad-cli agent murat       # Talk to Test Architect

# Sprint management
npx bmad-cli workflow sprint-planning
npx bmad-cli workflow sprint-status

Integration with Claude Code

When using Claude Code with BMAD:

1. Load context: Read _bmad/_config/manifest.yaml for installed modules
2. Check workflows: Use workflow-manifest.csv to find available workflows
3. Follow artifacts: Check docs/ for existing planning documents
4. Respect agent roles: Each agent has specific responsibilities

Tips

• Start with Analysis: Always begin with create-product-brief for new projects
• Use Quick-Flow for bug fixes or small features
• TEA integration: Run testarch-test-design before implementation
• Quality Gates: Use testarch-trace before releases
• Retrospectives: Run retrospective after each epic