Compilação de dicas e tutoriais sobre o BMAD-METHOD™, framework de…

INEMA

crie uma pagina no github sobre este conhecimento

https://inematds.github.io/BMAD-Academy/

Como Automatizar sim, quase tudo pode ser automático, mas com um detalhe importante: o BMAD-METHOD™ trabalha em ciclos inteligentes, não totalmente automáticos, porque ele precisa de sua validação humana entre as etapas.

Vamos explicar de forma prática e objetiva:

COMO FUNCIONA A AUTOMAÇÃO NO BMAD⌗

1. Você dá o assunto (exemplo)⌗

Você escreve:

Quero criar um curso sobre o método BMAD para iniciantes.

2. O agente principal bmad-master entra em ação⌗

Você chama:

/bmad-master

E diz:

Crie todo o planejamento, arquitetura e conteúdo do curso sobre o método BMAD.

Ele automaticamente:

Cria o PRD (documento de requisitos)
Cria a arquitetura do curso
Divide os módulos
Gera o roteiro dos agentes (quem faz o quê)
E pode até criar as histórias (módulos e lições)

Tudo isso sem você ter que trocar de agente manualmente.

3. Você valida o resultado (1 clique)⌗

Ele para e pergunta algo como:

“Deseja que eu gere agora o conteúdo do primeiro módulo?”

Você responde “Sim”.

Então ele:

Chama automaticamente o Dev Agent → cria o texto, slides e atividades.
Depois chama o QA Agent → revisa e melhora.
E por fim retorna o conteúdo pronto.

4. Você pode configurar o modo “auto”⌗

Dentro do Claude Code ou Cursor, você pode dizer:

/bmad-master Ative o modo automático completo. Quero que o curso seja criado inteiro sem pausas.

Esse modo faz o sistema:

Criar o planejamento, arquitetura e conteúdo completo,
Rodar os agentes (PM → Architect → Dev → QA),
E te entregar a pasta final /content/ com todos os módulos prontos.

5. Quando é melhor não deixar 100% automático⌗

O automático é ótimo, mas o BMAD foi projetado para que você ainda seja o “diretor”. Por quê?

Ele pode gerar conteúdo bom, mas talvez não exatamente no seu estilo.
Então o ideal é deixar ele gerar o esqueleto completo, e você revisa cada módulo com o QA antes da publicação.

Nível de automação	Como ativar	O que ele faz
Semi-automático (recomendado)	`/bmad-master`	Cria tudo em sequência, mas pede confirmação entre etapas
Totalmente automático	`/bmad-master auto`	Cria todo o curso sozinho, sem pausas
Manual (padrão)	`/pm`, `/architect`, `/dev`, `/qa`	Você chama os agentes conforme precisar

Criar um curso usando o próprio BMAD para ensinar o BMAD é a melhor forma de mostrar como o método funciona na prática. A seguir está o passo a passo completo, direto e didático para você montar esse curso com ajuda dos agentes dentro do Claude Code.

ETAPA 1 – Instalação e Preparação⌗

Instale o BMAD:

npx bmad-method install 2. Abra o Claude Code (ou Cursor, Roo Code, Windsurf, etc.) 3. Verifique se o diretório .bmad-core/ foi criado. Ele contém os agentes e as regras do sistema.

ETAPA 2 – Criação do Projeto do Curso⌗

No Claude Code, crie uma nova pasta, por exemplo: curso-bmad/
Dentro dela, crie duas pastas:

docs/ → para documentos (PRD e arquitetura)
content/ → para roteiros e materiais do curso

ETAPA 3 – Fase de Planejamento (usando o agente PM)⌗

Abra um novo chat e chame:

/pm 2. Diga: “Quero criar um curso prático para ensinar o método BMAD para iniciantes. Estruture os módulos e objetivos de aprendizagem.” 3. O agente PM (Product Manager) vai criar o PRD (documento de requisitos do curso). 4. Quando terminar, salve o texto em docs/prd.md.

ETAPA 4 – Fase de Arquitetura (usando o agente Architect)⌗

Abra um novo chat e chame:

/architect 2. Diga: “Crie a arquitetura do curso com base no PRD: defina módulos, tópicos, sequência e o tipo de conteúdo (vídeo, exercício, quiz).” 3. O agente Architect vai gerar um plano técnico e pedagógico. 4. Salve o resultado em docs/architecture.md.

ETAPA 5 – Dividir o conteúdo em partes (sharding)⌗

No chat do bmad-master, digite:

*shard-doc docs/prd.md prd *shard-doc docs/architecture.md architecture

