> ## Documentation Index
> Fetch the complete documentation index at: https://specs.md/llms.txt
> Use this file to discover all available pages before exploring further.

# specs.md vs BMAD-Method

> Compare specs.md with BMAD's multi-agent framework

## Overview

Both **specs.md (AI-DLC)** and **BMAD-Method** target complex systems and enterprise-scale development. The key difference is their approach to agent organization.

**BMAD-Method** uses 19+ role-based agents that simulate a full development team (Analyst, PM, Architect, Developer, QA, etc.).

**specs.md (AI-DLC)** uses 3 phase-based agents aligned to AI-DLC's methodology (Inception, Construction, Operations).

***

## Side-by-Side Comparison

| Aspect | specs.md | BMAD |
| - | - | - |
| **Target Complexity** | Complex systems (same tier) | Complex/Enterprise systems (same tier) |
| **Origin** | AWS formal methodology | Community-driven framework |
| **Agent Philosophy** | 3 phase-based agents | 19+ role-based agents |
| **Agents** | Master, Inception, Construction, Operations | Analyst, PM, Architect, Dev, QA, UX, etc. |
| **Methodology** | AI-DLC (AWS standard) | Agentic Agile (open source) |
| **Design Technique** | DDD integrated as core | Optional, team choice |
| **Rituals** | Mob Elaboration, Mob Construction (collocated) | Agent handoffs (async) |
| **Iteration** | Bolts ("hours or days") | Epics/Stories |
| **Complexity** | Moderate | High |
| **Customization** | Skills + Templates | Full persona customization via YAML |
| **Community** | Just born (December 2025) | 26k+ GitHub stars |
| **VS Code Extension** | Yes ([visual dashboard](https://specs.md/getting-started/vscode-extension.md)) | No |

***

## When to Choose Each

> [card] Choose specs.md (AI-DLC) if:
>
> * You want a formal AWS methodology
> * You prefer fewer, phase-aligned agents
> * You want DDD as an integral part (not optional)
> * You value collocated Mob rituals
> * You want to avoid managing 19 agents
> * You want a [VS Code extension](https://specs.md/getting-started/vscode-extension.md) to track progress visually

> [card] Choose BMAD if:
>
> * You want maximum agent customization
> * You prefer role-based agent simulation
> * You're comfortable with higher complexity
> * You want 19+ specialized personas
> * You prefer async agent handoffs
> * You have time to invest in learning

***

## Key Differences

### 1. Agent Organization

**BMAD**: Focuses on traditional Agile roles—19+ agents mimicking a full development team with familiar titles.

```
Analyst Agent → PM Agent → Architect Agent →
Product Owner Agent → Scrum Master Agent →
Developer Agent → QA Agent → ...
```

**specs.md (AI-DLC)**: Focuses on AI development lifecycle phases with shorter iterations (Bolts, not sprints). 3 agents aligned to process phases.

```
Inception Agent → Construction Agent → Operations Agent
```

### 2. Methodology Foundation

**BMAD**: "Breakthrough Method for Agile AI-Driven Development" - an open source framework built on agile principles with AI agents replacing human roles.

**specs.md**: AWS's formally defined AI-DLC methodology with specific phases, rituals, and artifacts documented in a whitepaper.

### 3. Design Technique Integration

**BMAD**: Design techniques are optional. Teams can choose their own approach.

**specs.md**: DDD is integrated as core. AI applies domain-driven design principles during decomposition—it's not optional.

### 4. Rituals and Collaboration

**BMAD**: Agents hand off documents to each other asynchronously.

**specs.md**: Mob Elaboration and Mob Construction are collocated rituals where teams work together with AI in real-time.

***

## Agent Mapping

If you're familiar with BMAD agents, here's how they map to AI-DLC:

| BMAD Agents | specs.md Phase |
| - | - |
| Analyst, PM | **Inception Agent** - requirements elaboration |
| Architect | **Inception Agent** + **Construction Agent** - domain modeling |
| Product Owner, Scrum Master | **Master Agent** - orchestration |
| Developer, QA | **Construction Agent** - code generation, testing |
| DevOps | **Operations Agent** - deployment |

***

## Complexity vs Control Trade-off

```mermaid actions={false} theme={null}
flowchart LR
    SM(specs.md<br/>3 agents):::done --> |"More agents<br/>More control"| BM(BMAD<br/>19+ agents):::design
    BM --> |"Fewer agents<br/>Simpler mental model"| SM
    classDef design fill:#fff,stroke:#A855F7,color:#7E22CE,stroke-width:1.5px,rx:8,ry:8
    classDef done fill:#fff,stroke:#10B981,color:#047857,stroke-width:1.5px,rx:8,ry:8
```

***

## Migration Path

If you're currently using BMAD and want to try AI-DLC:

**1. Map Your Agents**

Understand how your 19 agents map to 3 AI-DLC phases

**2. Adopt Mob Rituals**

Replace async handoffs with collocated Mob Elaboration and Mob Construction

**3. Integrate DDD**

Move from optional design techniques to DDD as core

**4. Use Phase-Based Thinking**

Organize work by phase (Inception → Construction → Operations) rather than role

***

## Summary

| For This Need | Use This |
| - | - |
| Formal AWS methodology | specs.md |
| Maximum agent customization | BMAD |
| Simpler mental model (3 agents) | specs.md |
| Role-based simulation (19+ agents) | BMAD |
| DDD as core requirement | specs.md |
| Collocated Mob rituals | specs.md |
| Async agent handoffs | BMAD |

> [!NOTE]
>
> **Bottom Line**: Both target complex systems. specs.md offers a formal methodology with 3 phase-based agents. BMAD offers maximum customization with 19+ role-based agents.
>
> *Choose based on whether you prefer methodology-driven simplicity or agent-driven flexibility.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.