Instale e configure o BMAD Method no Codex: agentes @pm e @architect para criar software com metodologia profissional de produto.
Conceito, agentes, diferencial
npm, npx, requisitos
codex CLI, flags, setup
codex-web, ChatGPT Plus
PRD, arquitetura, dev
fluxo end-to-end, update
BMAD Method é um framework npm que instala agentes especializados no Codex CLI. Em vez de você escrever prompts do zero, você chama @pm, @architect e outros agentes pré-configurados para cada etapa do desenvolvimento de software.
Com BMAD, o Codex deixa de ser um assistente de código e passa a ser uma equipe: product manager, arquiteto, dev, QA. Cada agente sabe exatamente o que perguntar e o que entregar — sem você precisar montar o prompt do zero toda vez.
| Agente | Função | Entrega |
|---|---|---|
| @pm | Product Manager | PRD, user stories, roadmap |
| @architect | Arquiteto de software | Diagrama, stack, API design |
| @dev | Desenvolvedor | Código, testes, refactor |
| @qa | Quality Assurance | Casos de teste, bugs, cobertura |
Instalar o BMAD Method no seu projeto leva menos de 5 minutos. São 4 comandos: inicializar package.json, instalar o pacote, rodar o setup completo e integrar ao Codex.
versão 18 ou superior
vem com Node.js
instalado e logado
# 1. Entre no seu projeto cd meu-projeto # 2. Inicialize o package.json (se não existir) npm init -y # 3. Instale o BMAD como dependência de dev npm install bmad-method --save-dev # 4. Rode o setup completo npx bmad-method install --full
O que --full faz: cria os diretórios .agents/, docs/, copia templates de PRD, instala definições de agentes e configura o SKILL.md base.
Para usar BMAD com o Codex CLI (terminal), você integra via flag -i codex. Isso faz o setup reconhecer e carregar os agentes BMAD dentro do contexto do Codex.
npx bmad-method install --full -i codex
npx bmad-method status
Retorna: versão instalada, agentes ativos, se integração com Codex está ok.
codex "As dev, implement user login module"
O Codex lê o SKILL.md criado pelo BMAD e carrega o contexto dos agentes. "As dev" ativa o papel de desenvolvedor — o agente responde com o estilo e entregáveis corretos para aquele papel.
Além do Codex CLI, você pode usar o BMAD no Codex Web (interface browser do ChatGPT com Codex habilitado). A integração usa a flag -i codex-web e gera arquivos otimizados para upload no ChatGPT.
| Feature | CLI (-i codex) | Web (-i codex-web) |
|---|---|---|
| Execução de código | ✅ direto no terminal | sandbox ChatGPT |
| Upload de arquivos | lê do filesystem | ✅ drag-drop |
| Requirement | API key OpenAI | ChatGPT Plus |
| Melhor para | projeto completo | prototipagem rápida |
npx bmad-method install --full -i codex-web
Isso cria um arquivo bmad-context.md otimizado para colar no Custom Instructions ou System Prompt do ChatGPT.
Os agentes BMAD são ativados com prefixo @nome. Cada um assume um papel profissional completo: @pm cria documentos de produto, @architect define a estrutura técnica, @dev implementa.
@pm Create PRD for a task management app with user auth
Entrega: documento PRD com objetivo, personas, user stories, critérios de aceitação.
@architect Design API structure for the task management PRD
Entrega: stack tech, diagrama de componentes, endpoints REST, esquema de dados.
As dev, implement user login module As qa, write tests for the login module
Um projeto BMAD completo passa pelas etapas: PRD → Arquitetura → Implementação → Testes → Verificação. Cada etapa é feita por um agente especializado, com handoff automático de contexto.
Define objetivo, personas, features, critérios de aceite
Stack, API, banco de dados, infraestrutura
Codex lê PRD + arquitetura e gera o código
Casos de teste baseados nos critérios de aceite do PRD
npx bmad-method update para novas versões dos agentes
npx bmad-method update
Mantém os agentes atualizados sem perder suas customizações locais.