Isso divide o conteúdo em pedaços menores para que cada agente possa trabalhar sem perder contexto.

ETAPA 6 – Criação dos módulos (usando Scrum Master e Dev)⌗

Abra novo chat:

/bmad-master

/sm

Peça: “Crie a primeira história (story) do curso: módulo 1 – introdução ao BMAD.”
Ele criará um plano de tarefas. Você revisa e aprova.
Em seguida, chame o agente Dev:

/dev

e diga: “Implemente o conteúdo do módulo 1 com base na story aprovada.”

ETAPA 7 – Revisão de Qualidade (QA)⌗

Abra novo chat:

/qa 2. Diga: “Revise e melhore o conteúdo do módulo 1. Verifique se está coerente e didático.”

O QA ajusta tom, clareza e consistência do texto do módulo.

ETAPA 8 – Criação contínua⌗

Repita o ciclo:

PM → Architect → SM → Dev → QA

para cada módulo ou parte do curso.

ETAPA 9 – Montagem final do curso⌗

Use o agente Designer (se incluído) ou Dev para gerar:

Slides,
PDFs,
Roteiros de vídeo,
Exercícios interativos.

Peça ao bmad-master para:

*create-course-outline

Ele compila tudo e entrega um plano final.

ETAPA 10 – Publicação⌗

O BMAD pode exportar o conteúdo como site (HTML), PDF ou markdown para plataformas como Notion, Teachable ou Moodle.
Peça ao Dev:

/dev Gere a versão web do curso com base no conteúdo pronto.

Exemplo de fluxo prático⌗

/pm → “Crie o plano geral do curso”
/architect → “Crie a estrutura detalhada”
/bmad-master → “Divida o curso em módulos e tarefas”
/dev → “Implemente o conteúdo do módulo 1”
/qa → “Revise e otimize a didática”

Dentro do Claude Code, os agentes do BMAD-METHOD™ não atuam automaticamente — você precisa chamá-los manualmente, conforme o tipo de tarefa.

A sintaxe é simples:

No Claude Code, use o formato:

/agent-name

Exemplo:

/bmad-master /dev /qa /pm /architect

Regras práticas:

Sempre abra um novo chat ao trocar de agente (isso mantém o contexto limpo e organizado).
Os comandos mais usados são:
*help → mostra os comandos disponíveis
*status → mostra o andamento do projeto
*create → cria a próxima tarefa (Scrum Master)
*shard-doc docs/prd.md prd → divide o documento em partes menores
*exit → encerra o modo do agente

Assim, você controla cada etapa do projeto chamando os agentes conforme a necessidade — eles não se ativam sozinhos, mas trabalham em sequência organizada quando você os chama.

Depois de instalar o BMAD-METHOD™, o uso é simples:

Abra seu editor — pode ser Claude Code, VS Code, Cursor ou outro que tenha suporte a Node.js.
Entre no terminal (no próprio editor).
Rode o comando:

npx bmad-method 4. O sistema vai abrir opções no terminal. Você escolhe o que quer fazer:

Criar novo projeto com IA
Adicionar agentes (Analista, Arquiteto, Dev, QA, Scrum Master)
Usar um pacote de expansão (como escrita, negócios ou jogos). 5. Depois de escolher, você começa a conversar com os agentes dentro do próprio editor. Exemplo: digite *analyst e descreva o que quer criar.

Ele então cria automaticamente o plano, a arquitetura e as tarefas, e vai te guiando passo a passo.

De forma simples e direta:

Você instala com o comando

npx bmad-method install

O sistema cria um time de agentes de IA, cada um com uma função:

Analista entende o que você quer.
Arquiteto planeja como fazer.
Dev cria.
QA testa.
Scrum Master organiza.

Você só conversa com eles, dizendo o que quer (ex: “quero um site para consultas médicas”).
Os agentes se comunicam entre si e fazem o plano, criam o código e entregam o resultado pronto.
Você revisa e aprova.

Funciona dentro de um ambiente como Claude Code ou VS Code, onde você vê tudo acontecendo em tempo real.

Você pode rodar o BMAD-METHOD™ usando Claude Code ou qualquer IDE com suporte a Node.js 20+.

As opções mais usadas são:

Claude Code – integração direta e automática com os agentes BMAD.
VS Code – funciona via terminal com npx bmad-method install.
Gemini CLI, Cursor, Qwen Code ou Trae IDE – também suportados.

Comando principal:

npx bmad-method install

Depois disso, escolha os agentes e comece a interagir pelo IDE escolhido.

https://github.com/bmad-code-org/BMAD-METHOD

