BMAD Command Guide
BMAD Command Guide
Use this as an intro above your guide:
If you work with AI tools every day, you know the real challenge is not access to models, it is choosing the right workflow for the problem in front of you. Over time, I found that having a clear command map makes a huge difference: less context switching, faster decisions, and better outcomes from planning to implementation and testing. In this post, I organized the BMAD command ecosystem into practical categories so you can quickly pick the best command for each stage of work, whether you are shaping requirements, designing architecture, coding features, or validating quality. Think of this as a field guide you can scan in seconds and use immediately.
1. Interactive Agents (Conversational AI Assistants)
These spawn specialized AI personas you chat with:
| Command | Agent Name | Purpose | Example Use |
|---|---|---|---|
/bmad-agent-bmm-analyst |
Mary (Business Analyst) | Market research, requirements gathering, competitive analysis | “Analyze competitors in the fintech space” |
/bmad-agent-bmm-architect |
Winston (Architect) | System design, API design, scalability patterns | “Review my microservices architecture” |
/bmad-agent-bmm-tech-writer |
[Tech Writer] | Documentation structure, technical writing | “Improve my API documentation” |
/bmad-agent-bmm-ux-designer |
[UX Designer] | User experience, design workflows, wireframes | “Create UX flow for checkout process” |
/bmad-agent-bmm-pm |
[Product Manager] | Product strategy, roadmaps, prioritization | “Help prioritize my backlog” |
/bmad-agent-bmm-sm |
[Scrum Master] | Agile ceremonies, team facilitation | “Plan our next sprint” |
/bmad-agent-bmm-dev |
[Developer] | Coding assistance, implementation guidance | “Help design this module” |
/bmad-agent-bmm-qa |
[QA Engineer] | Quality assurance, test planning | “Design test strategy for new feature” |
/bmad-agent-bmb-agent-builder |
[Agent Builder] | Create custom AI agents | “Build an agent for code reviews” |
/bmad-agent-bmb-module-builder |
[Module Builder] | Create reusable modules | “Build a module for data validation” |
/bmad-agent-bmb-workflow-builder |
[Workflow Builder] | Create automated workflows | “Build a deployment workflow” |
/bmad-agent-bmm-quick-flow-solo-dev |
[Solo Dev Flow] | End-to-end single developer workflow | “Take my idea to production plan” |
/bmad-agent-tea-tea |
[Test Engineer] | Test architecture, automation | “Design test framework” |
2. Planning & Requirements (BMM - Phase 1-2)
For creating and validating product requirements:
| Command | Purpose | Example |
|---|---|---|
/bmad-bmm-create-product-brief |
Create executive product brief | Starting a new product initiative |
/bmad-bmm-create-prd |
Create Product Requirements Document | Defining feature requirements |
/bmad-bmm-edit-prd |
Modify existing PRD | Update requirements after feedback |
/bmad-bmm-validate-prd |
Validate PRD against standards | Check if PRD is complete |
/bmad-bmm-market-research |
Market & competitive analysis | Research market opportunities |
/bmad-bmm-domain-research |
Industry/domain deep dive | Learn about a new industry |
/bmad-bmm-technical-research |
Technical feasibility research | Evaluate tech options |
/bmad-bmm-create-story |
Create user stories | Break features into stories |
/bmad-bmm-create-epics-and-stories |
Generate epics and stories | Full backlog creation |
/bmad-bmm-quick-spec |
Quick feature specification | Fast-track a simple feature |
/bmad-brainstorming |
Guided brainstorming session | Generate ideas for a problem |
/bmad-bmm-sprint-planning |
Plan sprint content | Organize work for next sprint |
3. Architecture & Solutioning (BMM - Phase 3)
For technical design and architecture:
| Command | Purpose | Example |
|---|---|---|
/bmad-bmm-create-architecture |
Create technical architecture document | Design system architecture |
/bmad-bmm-check-implementation-readiness |
Verify all docs are aligned before coding | Check if ready to build |
/bmad-bmm-create-ux-design |
Create UX design deliverables | Design user interfaces |
/bmad-bmm-correct-course |
Review and adjust project direction | Pivot or adjust plans |
4. Development & Implementation
For building and coding:
| Command | Purpose | Example |
|---|---|---|
/bmad-bmm-dev-story |
Develop a specific user story | Implement a story |
/bmad-bmm-dev-from-linear |
Start development from Linear ticket | Work from existing ticket |
/bmad-bmm-quick-dev |
Quick development mode | Fast prototype building |
/bmad-bmm-code-review |
Perform code review | Review PR or code |
/bmad-bmm-generate-project-context |
Generate project documentation | Document codebase for LLMs |
/bmad-bmm-document-project |
Create comprehensive project docs | Full project documentation |
5. Testing & QA (TEA - Test Engineering Agent)
For testing and quality:
| Command | Purpose | Example |
|---|---|---|
/bmad-tea-testarch-framework |
Design test architecture | Create testing framework |
/bmad-tea-testarch-test-design |
Design specific tests | Write test cases |
/bmad-tea-testarch-automate |
Automate tests | Create test automation |
/bmad-tea-testarch-atdd |
Acceptance Test-Driven Development | ATDD implementation |
/bmad-tea-testarch-nfr |
Non-functional requirements testing | Performance/security testing |
/bmad-tea-testarch-ci |
CI/CD testing integration | Set up test pipelines |
/bmad-tea-testarch-trace |
Test traceability | Link tests to requirements |
/bmad-tea-testarch-test-review |
Review test coverage | Audit test quality |
/bmad-tea-teach-me-testing |
Learn testing concepts | Educational testing help |
/bmad-bmm-qa-generate-e2e-tests |
Generate end-to-end tests | Create E2E test suite |
6. BMB - Bot/Module/Workflow Building
For building reusable AI components:
| Command | Purpose | Example |
|---|---|---|
/bmad-bmb-create-agent |
Create a custom AI agent | Build specialized reviewer |
/bmad-bmb-edit-agent |
Modify existing agent | Update agent behavior |
/bmad-bmb-validate-agent |
Validate agent configuration | Check agent setup |
/bmad-bmb-create-module |
Create reusable module | Build auth module |
/bmad-bmb-edit-module |
Edit existing module | Update module code |
/bmad-bmb-validate-module |
Validate module structure | Check module correctness |
/bmad-bmb-create-workflow |
Create automated workflow | Build approval workflow |
/bmad-bmb-edit-workflow |
Edit existing workflow | Modify workflow steps |
/bmad-bmb-rework-workflow |
Refactor workflow | Redesign workflow |
/bmad-bmb-validate-workflow |
Validate workflow | Check workflow logic |
/bmad-bmb-validate-max-parallel-workflow |
Validate parallel workflows | Check concurrent workflows |
/bmad-bmb-create-module-brief |
Create module specification | Document module requirements |
7. Review & Editorial
For reviewing and improving content:
| Command | Purpose | Example |
|---|---|---|
/bmad-review-adversarial-general |
Adversarial review of work | Stress-test your design |
/bmad-editorial-review-prose |
Review writing style | Improve documentation prose |
/bmad-editorial-review-structure |
Review document structure | Reorganize content |
/bmad-bmm-retrospective |
Sprint/project retrospective | Team retrospective session |
8. Utility Commands
| Command | Purpose | Example |
|---|---|---|
/bmad-help |
Get help on what to do | “Where should I start?” |
/bmad-party-mode |
Fun/random ideation mode | Creative brainstorming |
/bmad-shard-doc |
Split large documents | Break up PRD into sections |
/bmad-bmm-sprint-status |
Check sprint progress | View current sprint state |
/bmad-portable-prompt |
Create portable AI prompts | Reusable prompt templates |
/bmad-index-docs |
Index documentation | Create doc search index |
/bmad-agent-bmad-master |
Master agent (orchestrates others) | Complex multi-agent tasks |
Quick Decision Tree
Starting something new?
├─ Have an idea? → /bmad-agent-bmm-analyst → [CB] Create Brief
├─ Know what you want? → /bmad-bmm-create-prd
└─ Just exploring? → /bmad-brainstorming
Ready to design?
├─ Technical design? → /bmad-bmm-create-architecture
└─ UX design? → /bmad-bmm-create-ux-design
Ready to build?
├─ Check readiness first → /bmad-bmm-check-implementation-readiness
├─ Have stories? → /bmad-bmm-dev-story
└─ Starting from Linear? → /bmad-bmm-dev-from-linear
Need testing?
└─ /bmad-agent-tea-tea → [TF] Test Framework Design
Need review?
├─ Code review? → /bmad-bmm-code-review
├─ PRD/TDD review? → Use appropriate agent (analyst/architect)
└─ Adversarial critique? → /bmad-review-adversarial-general
Building reusable components?
└─ /bmad-bmb-create-agent or /bmad-bmb-create-workflow
Pro tip: Use /bmad-help at any time to get guidance on what command to use next!