Documentação de como o BMad Method foi instalado e configurado no…
INEMA
Resumo da Configuração do BMad
Aqui está como o BMad foi configurado no seu projeto FEA:
- Instalação Base
- Versão: 4.44.1
- Data de instalação: 19/10/2025
- Tipo: Instalação completa (full)
- IDE configurado: Claude Code
- Total de arquivos: 74 arquivos
- Instalação via npm
"devDependencies": { "bmad-method": "^4.44.1" }
- Estrutura de Diretórios Criada
.bmad-core/ - Contém toda a framework do BMad: - agents/ - Agentes especializados (analyst, architect, dev, qa, po, pm, sm, ux-expert, bmad-master, bmad-orchestrator) - tasks/ - Tarefas específicas (create-doc, create-next-story, qa-gate, review-story, etc.) - templates/ - Templates YAML para documentos (PRD, arquitetura, stories, etc.) - workflows/ - Workflows pré-definidos (greenfield/brownfield para fullstack, service, ui) - agent-teams/ - Configurações de times (team-all, team-fullstack, team-no-ui, team-ide-minimal) - checklists/ - Checklists de validação - data/ - Base de conhecimento e frameworks - utils/ - Utilitários e documentação
.claude/commands/ - Comandos slash criados: - /analyst - Business Analyst - /architect - Software Architect - /dev - Developer - /qa - QA Engineer - /po - Product Owner - /pm - Project Manager - /sm - Scrum Master - /ux-expert - UX Expert
- Como Funciona
Cada comando slash (ex: /analyst) ativa um agente específico que: - Lê sua definição completa de .bmad-core/agents/[nome].md - Possui especializações e responsabilidades definidas - Tem acesso a tasks, templates e workflows relacionados
- Comandos CLI Disponíveis
npx bmad-method install # Instalar/adicionar componentes npx bmad-method update # Atualizar instalação npx bmad-method status # Ver status da instalação npx bmad-method list:expansions # Listar expansion packs npx bmad-method flatten # Exportar codebase para XML
O BMad está pronto para uso com uma equipe completa de agentes especializados para desenvolvimento de software!
configura para o IDE ( que é a plataforma do claude code ou do codex ) reconhercer os comandos
npx bmad-method install -f -i codex
npx bmad-method install -f -i claude-code
teve algumas mudancas na versao do BMAD 4.44.1 e vou atulizar
inematds.github.io/BMAD-Academy ↗
github.com/inematds/BMAD-Academy ↗
Se você estiver usando o Codex (CLI da OpenAI), o comportamento é bem parecido — mas com algumas diferenças importantes na forma como ele lê e usa as APIs.
Aqui está o fluxo prático de onde o BMad busca e como ele funciona dentro do Codex:
1. Execução Local (mesmo ambiente do Node.js)⌗
- O Codex CLI também roda comandos locais, como:
npx bmad-method status
npx bmad-method add project "app de exemplo"
* Ele usa o mesmo Node.js local e, portanto, o mesmo .env do projeto.
2. Fonte da API⌗
O Codex vai procurar a chave da API em três locais possíveis, nesta ordem:
- Variáveis do ambiente do sistema (ENV do sistema operacional) Exemplo (Windows):
setx OPENAI_API_KEY "sk-xxxx"
ou (Linux/macOS):
export OPENAI_API_KEY="sk-xxxx"
- Arquivo
.envdo projeto (na pasta raiz)
OPENAI_API_KEY=sk-xxxx
ANTHROPIC_API_KEY=sk-xxxx
- Configuração direta no
bmad-config.json(opcional)
{
"default_model": "gpt-4o",
"agents": {
"dev": "gpt-4o",
"pm": "claude-3.5-sonnet"
}
}
3. Onde o Codex “fala” com a API⌗
-
Todas as chamadas são feitas via HTTPS do seu computador, ou seja:
-
Se usar OpenAI →
https://api.openai.com/v1/... - Se usar Anthropic →
https://api.anthropic.com/v1/... - Se usar Gemini →
https://generativelanguage.googleapis.com/... - O Codex não faz proxy: ele apenas executa o comando que chama o endpoint da LLM diretamente.
4. O que muda em relação ao Claude Code⌗
| Ambiente | Onde executa | Onde lê API | Observação |
|---|---|---|---|
| Claude Code | Terminal integrado na IDE | .env local |
Pode ter suporte a várias LLMs no mesmo workspace |
| Codex CLI | Terminal do sistema (cmd, bash, zsh) | .env ou variáveis do sistema |
Execução pura via Node.js |
| Make/n8n | Fluxos automatizados | Chaves armazenadas no módulo | Execução em nuvem, sem .env local |
5. Conclusão⌗
Se você rodar o BMad dentro do Codex CLI, ele:
- Busca as chaves no
.env(ou variáveis do sistema) - Faz as chamadas diretas às APIs configuradas
- Usa o mesmo fluxo do BMad normal (sem precisar do Claude)
- Pode misturar agentes com diferentes LLMs, conforme o
bmad-config.json
- Abrir o Codex
- Abrir o terminal integrado
- Navegar até o diretório do projeto
- Executar
npx bmad-method status - Executar
npx bmad-method list:agents - Executar
npx bmad-method add project "nome do projeto" - Executar
As analyst, defina os requisitos do projeto - Executar
As pm, crie o plano e escopo do projeto - Executar
As architect, defina a estrutura e componentes - Executar
As ux-expert, desenhe a interface - Executar
As dev, desenvolva o código do projeto - Executar
As qa, valide e teste o resultado - Executar
npx bmad-method save - Executar
npx bmad-method log - Visualizar resultados em
/projects/<nome do projeto>/ -
(Opcional) Executar
/bmad-master autopara modo automático -
Abrir o Claude Code
- Abrir o terminal integrado (aba “Terminal”)
- Navegar até o diretório do projeto
- Executar
npx bmad-method status - Executar
npx bmad-method list:agents - Executar
npx bmad-method add project "nome do projeto" - Executar
As analyst, defina os requisitos do projeto - Executar
As pm, crie o plano e escopo do projeto - Executar
As architect, defina a estrutura e componentes - Executar
As ux-expert, desenhe a interface - Executar
As dev, desenvolva o código do projeto - Executar
As qa, valide e teste o resultado - Executar
npx bmad-method save - Executar
npx bmad-method log - Visualizar resultados em
/projects/<nome do projeto>/ -
(Opcional) Executar
/bmad-master autopara modo automático -
Abrir o terminal ou console da IDE
- Navegar até o diretório do projeto
- Executar
npx bmad-method status - Executar
npx bmad-method list:agents - Executar
npx bmad-method add project "nome do projeto" - Executar
As analyst, defina os requisitos do projeto - Executar
As pm, crie o plano e escopo do projeto - Executar
As architect, defina a estrutura e componentes - Executar
As ux-expert, desenhe a interface - Executar
As dev, desenvolva o código do projeto - Executar
As qa, valide e teste o resultado - Executar
npx bmad-method save - Executar
npx bmad-method log - Verificar saída em
/projects/<nome do projeto>/ - Opcional: Executar
/bmad-master autopara modo automático
Nos casos (terminal e Claude Code, Codex, Cursor), o BMad busca a API da LLM configurada no seu arquivo .env ou bmad-config.json.
Segue o fluxo interno simplificado de onde ele busca:
- Verifica o arquivo
.env
-
Lê variáveis como:
OPENAI_API_KEY=sk-xxxx ANTHROPIC_API_KEY=sk-xxxx GOOGLE_API_KEY=AIza-xxxx* Define a prioridade da LLM padrão (OpenAI, Anthropic, Gemini etc.).
- Verifica o
bmad-config.json
-
Caso exista, esse arquivo sobrescreve a configuração global e pode definir agentes com LLMs diferentes:
{ "default_model": "gpt-4o-mini", "agents": { "pm": "claude-3.5-sonnet", "ux-expert": "gemini-1.5-pro" } }
- Durante a execução no terminal ou no Claude Code:
- O comando
npx bmad-method ...faz chamadas à LLM via API HTTP (exemplo: api.openai.com ou api.anthropic.com). - Se estiver rodando no Claude Code, o terminal integrado executa localmente, mas ainda usa as chaves do
.env.
- Resumo técnico:
- Origem da API →
.envoubmad-config.json - Acesso → via Node.js local (requisição HTTPS)
- Não há diferença entre rodar no Claude Code ou no terminal comum, desde que o
.envesteja corretamente configurado.
BMAD - Como Usar
BMAD como Usar
1