https://gitingest.com/bmad-code-org/BMAD-METHOD

BMAD-METHOD™ foi criado justamente para ser útil também para profissionais não técnicos, como médicos, advogados, professores ou empreendedores. A ideia é que você não precise entender programação — basta saber o que quer construir ou resolver, e o sistema te guia com “agentes” que pensam e trabalham junto com você.

Vamos ver como isso funcionaria de forma simples:

1. Para um médico⌗

Imagine que você é médico e quer criar um sistema para acompanhar pacientes crônicos. Você não entende de tecnologia, mas sabe o que precisa. O BMAD faz o resto, com os agentes cuidando das partes técnicas.

Como seria na prática:⌗

Você diz: “Quero um aplicativo para meus pacientes diabéticos registrarem glicemia e receberem alertas.”
O Analista (IA) transforma isso num plano de requisitos — o que o app precisa ter.
O Arquiteto (IA) define como o sistema deve funcionar (exemplo: app simples no celular conectado ao Google Sheets).
O Dev (IA) cria o código do app automaticamente.
O QA (IA) testa para garantir que está tudo certo.
Você apenas revisa e ajusta o que for necessário.

Além disso, com os pacotes de expansão, você pode:

Criar modelos de prontuário inteligente,
Gerar protocolos médicos automatizados,
Produzir materiais educativos com linguagem simples para pacientes.

2. Para um advogado⌗

Imagine que você é advogado e quer automatizar modelos de contratos ou criar um sistema de acompanhamento de prazos processuais.

O BMAD ajudaria assim:⌗

Você fala: “Quero um sistema que gere contratos personalizados para meus clientes e me lembre dos prazos.”
O Analista (IA) faz perguntas sobre os tipos de contrato, cláusulas, prazos e estilo jurídico.
O Arquiteto (IA) define como o sistema será estruturado (por exemplo, em planilha, site ou automação).
O Dev (IA) cria o código que gera os contratos automaticamente.
O QA (IA) verifica se os documentos e cálculos de prazo estão certos.

Você não escreve código — apenas conversa e orienta os agentes sobre o que precisa.

3. Por que é simples para quem não é técnico⌗

O BMAD transforma ideias em sistemas completos usando linguagem natural. Você fala, e os agentes interpretam, planejam e constroem.

Você não precisa entender de tecnologia, só do seu trabalho.
O sistema usa IA para entender o contexto e traduzir em ações práticas.
Ele cria documentos, fluxos, textos e códigos conforme a área.

4. Em resumo⌗

Sim, é útil e simples para médicos, advogados e qualquer profissional.
Você conversa com a IA como se fosse com uma equipe real.
O sistema cria, organiza e entrega o resultado pronto para uso.
Ele traduz o que você quer em tecnologia — sem precisar programar.

Vamos explicar o BMAD-METHOD™ de forma simples, como se fosse para alguém sem conhecimento técnico.

1. O que é o BMAD-METHOD™⌗

É como um time de especialistas de IA que trabalha junto com você em qualquer tipo de projeto — pode ser criar um site, escrever um livro, fazer um jogo, montar um plano de negócio ou até organizar uma empresa.

Você conversa com esses "agentes" (cada um com uma função diferente), e eles se comunicam entre si para planejar, criar e revisar o que for necessário.

2. Como ele funciona na prática⌗

Imagine que você quer criar um aplicativo. No BMAD, você não faz tudo sozinho. Você conversa com vários “personagens” de IA, e cada um tem um papel específico, como num time de trabalho real.

Os principais agentes são:⌗

Analista: entende o que você quer e transforma em requisitos. Exemplo: você diz “quero um app para registrar treinos”, e ele pergunta detalhes e cria um documento com o que o app precisa ter.
Arquiteto: define a estrutura e as tecnologias ideais. Exemplo: escolhe se o app será web, mobile, que banco de dados usar, etc.
Scrum Master (SM): organiza o trabalho, cria tarefas e garante que tudo siga o plano.
Dev (Desenvolvedor): escreve o código conforme as instruções do arquiteto e do analista.
QA (Qualidade): revisa e testa tudo para ver se está funcionando direito.

Esses agentes conversam entre si automaticamente, passando o contexto do projeto — assim, o desenvolvedor “entende” o que foi decidido pelo analista e o arquiteto sem você precisar repetir nada.

3. O segredo: duas fases principais⌗

O BMAD funciona em duas grandes etapas:

Fase 1 – Planejamento inteligente (Agentic Planning)⌗

Os agentes entendem o que você quer e criam:

