Documentação e roteiro prático do método BMAD (Breakthrough Method…

INEMA

cliente → criar tarefa. Registre se há erros de navegação, delays, falhas de validação ou UX inconsistente. Crie um relatório técnico com correções sugeridas para o Dev Agent."

-------------------------------------------⌗

5. ORGANIZAÇÃO E CONTEXTO⌗

-------------------------------------------⌗

echo "📚 Organizando contexto e sincronização..."

bmad shard "Divida os documentos PRD e arquitetura em epics menores e histórias de usuário. Cada epic deve ter um objetivo único e tarefas claras. Use a estrutura: Epic 1 - Base/Autenticação, Epic 2 - CRM, Epic 3 - Workspace, Epic 4 - Automação IA."

bmad sync archon "Sincronize todos os documentos, PRD, arquitetura e UX no Archon para garantir que os agentes usem sempre a versão mais recente do contexto."

bmad status "Liste os agentes já executados, documentos criados e epics pendentes. Gere um relatório de progresso e próximos passos para o ciclo seguinte."

-------------------------------------------⌗

FINALIZAÇÃO⌗

-------------------------------------------⌗

echo "✅ Pipeline BMAD concluído com sucesso!" echo "📁 Estrutura gerada em $(pwd)" echo "🧩 Próximo passo: abrir no Claude Code e continuar com os epics gerados."

---

### Como usar

1. Salve o conteúdo acima em um arquivo chamado `bmad_project.sh`.
2. Dê permissão de execução:

   ```
   chmod +x bmad_project.sh
   ```3. Rode com:

   ```
   bash bmad_project.sh
   ```
 ```
4. Depois abra o projet**o no Claude Code De**sktop e os agentes já estarão com contexto criado automaticamente.

---

Abaixo está o **script completo `bmad_project.sh`** — pronto para rodar no **Claude Code Desktop**, **WSL** ou **terminal do Windows/Linux** com o **BMAD Core** instalado.

Esse script automatiza todo o processo mostrado na *Masterclass Building Complex AI Apps with BMAD*, desde o planejamento até a validação e sincronização com Archon.
Você só precisa salvar o conteúdo abaixo como `bmad_project.sh` e executar com:

```bash bmad_project.sh```

---

```bash
#!/bin/bash
## ===========================================================
## BMAD FULL PROJECT PIPELINE
## Método: Breakthrough Method for Agile AI-Driven Development
## Autor: Nei Maldaner (adaptado da masterclass original)
## ===========================================================

echo "🚀 Iniciando pipeline BMAD..."

## -------------------------------------------
## 1. CONFIGURAÇÃO INICIAL
## -------------------------------------------
echo "📦 Criando estrutura inicial do projeto..."
npx create-next-app@latest bmad-crm
cd bmad-crm || exit
npm install

## Instalar BMAD Core
echo "⚙️ Instalando BMAD Core..."
npm install -g bmad-core

## Inicializar estrutura do método
echo "📂 Inicializando diretórios padrão..."
bmad init

## Conectar ao Claude Code
echo "🔗 Conectando BMAD ao Claude Code IDE..."
bmad connect claude

## -------------------------------------------
## 2. PLANEJAMENTO (PLANNING PHASE)
## -------------------------------------------
echo "🧠 Executando fase de planejamento..."

bmad agent analyst "Pesquise o mercado atual de CRMs para pequenas e médias empresas.
Identifique as principais dores, oportunidades e tendências.
Destaque lacunas que podemos preencher com IA e diferenciais que tragam ROI real.
Gere um relatório resumido com tópicos e dados relevantes."

bmad agent pm "Com base na análise do mercado, crie um PRD (Product Requirement Document)
para um aplicativo de CRM integrado a IA com foco em simplicidade e eficiência.
Inclua: visão, objetivos, público-alvo, funcionalidades principais, métricas de sucesso
e roadmap dividido em MVP, V1 e V2."

bmad agent architect "Crie uma arquitetura técnica detalhada para o projeto CRM+Workspace.
Use Next.js + React + TypeScript no front-end e Supabase no back-end.
Inclua autenticação, controle de acesso, banco de dados vetorial e edge functions.
Descreva a estrutura de pastas, tabelas, APIs e políticas RLS de segurança."

bmad agent ux "Desenhe wireframes conceituais das telas principais:
Dashboard, Clientes, Tarefas, Chat e Configurações.
Descreva layout, hierarquia visual, componentes, espaçamento e navegação.
Use como referência visual o estilo da Untitled UI (limpo, profissional e moderno)."

## Gerar plano consolidado
echo "🗂️ Consolidando documentos de planejamento..."
bmad plan

## -------------------------------------------
## 3. EXECUÇÃO (DEVELOPMENT PHASE)
## -------------------------------------------
echo "💻 Iniciando fase de desenvolvimento..."

bmad agent dev "Com base na arquitetura e PRD, gere a estrutura inicial do projeto em Next.js e TypeScript.
Implemente as rotas: /dashboard, /clients, /tasks, /chat, /settings.
Use Tailwind CSS e componentes reutilizáveis.
Adicione autenticação com Supabase e verificação de sessão.
Inclua loading states e mensagens de erro básicas."

bmad agent dev "Implemente os módulos principais:
1. Lista de clientes com busca e filtros.
2. Cadastro de tarefas com status e prioridade.
3. Chat interno com IA para notas e lembretes.
4. Painel com cards de métricas do usuário.
Garanta coesão visual e separação de componentes para manutenção."

## -------------------------------------------
## 4. VALIDAÇÃO (QA PHASE)
## -------------------------------------------
echo "🧩 Validando qualidade e consistência..."

bmad agent qa "Revise o código atual validando se todas as funcionalidades básicas
seguem as definições do PRD e da arquitetura.
Verifique autenticação, formulários, controle de permissões e consistência dos componentes.
Liste melhorias sugeridas, bugs encontrados e recomendações de boas práticas."

bmad agent qa "Simule fluxos completos do usuário: login → dashboard → criar

contexto."

11. STATUS FINAL⌗

/bmad status "Liste os agentes já executados, documentos criados e epics pendentes.  
Gere um relatório de progresso e próximos passos para o ciclo seguinte."


---

### Resultado esperado após o roteiro`:

* /bmad/planning/analys`is.`md
* /bmad/planning/p`rd.`md
* /bmad/planning/architectu`re.`md
* /bmad/planning/ux-sp`ec.`md
* /bmad/execution/`src`/*
* /bmad/validation/qa-repo`rt.`md
* /bmad/ep`ics`/*
* /bmad/context/archon-sync`.json

---

Abaixo está o **Roteiro BMAD Completo** — o mesmo formato que o autor usou na masterclass, pronto para colar e rodar no **Claude Code** com o **BMAD Core**.
Ele segue o fluxo completo: *Planejamento → Execução → Validação → Organização*.
Cada bloco pode ser executado com o comando:

```/bmad agent <agente> "<instrução>"```

---

## FASE 1 – PLANEJAMENTO

### 1. ANALYST

```/bmad agent analyst "Pesquise o mercado atual de CRMs para pequenas e médias empresas.  
Identifique as principais dores, oportunidades e tendências.  
Destaque lacunas que podemos preencher com IA e diferenciais que tragam ROI real.  
Gere um relatório resumido com tópicos e dados relevantes."```

Saída esperada: `analysis.md` com insights de mercado, personas e oportunidades.

---

### 2. PRODUCT MANAGER (PM)

```/bmad agent pm "Com base na análise do mercado, crie um PRD (Product Requirement Document)  
para um aplicativo de CRM integrado a IA com foco em simplicidade e eficiência.  
Inclua: visão, objetivos, público-alvo, funcionalidades principais, métricas de sucesso  
e roadmap dividido em MVP, V1 e V2."```

Saída esperada: `prd.md` com visão clara do produto e fases de entrega.

---

### 3. ARCHITECT

```/bmad agent architect "Crie uma arquitetura técnica detalhada para o projeto CRM+Workspace.  
Use Next.js + React + TypeScript no front-end e Supabase no back-end.  
Inclua autenticação, controle de acesso, banco de dados vetorial e edge functions.  
Descreva a estrutura de pastas, tabelas, APIs e políticas RLS de segurança."```

Saída esperada: `architecture.md` com diagrama técnico e estrutura de pastas.

---

### 4. UX EXPERT

```/bmad agent ux "Desenhe wireframes conceituais das telas principais:  
Dashboard, Clientes, Tarefas, Chat e Configurações.  
Descreva layout, hierarquia visual, componentes, espaçamento e navegação.  
Use como referência visual o estilo da Untitled UI (limpo, profissional e moderno)."```

Saída esperada: `ux-spec.md` com descrição visual e hierarquia de interface.

---

## FASE 2 – EXECUÇÃO

### 5. DEV

```/bmad agent dev "Com base na arquitetura e PRD, gere a estrutura inicial do projeto em Next.js e TypeScript.  
Implemente as rotas: /dashboard, /clients, /tasks, /chat, /settings.  
Use Tailwind CSS e componentes reutilizáveis.  
Adicione autenticação com Supabase e verificação de sessão.  
Inclua loading states e mensagens de erro básicas."```

Saída esperada: diretórios `/app` e `/components` criados e conectados ao Supabase.

---

### 6. DEV (Complementar)

```/bmad agent dev "Implemente os módulos principais:  
1. Lista de clientes com busca e filtros.  
2. Cadastro de tarefas com status e prioridade.  
3. Chat interno com IA para notas e lembretes.  
4. Painel com cards de métricas do usuário.  
Garanta coesão visual e separação de componentes para manutenção."```

---

## FASE 3 – VALIDAÇÃO

### 7. QA

```/bmad agent qa "Revise o código atual validando se todas as funcionalidades básicas  
seguem as definições do PRD e da arquitetura.  
Verifique autenticação, formulários, controle de permissões e consistência dos componentes.  
Liste melhorias sugeridas, bugs encontrados e recomendações de boas práticas."```

Saída esperada: `qa-report.md` com checklist e sugestões técnicas.

---

### 8. QA (Teste de Fluxo)

```/bmad agent qa "Simule fluxos completos do usuário: login → dashboard → criar cliente → criar tarefa.  
Registre se há erros de navegação, delays, falhas de validação ou UX inconsistente.  
Crie um relatório técnico com correções sugeridas para o Dev Agent."```

---

## FASE 4 – ORGANIZAÇÃO E CONTEXTO

### 9. DOCUMENT SHARDING

```/bmad shard "Divida os documentos PRD e arquitetura em epics menores e histórias de usuário.  
Cada epic deve ter um objetivo único e tarefas claras.  
Use a estrutura: Epic 1 - Base/Autenticação, Epic 2 - CRM, Epic 3 - Workspace, Epic 4 - Automação IA."```

---

### 10. SINCRONIZAÇÃO (ARCHON)

``` /bmad sync archon "Sincronize todos os documentos, PRD, arquitetura e UX no Archon
para garantir que os agentes usem sempre a versão mais recente do

No vídeo “Masterclass – Building Complex AI Apps with BMAD”, o criador mostra o uso prático dos comandos do método BMAD dentro do Claude Code e do BMAD Core (instalado via terminal).

Abaixo, listo os principais comandos que ele usa e explica, divididos por função (com exemplos reais citados no vídeo).

1. Instalação e Configuração do Projeto⌗

Esses comandos são usados logo no início, para criar o ambiente de trabalho.

npx create-next-app@latest bmad-crm cd bmad-crm npm install

Depois ele conecta o projeto ao Claude Code e ao BMAD Core:

npm install -g bmad-core bmad init

Esse comando bmad init cria a estrutura base com os diretórios e arquivos padrões do método BMAD:

/bmad /agents /planning /execution /validation config.json

2. Ativação do Framework BMAD no Projeto⌗

Para habilitar o framework dentro do Claude Code:

/bmad connect claude

Ou, dependendo da versão do desktop:

bmad setup --ide claude

Isso conecta o projeto à API interna do Claude Code, permitindo que os agentes BMAD sejam chamados direto no editor.

3. Criação dos Agentes e Fluxo⌗

Ele explica que cada agente pode ser invocado com comandos diretos, por exemplo:

/bmad agent analyst /bmad agent pm /bmad agent architect /bmad agent ux /bmad agent dev /bmad agent qa

Cada um desses agentes abre um prompt específico (pré-programado) dentro do BMAD Core.

Exemplo de uso:

/bmad agent analyst "Pesquise o mercado atual de CRMs para pequenas empresas e liste diferenciais."

Resultado: o agente Analyst gera um documento inicial chamado analysis.md dentro da pasta /planning.

4. Geração de Documentos Automáticos⌗

Após os agentes trabalharem, ele usa:

/bmad plan

Esse comando organiza os outputs dos agentes Analyst, PM e Architect e gera os documentos automáticos:

brief.md
prd.md
architecture.md
front-spec.md

E depois ele faz o “document sharding” (divisão dos docs grandes):

/bmad shard

Isso cria subpastas tipo:

/epics epic-1-crm-core.md epic-2-workspace.md

5. Execução e Desenvolvimento⌗

Quando começa o desenvolvimento:

/bmad dev

Esse comando ativa os agentes Dev e UX Expert. Ele pede, por exemplo:

/bmad dev "Crie a estrutura inicial do frontend usando Next.js e TypeScript com layout da Untitled UI."

Isso gera o código em /src/app.

6. Testes e Validação⌗

Para acionar o QA:

/bmad qa

E ele mostra o uso com exemplo prático:

/bmad qa "Valide se o fluxo de autenticação do Supabase está funcional e seguro."

O agente QA retorna um relatório .md com recomendações e possíveis correções.

7. Integração com Archon (contexto centralizado)⌗

Ele conecta o projeto ao Archon, que mantém os documentos e contexto disponíveis para os MCP servers (Claude Code):

/archon link

E, em versões mais novas:

bmad sync archon

Isso garante que tudo que foi criado (PRD, código, specs) esteja sincronizado no contexto do projeto.

8. Visualização do Progresso⌗

Para acompanhar o status geral:

/bmad status

Retorna um sumário com:

Agentes já executados
Documentos criados
Epics pendentes
Histórico de commits dos agentes

9. Pipeline Completo (resumo dos comandos usados no vídeo)⌗

bmad init bmad connect claude bmad agent analyst bmad agent pm bmad agent architect bmad plan bmad shard bmad dev bmad qa bmad sync archon bmad status

Abaixo, listo os principais comandos que ele usa e explica, divididos por função (com exemplos reais citados no vídeo).

1. Instalação e Configuração do Projeto⌗

Esses comandos são usados logo no início, para criar o ambiente de trabalho.

npx create-next-app@latest bmad-crm cd bmad-crm npm install

Depois ele conecta o projeto ao Claude Code e ao BMAD Core:

npm install -g bmad-core bmad init

Esse comando bmad init cria a estrutura base com os diretórios e arquivos padrões do método BMAD:

/bmad /agents /planning /execution /validation config.json

2. Ativação do Framework BMAD no Projeto⌗

Para habilitar o framework dentro do Claude Code:

/bmad connect claude

Ou, dependendo da versão do desktop:

bmad setup --ide claude

Isso conecta o projeto à API interna do Claude Code, permitindo que os agentes BMAD sejam chamados direto no editor.

3. Criação dos Agentes e Fluxo⌗

Ele explica que cada agente pode ser invocado com comandos diretos, por exemplo:

/bmad agent analyst /bmad agent pm /bmad agent architect /bmad agent ux /bmad agent dev /bmad agent qa

Cada um desses agentes abre um prompt específico (pré-programado) dentro do BMAD Core.

Exemplo de uso:

/bmad agent analyst "Pesquise o mercado atual de CRMs para pequenas empresas e liste diferenciais."

Resultado: o agente Analyst gera um documento inicial chamado analysis.md dentro da pasta /planning.

4. Geração de Documentos Automáticos⌗

Após os agentes trabalharem, ele usa:

/bmad plan

Esse comando organiza os outputs dos agentes Analyst, PM e Architect e gera os documentos automáticos:

brief.md
prd.md
architecture.md
front-spec.md

E depois ele faz o “document sharding” (divisão dos docs grandes):

/bmad shard

Isso cria subpastas tipo:

/epics epic-1-crm-core.md epic-2-workspace.md

5. Execução e Desenvolvimento⌗

Quando começa o desenvolvimento:

/bmad dev

Esse comando ativa os agentes Dev e UX Expert. Ele pede, por exemplo:

/bmad dev "Crie a estrutura inicial do frontend usando Next.js e TypeScript com layout da Untitled UI."

Isso gera o código em /src/app.

6. Testes e Validação⌗

Para acionar o QA:

/bmad qa

E ele mostra o uso com exemplo prático:

/bmad qa "Valide se o fluxo de autenticação do Supabase está funcional e seguro."

O agente QA retorna um relatório .md com recomendações e possíveis correções.

7. Integração com Archon (contexto centralizado)⌗

Ele conecta o projeto ao Archon, que mantém os documentos e contexto disponíveis para os MCP servers (Claude Code):

/archon link

E, em versões mais novas:

bmad sync archon

Isso garante que tudo que foi criado (PRD, código, specs) esteja sincronizado no contexto do projeto.

8. Visualização do Progresso⌗

Para acompanhar o status geral:

/bmad status

Retorna um sumário com:

Agentes já executados
Documentos criados
Epics pendentes
Histórico de commits dos agentes

9. Pipeline Completo (resumo dos comandos usados no vídeo)⌗

bmad init bmad connect claude bmad agent analyst bmad agent pm bmad agent architect bmad plan bmad shard bmad dev bmad qa bmad sync archon bmad status

como construir aplicações complexas de IA usando o método BMAD, explicando por que esse método supera o “promptar” solto (vibe-coding) e mostrando, na prática, um projeto real sendo feito passo a passo.

Aqui está o que ele diz, organizado por partes principais:

1. Introdução: o problema do “vibe-coding”⌗

Ele começa dizendo que a maioria das pessoas erra ao usar IA para programar porque apenas digita prompts vagos em chatbots. Isso gera código inconsistente, sem documentação e impossível de manter. O BMAD foi criado justamente para resolver isso:

“O BMAD é uma metodologia de desenvolvimento estruturado, onde cada agente de IA tem um papel específico, como numa equipe real de software.”

2. A proposta do BMAD⌗

Ele explica que BMAD significa Breakthrough Method for Agile AI-Driven Development e que o método se divide em duas grandes fases:

Planejamento (Planning) → onde os agentes Analyst, PM e Architect definem escopo, documentos e arquitetura.
Execução (Development & QA) → onde Dev, UX-Expert e QA constroem, testam e validam o app.

Ele ressalta que a ordem dos agentes importa, e que cada etapa alimenta a próxima com contexto estruturado.

3. O caso prático: construindo um app real⌗

Ele decide provar o método construindo um CRM com área de trabalho (Workspace). Usa as seguintes tecnologias:

Next.js + React + TypeScript + Untitled UI (frontend)
Supabase + Banco Vetorial + Edge Functions (backend)
Claude Code + Archon (IDE e repositório de contexto)

Explica como Archon centraliza todo o conhecimento do projeto (documentos, APIs, componentes), evitando que o modelo de IA se perca ou gere código fora do escopo.

4. Agentes e fluxo do BMAD⌗

Ele mostra que o BMAD trabalha com agentes fixos:

Analyst → pesquisa, requisitos, análise de mercado
PM → planejamento e PRD
Architect → arquitetura técnica
UX Expert → wireframes e experiência do usuário
Dev → implementação e integração
QA → testes e documentação final

Cada um tem prompts e tarefas próprias, e Claude Code executa cada papel separadamente.

“Você não conversa com a IA como um gênio universal. Você conversa com um time de especialistas.”

5. Documentação automatizada e “document sharding”⌗

Ele mostra que, após o planejamento, o sistema gera automaticamente documentos estruturados (Brief, PRD, Front Spec, Arquitetura). Esses documentos são então fragmentados (“sharded”) em partes menores — epics e histórias — para que os agentes possam trabalhar em paralelo e com contexto limitado.

6. Crítica aos métodos antigos⌗

Ele diz que muitas ferramentas ainda tentam aplicar o modelo de desenvolvimento tradicional com IA — e isso gera previsões falsas, retrabalho e ilusão de produtividade.

“A IA não substitui o humano. Ela acelera quando existe um processo bem definido.”

7. Resultados práticos⌗

Ele mostra que em poucas horas conseguiu:

Definir e documentar o produto completo
Gerar toda a base de código inicial
Estruturar o banco e políticas de segurança
Criar automações internas para ROI real

E afirma que esse método reduz o tempo de desenvolvimento em 10x.

8. Conclusão e visão de futuro⌗

No fim, ele reforça:

“O BMAD não é sobre fazer tudo com IA. É sobre usar IA como uma equipe disciplinada e orquestrada.”

Ele agradece e incentiva a audiência a usar frameworks estruturados, a não depender de prompts aleatórios, e a pensar em aplicações de IA com valor real de negócio, não apenas experimentos.

Criando App com BMAD

chatgpt.com ↗

Documentação e roteiro prático do método BMAD (Breakthrough Method…

-------------------------------------------⌗

5. ORGANIZAÇÃO E CONTEXTO⌗

-------------------------------------------⌗

-------------------------------------------⌗

FINALIZAÇÃO⌗

-------------------------------------------⌗

11. STATUS FINAL⌗

1. Instalação e Configuração do Projeto⌗

2. Ativação do Framework BMAD no Projeto⌗

3. Criação dos Agentes e Fluxo⌗

4. Geração de Documentos Automáticos⌗

5. Execução e Desenvolvimento⌗

6. Testes e Validação⌗

7. Integração com Archon (contexto centralizado)⌗

8. Visualização do Progresso⌗

9. Pipeline Completo (resumo dos comandos usados no vídeo)⌗

1. Instalação e Configuração do Projeto⌗

2. Ativação do Framework BMAD no Projeto⌗

3. Criação dos Agentes e Fluxo⌗

4. Geração de Documentos Automáticos⌗

5. Execução e Desenvolvimento⌗

6. Testes e Validação⌗

7. Integração com Archon (contexto centralizado)⌗

8. Visualização do Progresso⌗

9. Pipeline Completo (resumo dos comandos usados no vídeo)⌗

1. Introdução: o problema do “vibe-coding”⌗

2. A proposta do BMAD⌗

3. O caso prático: construindo um app real⌗

4. Agentes e fluxo do BMAD⌗

5. Documentação automatizada e “document sharding”⌗

6. Crítica aos métodos antigos⌗

7. Resultados práticos⌗

8. Conclusão e visão de futuro⌗

Recursos