Breakthrough Method for Agile AI-Driven Development

Pare de
vibe coding.
Comece a arquitetar.

O BMAD organiza agentes de IA especializados em um pipeline agile completo — do brainstorming até a entrega de código de produção.

Ver o fluxo Conhecer os agentes
49k+ ⭐ GitHub stars
5.7k forks
12+ agentes especializados
MIT open-source

// o problema

Context drift:
por que a IA "esquece" seu projeto

Quando você mistura planejamento e implementação no mesmo chat, o modelo começa a perder o fio dos requisitos originais conforme a conversa avança. O resultado é código inconsistente, decisões contraditórias e débito técnico desde o dia 1.

Vibe Coding
Prompts do tipo "faz funcionar" sem estrutura
Requisitos espalhados no histórico do chat
IA esquece o contexto entre sessões
Código duplicado, convenções inconsistentes
Sem handoff entre design, dev e QA
Resultado: débito técnico desde o início
BMAD Method
Specs estruturadas escritas antes do código
Contexto preservado em artefatos persistentes
Cada agente recebe exatamente o que precisa
Agentes especializados por papel no SDLC
Quality gates em cada transição de fase
Resultado: production-ready desde o início

// o fluxo

Upstream → Downstream

O BMAD divide o desenvolvimento em duas fases. Upstream é pensar — transformar uma ideia em especificações ricas. Downstream é construir — implementar com contexto total e zero ambiguidade.

Upstream — Thinking (planejamento)
Mary — Analyst
Descoberta e pesquisa
Brainstorming estruturado, pesquisa de mercado e domínio, criação do project brief e análise PRFAQ.
project-brief.md market-research.md
Paige — Tech Writer
Documentação e diagramas
Documenta o projeto, gera diagramas Mermaid, valida documentação existente. Atua em toda a fase upstream.
docs/ diagrams/
John — Product Manager
Requisitos e stories
Cria e valida o PRD, quebra o trabalho em épicos e user stories, verifica implementation readiness.
prd.md epic-N.md story-N.md
Sally — UX Designer
Especificações de UX
Mapeia fluxos de usuário, especifica componentes, define estados, regras de validação e critérios de aceite orientados à experiência.
ux-design.md user-flows.md
Winston — Architect
Arquitetura técnica
Define stack, padrões arquiteturais, design de APIs, modelo de dados, ADRs e decisões de infraestrutura.
architecture.md adr-N.md data-model.md
Specs completas
contexto rico por artefato → sem ambiguidade
Downstream pronto
Downstream — Building (implementação)
Bob — Scrum Master
Stories ultra-detalhadas
Cria stories com contexto máximo — cada story contém tudo que Amelia precisa implementar sem ambiguidade.
story-N.md (completa)
Amelia — Developer
Implementação story por story
Implementa com contexto total, faz code review, sprint planning e investigação forense de bugs complexos.
código code-review.md
Murat — Test Architect (TEA)
Arquitetura de testes
Estratégia completa de QA: ATDD, design de frameworks de teste, CI/CD, cobertura por camada.
test-plan.md ci-pipeline.md

// os agentes

12+ especialistas,
cada um no seu domínio

Cada agente é uma persona com identidade fixa, skills bem definidos e contexto limitado ao que precisa para fazer seu trabalho. Eles são ativados pelo nome — "Hey Mary, vamos brainstormar" — ou pelos triggers de menu.

M
Mary
Business Analyst
upstream

Primeira a entrar em ação. Transforma uma ideia vaga em base sólida para o projeto inteiro via brainstorming e pesquisa.

Brainstorming Market research Domain research PRFAQ Project brief
skill: bmad-agent-analyst — triggers: BP, MR, DR, TR, CB
J
John
Product Manager
upstream

Converte o brief em requisitos estruturados. Cria o PRD, decompõe em épicos e stories, valida readiness.

PRD Épicos User stories INVEST Course correction
skill: bmad-agent-pm — triggers: PRD, CE, IR, CC
W
Winston
System Architect
upstream

Define como o sistema será construído. Stack, padrões, APIs, modelo de dados, ADRs e infraestrutura.

Arquitetura Stack selection API design ADRs C4 diagrams
skill: bmad-agent-architect — triggers: CA, IR
S
Sally
UX Designer
upstream

Traduz requisitos funcionais em specs de UX: fluxos, estados, validações, critérios de aceite de interface.

User flows UI specs Validações Acessibilidade Estados
skill: bmad-agent-ux-designer — trigger: CU
P
Paige
Technical Writer
upstream

Documenta o projeto, gera diagramas Mermaid, valida documentação existente, explica conceitos técnicos.

Docs técnicas Mermaid Doc validation README Changelogs
skill: bmad-agent-tech-writer — triggers: DP, WD, MG, VD, EC
B
Bob
Scrum Master
downstream

Cria stories com contexto máximo — cada story contém tudo que o Developer precisa sem ambiguidade ou más decisões.

