dbmad - Don't Be MAD 🚀

BMAD Method Claude Code commands installer

Install BMAD Method commands in any project to supercharge your development workflow with Claude Code. The BMAD Method (Breakthrough Method of Agile AI-driven Development) provides specialized AI agents that work as your high-powered development team.

What is BMAD?

BMAD Method transforms AI-assisted coding into a structured project development methodology. It provides:

• 🧠 7 Specialized AI Agents - From Analyst to Developer
• 📋 Structured Workflow - Ideation to implementation
• ✅ Quality Assurance - Built-in checklists and validation
• 🔄 Flexible Architecture - Works in any project

Quick Start

# Install BMAD commands in your project
npx dbmad init

# Or install globally
npm install -g dbmad
dbmad init

This creates:

• .claude/commands/ - Claude Code custom commands
• .bmad/ - Project state and configuration

Available Commands

After installation, use these commands in Claude Code:

• /project:bmad - Main orchestrator
• /project:do - Execute specific tasks
• /project:next - Get workflow recommendations

CLI Usage

# Initialize BMAD in current project
dbmad init

# Install with agent files
dbmad init --agents

# Update to latest version
dbmad update

# Add/remove specific commands
dbmad add status
dbmad remove export

# List installed commands
dbmad list

# Validate installation
dbmad validate

# Configure settings
dbmad config

Options

dbmad init [options]

• -f, --force - Overwrite existing files
• -a, --agents - Include BMAD agent files
• -c, --commands <commands...> - Specific commands to install

dbmad update [options]

• -b, --backup - Backup before updating

Configuration

Configuration is stored in .bmad/config.json:

{
  "version": "1.0.0",
  "commands": {
    "prefix": "project:",
    "enabled": ["bmad", "do", "next"]
  },
  "agents": {
    "included": true,
    "location": ".bmad/agents"
  },
  "workflow": {
    "default": "standard",
    "phases": ["ideation", "planning", "design", "development", "delivery"]
  }
}

BMAD Workflow

graph LR
    A[Idea] --> B[Analyst]
    B --> C[PM]
    C --> D[Architect]
    D --> E[PO]
    E --> F[SM]
    F --> G[Dev]
    G --> H[Delivery]

Agents & Their Roles

1. Analyst - Research, ideation, project briefs
2. PM - Product requirements, epics, planning
3. Architect - System design, technical architecture
4. Design Architect - UI/UX, frontend architecture
5. PO - Validation, story creation, prioritization
6. SM - Sprint planning, story refinement
7. Dev - Implementation, testing, delivery

Project Structure

After initialization:

your-project/
├── .claude/
│   └── commands/
│       ├── project:bmad.md
│       ├── project:do.md
│       └── project:next.md
├── .bmad/
│   ├── config.json
│   ├── state/
│   │   └── current.json
│   └── agents/          # Optional
└── .gitignore          # Updated

Programmatic Usage

const dbmad = require('dbmad');

// Initialize BMAD
await dbmad.init({
  force: false,
  agents: true,
  commands: ['bmad', 'do', 'next']
});

// Update configuration
await dbmad.updateConfig('.bmad', {
  workflow: {
    customPhases: ['research', 'design', 'build', 'deploy']
  }
});

// Validate installation
const result = await dbmad.validate();
console.log('Valid:', result.valid);

Requirements

• Node.js >= 14.0.0
• Claude Code extension
• Git repository (recommended)

Troubleshooting

Commands not showing in Claude Code

1. Ensure .claude/commands/ directory exists
2. Restart Claude Code
3. Run dbmad validate to check installation

Permission errors

• Run with appropriate permissions
• Check directory write access

Missing agent files

• Use dbmad init --agents to include agent files
• Or copy manually from BMAD-METHOD repository

Contributing

Contributions welcome! Please read our Contributing Guide.

License

MIT © BMAD Method Contributors

Links

• BMAD Method Documentation
• GitHub Repository
• NPM Package

Don't Be MAD, Be GLAD you're using BMAD! 😄