Método BMAD: time ágil com IA na IDE
Método BMAD: agentes como PO, arquiteto e dev no Cursor/Claude Code. Fluxo PRD → stories → código — com processo, sem vibe coding solto.
Por que isso é importante
Método BMAD: simule um time ágil com agentes de IA (PO, arquiteto, dev) na IDE. Menos vibe coding solto, mais artefatos e entrega previsível no Cursor ou Claude Code.
TL;DR — Resumo Rápido
O método BMAD organiza agentes de IA como um time ágil completo dentro da sua IDE. Cada agente assume um papel — PO, Arquiteto, Scrum Master, Dev e Revisor — e executa o fluxo de desenvolvimento ágil: PRD, arquitetura, epics, stories, implementação e code review. Funciona no Cursor AI, Claude Code e Gemini CLI. Um dev solo consegue entregar um SaaS completo em horas, com código documentado, revisado e versionado. O framework é open source, modular e você controla cada decisão.
Por que isso é importante
O método BMAD organiza agentes de IA como um time ágil dentro da IDE: PO, arquiteto, Scrum Master, dev e revisor. Em vez de vibe coding solto, você roda PRD → arquitetura → sprint com papéis claros.
O Que é o BMAD e Qual Problema Resolve
Clonar sites ou gerar apps com comandos rápidos ficou fácil demais. Isso levou muitos devs a pular etapas críticas do ciclo de desenvolvimento. Até funciona pra protótipos descartáveis, mas pra produção? O resultado é código sem contexto, sem testes e difícil de escalar. É o famoso "vibe coding" — funciona no demo, quebra no deploy.
BMAD significa Breakthrough Method for Agile AI-Driven Development. É um framework open source criado pela comunidade que organiza agentes de IA como membros de um time ágil — cada um com sua função dentro da sua IDE. Ele replica o fluxo de um time de engenheiros: PRD, arquitetura, epics, stories, implementação, testes e revisão. Tudo isso sem sair do terminal.
Se você quer entender como as IDEs com IA se comparam antes de escolher onde rodar o BMAD, confira nosso comparativo completo entre Cursor, Windsurf e Trae.
Como Funciona: Time Completo na IDE
Com o BMAD, sua IDE vira um time completo: PO, Arquiteto, Scrum Master, Dev e Revisor. Cada agente segue regras claras — interpreta requisitos, quebra tarefas e executa implementações iterativas com validação contínua. Não é um chatbot genérico jogando código na tela. Cada agente tem prompt próprio, contexto isolado e responsabilidades definidas.
Pra começar, você só precisa de dois arquivos: o PRD (Product Requirements Document) e a Arquitetura da Aplicação. Esses dois alimentam todo o processo dos agentes que vão construir o software passo a passo. O PRD define o quê construir. A Arquitetura define como construir. Os agentes cuidam do resto.
Atenção
Os arquivos devem ficar na pasta docs/ do projeto. Nomeie eles corretamente como arquitetura.md e prd.md — senão o fluxo quebra. Os agentes procuram esses nomes exatos pra carregar o contexto.
Etapas do Workflow Inteligente
O workflow do BMAD segue uma sequência lógica que espelha o processo de um time ágil. Cada passo depende do anterior, e você aprova manualmente antes de avançar — nada roda no automático sem sua validação.
Agentes Simulados: Quais Funções Existem
Cada agente do BMAD é especializado. Eles não são chatbots genéricos — são prompts calibrados pra executar uma função específica no ciclo de desenvolvimento. Aqui tá o mapa completo:
PO (Product Owner)
Faz o sharding do PRD, gerencia prioridades e garante que os requisitos estejam claros pra todos os agentes.
Arquiteto
Gera o plano de arquitetura baseado nas funções do PRD. Define stack, estrutura de pastas e padrões de código.
Scrum Master
Gera epics e histórias numeradas (1.1, 1.2...), organiza tarefas e valida se o escopo tá coerente com o PRD.
Dev
Implementa as histórias respeitando arquitetura e PRD. Gera código limpo, testável e com contexto.
Revisor/Test Agent
Valida a implementação contra as instruções da história. Escaneia a base de código e garante qualidade antes do merge.
Orchestrator
Coordena a comunicação entre agentes. Gerencia fluxo de tokens, distribui contexto e escala a complexidade do projeto.
Importante
O método BMAD é totalmente modular. Os agentes guardam estado por chat, então você precisa iniciar cada um numa thread nova pra evitar colisão de contexto. Misturar agentes na mesma conversa é a receita certa pra respostas confusas.
Prompt Engineering pros Agentes BMAD
Os agentes do BMAD funcionam com prompts pré-calibrados, mas dá pra customizar cada um pro seu contexto. Mexer nos prompts é o que separa um setup genérico de um workflow afinado pro seu projeto.
Customizando o Dev Agent
O Dev Agent segue padrões de código definidos na arquitetura. Se você quer TypeScript strict, testes unitários em cada função ou ESLint com regras específicas, injeta isso no prompt do agente. Quanto mais concreto, melhor o output. Prompt vago gera código vago.
Calibrando o Revisor
O Revisor pode ser relaxado ou rigoroso — depende do que você pede. Pra MVPs rápidos, configure ele pra focar em bugs críticos e segurança. Pra produção, aumente a exigência: cobertura de testes, performance, acessibilidade. Ajusta conforme a fase do projeto.
PM e Perguntas de Negócio
O agente PM faz perguntas genéricas por padrão. Se você manja do domínio, adiciona perguntas específicas no prompt: monetização, compliance, integrações obrigatórias, métricas de sucesso. Isso eleva o PRD de "aceitável" pra "pronto pra investidor".
Dica prática
No Cursor AI, as regras globais ficam em .cursorrules na raiz do projeto. No Claude Code, use o arquivo CLAUDE.md. Ambos funcionam como um RULES.md que todo agente respeita — defina padrões de código, convenções de nome e regras de negócio aqui.
Minha recomendação: comece com os prompts padrão do BMAD, rode uma iteração completa e só depois ajuste. Mexer nos prompts antes de entender o fluxo é otimização prematura.
Trabalhando por Iterações
Inspirado no Scrum, o BMAD trabalha por partes. Cada epic é quebrado em histórias numeradas (tipo 1.1, 1.2...) e cada história tem uma única responsabilidade. Isso deixa tudo mais claro pra IA e mais fácil de escalar ou revisar. Quando uma iteração termina, você analisa o que foi entregue e decide o próximo ciclo.
Diferente de outros frameworks, o BMAD tem documentação acessível direto no repositório do GitHub. E você toma todas as decisões no fluxo da interface, usando comandos interativos. Nada acontece por mágica — cada transição entre agentes exige sua aprovação.
Cuidado com Contexto
Usando agentes com contextos grandes, é fácil estourar o limite de tokens. Sempre divida os agentes em chats separados e não repasse PRD ou Arquitetura direto num mesmo contexto com muitos elementos ativos. O sharding do PO existe exatamente pra isso.
Setup: Do Zero ao Primeiro Epic
Pra instalar, vai no repositório BMAD no GitHub, baixa os arquivos base e coloca na raiz do seu projeto. Depois cria o PRD e a Arquitetura na pasta docs/ e inicia os agentes pela interface da IDE.
O BMAD roda em qualquer ambiente que aceite comandos slash ou arquivos de configuração. As IDEs mais populares pra isso são Cursor AI e Claude Code — ambas com suporte nativo a agentes e contexto de projeto.
Dá pra encurtar a curva de aprendizado com o comando /create doc usando o agente PM. Ele faz perguntas que refinam escopo, funcionalidades e regras do negócio — tipo uma sessão de product discovery automatizada.
BMAD vs Vibe Coding vs Dev Tradicional
Três caminhos diferentes pra construir software em 2026. Cada um tem seu lugar, mas o BMAD ocupa um espaço que ninguém preenchia: o meio-termo entre velocidade e profissionalismo.
Vibe Coding
Pede pra IA gerar código e torce pra funcionar. Sem PRD, sem arquitetura, sem processo. Rápido pra protótipos descartáveis.
Prós
- Velocidade absurda pra demos
- Zero setup necessário
- Funciona pra scripts simples
Contras
- Código sem contexto nem estrutura
- Escala zero — vira espaguete rápido
- Sem testes, sem revisão
- Debugging vira pesadelo
BMAD Method
Agentes IA organizados como time ágil. PRD, arquitetura, epics, stories, implementação e revisão — tudo na IDE.
Prós
- Processo completo e profissional
- Código com contexto e arquitetura
- Revisão automatizada por agente
- Escala pra projetos grandes
- Dev solo produz como time
Contras
- Setup inicial de 30-60 minutos
- Curva de aprendizado dos agentes
- Consome mais tokens por projeto
Dev Tradicional
Time completo com PO, arquiteto, devs, QA. Sprints, dailys, retrospectivas. O modelo comprovado pela indústria.
Prós
- Processo maduro e documentado
- Colaboração entre humanos
- Qualidade comprovada em escala
Contras
- Caro — precisa de 4-8 pessoas
- Lento — sprints de 2 semanas mínimo
- Overhead de comunicação e reuniões
- Dev solo não consegue replicar
Se o vibe coding te interessa mas você quer algo mais estruturado, dá uma olhada no guia do Lovable — uma plataforma no-code que tá entre o vibe coding e o BMAD em termos de estrutura.
O BMAD não compete com o dev tradicional em times grandes. Ele brilha quando um dev solo ou uma equipe enxuta precisa da disciplina de um processo ágil sem o custo de contratar 5 pessoas. É produtividade com processo — não código jogado na parede.
Quando NÃO Usar o BMAD
Seria desonestidade da minha parte fingir que o BMAD funciona pra tudo. Não funciona. Tem cenários onde ele atrapalha mais do que ajuda — e reconhecer isso faz parte de usar a ferramenta com inteligência.
No resto dos casos — SaaS, apps internos, MVPs, side projects, freelance — o BMAD entrega. Mas saber quando não usar é tão valioso quanto saber quando usar.
Na Prática: Construindo um SaaS com BMAD
Vamos sair da teoria. Imagina que você quer construir um SaaS de gestão de agendamentos — backend em Node.js, frontend em React, banco no Supabase. Com o fluxo tradicional, isso leva 2-3 semanas pra ter um MVP funcional. Em setups enxutos, dá pra chegar a um MVP em poucas horas de trabalho focado — o tempo real depende do escopo e da sua revisão.
Passo 1 — PRD com o Agente PM
Abre uma thread nova, ativa o agente PM e usa o comando /create doc. Ele vai te fazer umas 15 perguntas sobre o produto: quem é o usuário, quais funcionalidades do MVP, quais regras de negócio, qual a monetização. Em 20 minutos você tem um PRD completo e estruturado — melhor do que a maioria dos PRDs escritos por POs humanos.
Passo 2 — Arquitetura com o Arquiteto
Nova thread, ativa o Arquiteto. Ele lê o PRD, sugere stack, define estrutura de pastas, padrões de API e decisões técnicas. Pra um SaaS de agendamentos, ele provavelmente vai sugerir: Next.js no front, API Routes no back, Supabase pro banco e auth (dá uma olhada no curso de Supabase do CrazyStack pra dominar), e Stripe pra pagamentos. Você ajusta o que não concorda e aprova.
Passo 3 — Epics e Stories com o Scrum Master
O Scrum Master pega PRD + Arquitetura e quebra tudo em epics. Epic 1: Auth e onboarding. Epic 2: CRUD de agendamentos. Epic 3: Notificações. Cada epic tem 4-6 histórias numeradas com critérios de aceitação. Você revisa, reprioriza e aprova o que entra na primeira iteração.
Passo 4 — Implementação e Revisão
O Dev Agent implementa história por história. O Revisor valida cada uma antes de marcar como done. No final da primeira iteração, você tem auth funcionando, CRUD de agendamentos e a base do sistema pronta. O segundo ciclo adiciona notificações, dashboard e pagamentos.
Quer se aprofundar no backend? O curso de Node.js do CrazyStack cobre arquitetura de APIs, autenticação e deploy — a base perfeita pra entender o que os agentes BMAD estão gerando.
Resultado concreto
Um SaaS completo com auth, CRUD, notificações e pagamentos — construído por uma pessoa em menos de um dia útil. O mesmo escopo levaria 2-3 semanas com um time tradicional de 3-4 devs. O BMAD não faz mágica: ele elimina o tempo de coordenação, handoff e espera entre etapas.
BMAD com Supabase: Stack Prática pra SaaS
Se você quer uma stack que encaixa perfeito no workflow BMAD, Supabase é a resposta mais prática. Auth pronto, banco Postgres com API auto-gerada, real-time nativo e storage pra arquivos — tudo sem configurar servidor.
Por que Supabase + BMAD funciona tão bem
O agente Arquiteto gera um plano de banco no Supabase em minutos. O Dev Agent cria as tabelas, configura RLS (Row Level Security) e conecta o frontend via SDK do Supabase. Auth? O agente configura login com email, Google e GitHub em uma história. Real-time? Mais uma história. Cada pedaço vira uma história independente no workflow — testável e revisável.
Na prática, Next.js + Supabase + BMAD acelera auth, CRUD, real-time e storage — mas o tempo até um MVP útil depende do escopo, da qualidade do PRD e da revisão humana. Trate “poucas horas” como cenário otimista, não garantia. O que sobra é lógica de negócio específica — e isso os agentes também ajudam.
Quer dominar o Supabase antes de plugar no BMAD? O curso de Supabase do CrazyStack cobre tudo: auth, banco, real-time, storage e deploy. E pra quem quer entender o frontend, o curso de Next.js complementa a stack.
Stack recomendada
Next.js (frontend + API routes) + Supabase (banco, auth, real-time) + Vercel (deploy) + BMAD (processo). Essa combinação cobre a base da maioria dos SaaS simples que um dev solo costuma montar. O agente Arquiteto já sugere essa stack por padrão quando detecta que o projeto é um SaaS.
Erros Comuns e Como Evitar
O BMAD é direto, mas tem armadilhas que pegam quem tá começando. Esses são os 5 erros mais comuns — e a solução pra cada um.
Após o MVP: Brainstorm e Iterações
Depois de definir o MVP, você pode usar o mesmo framework pra fazer brainstorm de novas ideias com ChatGPT, Gemini ou Claude. O comando brainstorm reorganiza prioridades e sugere novos caminhos baseados no que já foi implementado. É como ter uma sessão de product discovery automatizada depois de cada entrega.
Cada nova iteração segue o mesmo ciclo: atualizar PRD, gerar novos epics, quebrar em histórias, implementar e revisar. O processo se mantém consistente independente da complexidade do projeto. E como tudo fica documentado nos artefatos, trocar de IDE ou de modelo de IA no meio do caminho não quebra nada.
Do MVP ao Deploy: Fechando o Ciclo
MVP pronto não serve pra nada se ninguém acessa. O ciclo BMAD não termina no código — termina no deploy. E com as ferramentas certas, colocar no ar leva menos de 15 minutos.
Pra estratégias de deploy baratas e confiáveis, confira o guia Deploy do Pobre — cobre Vercel, Railway, Fly.io e alternativas gratuitas pra colocar seu SaaS no ar sem gastar.
O ponto é: o BMAD gera código pronto pra produção. Se você seguiu o fluxo — PRD, arquitetura, histórias revisadas, código validado pelo Revisor — o deploy é só o último passo. Sem drama, sem surpresa.
Revisão de Código Automatizada
Antes de marcar a história como finalizada, ela passa pelo agente de revisão. Ele escaneia a base de código, busca as instruções da história e garante que tudo foi implementado corretamente. Se tá tudo certo, muda o status de review pra done. Se encontra problemas, devolve com feedback específico — tipo um PR review automatizado.
O Revisor não é um linter glorificado. Ele checa se a implementação respeita a arquitetura definida, se os padrões do PRD foram seguidos e se não tem código morto ou dependências desnecessárias. É a última barreira antes do merge — e a mais importante pra manter a qualidade ao longo das iterações.
Pra projetos maiores, você pode configurar o Revisor pra rodar testes automatizados junto com a análise de código. Isso fecha o loop: o agente Dev implementa, o Revisor valida e testa, e só depois a história é marcada como done.
Escalando o Workflow com IA Especializada
A vantagem do BMAD é que você pode plugar ferramentas externas conforme o projeto cresce. Bancos vetoriais pra RAG, analytics pra monitorar qualidade do código, gestão de tokens pra projetos longos — tudo se encaixa no fluxo modular dos agentes.
Use as instruções do agente Orchestrator pra escalar a complexidade. Ele coordena a comunicação entre agentes, distribui contexto e gerencia o consumo de tokens. Pra projetos com mais de 50 histórias, o Orchestrator é a diferença entre um workflow organizado e um caos de contextos misturados.
Se você tá montando o frontend do seu projeto com BMAD, o tutorial completo de shadcn/ui ensina a construir interfaces profissionais com componentes prontos — perfeito pra alimentar as histórias do agente Dev.
Ferramentas Que Potencializam o BMAD
O BMAD é agnóstico de ferramenta, mas algumas IDEs e CLIs encaixam melhor que outras. Aqui tá o mapa das que testei e recomendo.
Cursor AI
A IDE mais popular pro BMAD. Suporte nativo a .cursorrules, threads isoladas por agente e autocompletar com contexto de projeto. Melhor opção pra quem tá começando.
Claude Code
Terminal-first, poderoso pra projetos grandes. Usa CLAUDE.md como regras globais e roda agentes direto no shell. Ideal pra quem prefere linha de comando.
Gemini CLI
Alternativa gratuita do Google. Aceita arquivos de contexto e funciona como terminal agent. Boa opção pra testar o BMAD sem custo.
Task Master AI
Gerenciador de tarefas com IA que complementa o BMAD. Parseia PRDs, gera tasks com dependências e acompanha progresso. Funciona via CLI ou MCP.
Quer entender as diferenças entre essas ferramentas? Confira o comparativo Claude Code vs Replit e Lovable e o guia do Gemini CLI pra escolher a que encaixa no seu workflow.
Minha recomendação: começa com Cursor AI se você quer interface visual e facilidade. Migra pro Claude Code quando sentir que o terminal dá mais controle. O Gemini CLI é pra quem quer testar sem gastar — e funciona surpreendentemente bem.
Por Que o BMAD Muda o Jogo pra Dev Solo
O BMAD faz qualquer dev solo replicar o processo de um time inteiro: planejamento, engenharia, construção, revisão e entrega. Não é promessa — é o fluxo rodando na sua IDE.
Antes do BMAD, um dev solo tinha duas opções: pular etapas (e pagar o preço depois) ou gastar semanas fazendo o trabalho de 5 pessoas. Agora existe uma terceira via: manter o rigor do processo ágil enquanto os agentes cuidam da execução. Você decide, eles implementam.
Isso muda o jogo pra freelancers, indie hackers e fundadores técnicos. Dá pra validar ideias com qualidade de produção em dias, não meses. E quando o projeto cresce, o processo já tá documentado — onboardar um dev humano no time fica trivial porque o PRD, a arquitetura e o histórico de decisões já existem.
Perguntas Frequentes sobre o BMAD
As dúvidas mais comuns de quem tá avaliando ou começando com o método BMAD. Se a sua pergunta não tá aqui, manda nos comentários.
O que é o método BMAD?
BMAD (Breakthrough Method for Agile AI-Driven Development) é um framework open source que organiza agentes de IA como membros de um time ágil dentro da sua IDE. Cada agente assume um papel específico — Product Owner, Arquiteto, Scrum Master, Desenvolvedor e Revisor — seguindo o fluxo de desenvolvimento ágil completo: do PRD à entrega do código revisado.
O BMAD funciona com Cursor AI e Claude Code?
Funciona. O BMAD é agnóstico de IDE — roda em qualquer ambiente que aceite comandos slash ou arquivos de configuração. O Cursor AI e o Claude Code são as IDEs mais populares pra usar o método porque ambas têm suporte nativo a agentes, contexto de projeto e gerenciamento de threads. O código e os artefatos gerados são portáveis entre plataformas.
Preciso saber Scrum pra usar o BMAD?
Não precisa. O BMAD usa a terminologia do Scrum (epics, stories, sprints), mas os agentes abstraem toda a complexidade do processo. Você só precisa entender o fluxo básico: definir o que quer (PRD), aprovar a arquitetura, revisar as histórias e validar as entregas. O Scrum Master virtual cuida do resto.
Qual a diferença entre BMAD e Vibe Coding?
Vibe coding é pedir pra IA gerar código sem planejamento — funciona pra protótipos descartáveis. O BMAD adiciona processo: PRD, arquitetura, epics, stories, implementação e revisão — tudo com agentes especializados. O resultado é código que escala, com documentação e histórico de decisões. Vibe coding é velocidade sem direção. BMAD é velocidade com processo.
Quanto custa usar o BMAD em termos de tokens?
O consumo varia com o tamanho do projeto. Pra um SaaS de porte médio (20-30 histórias), espere gastar entre 500k e 2M tokens ao longo de todo o ciclo — do PRD ao deploy. O custo principal vem do agente Dev e do Revisor, que processam mais contexto. Usar o sharding do PO e manter threads isoladas ajuda a otimizar o consumo. Em dólares, um projeto completo fica entre $10 e $40 dependendo do modelo usado.
Como configurar o BMAD no Cursor AI?
O setup no Cursor leva menos de 10 minutos. Aqui tá o passo a passo sem frescura:
Dica
O Cursor permite fixar arquivos no contexto com @file. Use isso pra manter o PRD e a Arquitetura sempre visíveis pro agente ativo — evita respostas fora de escopo.
Checklist de Implementação do BMAD
Perguntas frequentes
O que é o método BMAD?
BMAD (Breakthrough Method for Agile AI-Driven Development) é um framework open source que organiza agentes de IA como membros de um time ágil dentro da sua IDE. Cada agente assume um papel específico — Product Owner, Arquiteto, Scrum Master, Desenvolvedor e Revisor — seguindo o fluxo de desenvolvimento ágil completo: do PRD à entrega do código revisado.
O BMAD funciona com Cursor AI e Claude Code?
Funciona. O BMAD é agnóstico de IDE — roda em qualquer ambiente que aceite comandos slash ou arquivos de configuração. O Cursor AI e o Claude Code são as IDEs mais populares pra usar o método porque ambas têm suporte nativo a agentes, contexto de projeto e gerenciamento de threads. O código e os artefatos gerados são portáveis entre plataformas.
Preciso saber Scrum pra usar o BMAD?
Não precisa. O BMAD usa a terminologia do Scrum (epics, stories, sprints), mas os agentes abstraem toda a complexidade do processo. Você só precisa entender o fluxo básico: definir o que quer (PRD), aprovar a arquitetura, revisar as histórias e validar as entregas. O Scrum Master virtual cuida do resto.
Qual a diferença entre BMAD e Vibe Coding?
Vibe coding é pedir pra IA gerar código sem planejamento — funciona pra protótipos descartáveis. O BMAD adiciona processo: PRD, arquitetura, epics, stories, implementação e revisão — tudo com agentes especializados. O resultado é código que escala, com documentação e histórico de decisões. Vibe coding é velocidade sem direção. BMAD é velocidade com processo.