Stories detalhadas Sprint planning Backlog Retrospectiva Velocity
skill: bmad-agent-sm — triggers: SP, CS
A
Amelia
Senior Engineer
downstream

Implementa story por story com contexto total. Code review, quick dev, forensic investigation de bugs.

Dev stories Code review Quick dev Forensic debug MCP integration
skill: bmad-agent-dev — triggers: DS, QD, QA, CR, SP, CS, ER, IN
M
Murat
Test Architect — TEA
módulo TEA

Arquitetura completa de testes enterprise: ATDD, frameworks por camada, pipelines CI/CD, cobertura e performance.

ATDD Test frameworks CI/CD E2E Performance
módulo: TEA — triggers: ATDD, CI, test-design, framework

// conceitos chave

O que faz o BMAD funcionar

📐
Context Engineering

Cada agente recebe exatamente os artefatos que precisa — nem mais, nem menos. Isso mantém cada chamada ao LLM focada e eficiente, sem desperdiçar a context window com informações irrelevantes.

📄
File-based handoff

Artefatos são arquivos Markdown persistentes no repositório. O contexto não vive no histórico de chat — vive em arquivos versionados que qualquer agente pode carregar com precisão em qualquer sessão futura.

🎭
Named agents

"Hey Mary, vamos brainstormar" ativa a analista diretamente. Não há menu para navegar nem comandos para memorizar quando o intent é claro. A persona permanece consistente e customizável por equipe via TOML.

🔒
Role boundaries

Cada agente tem um escopo rígido. Mary não toma decisões técnicas, Winston não escreve user stories. Isso evita conflitos de contexto e mantém a qualidade de cada saída dentro do domínio esperado.

🚦
Quality gates

Antes de cada transição de fase, um conjunto de critérios precisa ser satisfeito. O Architect não começa sem um PRD validado. Amelia não implementa sem uma story com critérios de aceite claros.

Scale-adaptive intelligence

O BMAD ajusta automaticamente a profundidade do planejamento baseado na complexidade do projeto. Bug fix vira quick-dev em minutos. Sistema enterprise recebe o fluxo completo com governança.


// comparativo

BMAD vs vibe coding

Vibe Coding
"Faz funcionar" — prompts sem estrutura
Requisitos em histórico de chat (perecíveis)
Context drift — IA perde o fio
Um assistente generalista pra tudo
Sem handoff entre design, dev e QA
Outputs: respostas de chat (não revisáveis)
Funciona... até não funcionar mais
BMAD Method
Specs estruturadas escritas antes do código
Contexto em artefatos Markdown versionados
Cada agente recebe exatamente o que precisa
12+ agentes especializados por papel
Quality gates em cada transição de fase
Outputs: arquivos revisáveis e versionáveis
Production-ready desde o primeiro sprint

// ecossistema

Spec-Driven Development em 2026

O ecossistema explodiu. Mais de 30 frameworks competem pelo mesmo espaço. Cada um resolve um slice diferente do problema.

BMAD Method
★ 49k+ GitHub stars

Framework completo com 12+ agentes especializados, fluxo upstream/downstream, quality gates e customização por equipe.

Ideal para: Times em escala, greenfield, compliance enterprise
MIT · open-source
GitHub Spec Kit
★ 93k+ GitHub stars

Python CLI baseado em "constitution" — um arquivo de regras markdown imutáveis. Suporta 30+ AI agents incluindo Claude Code.

Ideal para: Times que querem portabilidade e sem lock-in de IDE
open-source
Amazon Kiro
GA desde Nov 2025

IDE agêntica da AWS centrada em SDD. Usa EARS (Easy Approach to Requirements Syntax) para acceptance criteria estruturados.

Ideal para: Stacks consolidando em AWS
pago + free tier
OpenSpec
lightweight

Framework leve focado em mudanças incrementais em projetos brownfield. Abordagem code-first ou PRD-first conforme necessidade.

Ideal para: Projetos brownfield, times pequenos
open-source
GSD
★ 63k+ GitHub stars (5 meses)

Get Shit Done. Meta-prompting e context engineering com wave-based context management. Otimizado para Claude Code e Gemini CLI.

Ideal para: Solo devs, adoção rápida
open-source
Tessl
$125M raised · 10k+ specs

Spec Registry com mais de 10.000 specs para bibliotecas externas — elimina alucinações de API e confusões de versão em produção.

Ideal para: Codebases com muitas dependências externas
comercial

// começar agora

Instalar o BMAD

Funciona com Claude Code, Cursor e Codex CLI. Um comando instala tudo.

Configuração em 4 passos
1
Pré-requisitos
node --version
git --version
Node.js LTS + Git instalados
2
Instalar o BMAD
npx bmad-method install
No diretório raiz do projeto
3
Abrir no Claude Code
claude .
Ou no Cursor / Codex CLI
4
Começar
bmad-help
Guia interativo do que fazer a seguir
Documentação oficial → GitHub