um documento de requisitos (PRD) com todos os detalhes do projeto,
um plano técnico (Arquitetura) com a estrutura ideal.

Fase 2 – Desenvolvimento automatizado (Context-Engineered Development)⌗

Com esses documentos prontos, os outros agentes (como Dev e QA) já sabem exatamente o que fazer. Eles criam e testam o projeto sem perder informações, porque tudo está interligado.

4. Exemplo bem simples⌗

Você digita algo como:

“Quero um site para vender bolos caseiros.”

O BMAD responde assim:

O Analista pergunta sobre sabores, público e formas de pagamento.
O Arquiteto cria o esboço do site e define o tipo de sistema (por exemplo, React + Firebase).
O Dev gera o código do site com base nesses documentos.
O QA testa se os botões funcionam e se o carrinho de compras calcula direito.
O Scrum Master organiza a entrega e documenta tudo.

Você acompanha, revisa e aprova as partes conforme quiser.

5. Instalação simples⌗

Para começar, basta ter o Node.js instalado no computador e rodar este comando:

npx bmad-method install

Isso instala o sistema e os agentes. Depois, você pode conversar com eles direto no navegador ou dentro do seu editor de código (como VS Code, Claude Code ou Gemini CLI).

6. Em resumo⌗

É um sistema que transforma a IA em um time de trabalho completo.
Cada “agente” faz uma parte, e todos se comunicam entre si.
Serve para qualquer área, não só para programar.
Você pode criar, planejar e revisar projetos inteiros apenas conversando.

Resumo do conteúdo do repositório BMAD-METHOD™:

O projeto BMAD-METHOD™ (Breakthrough Method of Agile AI-Driven Development) é um framework universal para desenvolvimento com agentes de IA, aplicável não apenas em software, mas também em áreas como escrita criativa, negócios, saúde e educação.

Estrutura e Propósito⌗

Núcleo (bmad-core): Contém agentes especializados (Analyst, PM, Architect, Dev, QA, etc.) e suas tarefas, listas de verificação e bases de conhecimento. Esses agentes trabalham juntos para transformar ideias em especificações (PRDs), arquiteturas e histórias detalhadas, eliminando perda de contexto e inconsistência no planejamento.
Expansão (expansion-packs): Pacotes opcionais para domínios específicos, como:
Game Dev (Phaser, Unity, Godot)
Creative Writing (com agentes como editor, narrador, designer de capa)
DevOps e Infraestrutura
Common e Tools: Contêm utilitários, templates e o instalador universal via npx bmad-method install.

Principais Inovações⌗

Agentic Planning: Planejamento feito por agentes especialistas que constroem PRDs e arquiteturas consistentes via engenharia de prompts e revisão humana.
Context-Engineered Development: Os agentes Scrum Master, Dev e QA usam histórias enriquecidas com todo o contexto técnico e estratégico necessário.

Essas fases visam eliminar falhas comuns de IA em projetos: perda de contexto e planejamento inconsistente.

Recursos e Instalação⌗

Instalação rápida:

npx bmad-method install

git clone https://github.com/bmad-code-org/BMAD-METHOD.git npm run install:bmad

Compatível com IDEs: Claude Code, Gemini CLI, GitHub Copilot, Trae, KiloCode e Qwen-Code.
Requisitos: Node.js 20+

Versões e Atualizações⌗

Versão estável: v4.x
v5: pulada (substituída pela v6)
v6-alpha: reescrita completa em teste público (lançamento beta previsto para outubro de 2025).

Atualizações constantes entre v4.20 e v4.36 incluem:

Melhorias no instalador (compatibilidade ESM, redução de erros, novas integrações IDE);
Ampliação das funções dos agentes QA e Dev;
Documentação aprimorada com diagramas e explicações do fluxo ágil de agentes;
Expansão dos pacotes criativos e de jogos;
Suporte a bundlers web e comandos slash para Claude Code.

Documentação Essencial⌗

docs/user-guide.md: Guia completo de uso.
docs/core-architecture.md: Detalhamento técnico do sistema.
docs/expansion-packs.md: Como criar pacotes personalizados.

Comunidade e Licença⌗

Comunidade ativa no Discord
Canal no YouTube: BMadCode
Licença MIT

Em resumo⌗

O BMAD-METHOD™ é um ecossistema modular que combina IA agente, metodologia ágil e engenharia de contexto para criar times de IA colaborativos capazes de planejar, desenvolver e revisar projetos complexos de forma autônoma e consistente, com suporte a múltiplas IDEs e aplicações além do código.

BMad Dicas

https://chatgpt.com/c/68e8982f-52b8-832b-96f9-b721642022ad