Análise objetiva dos agentes BMAD instalados no repositório e guia…

INEMA

Aqui vai uma análise objetiva dos agentes BMAD presentes no repo e um guia de uso prático.

O Que Está Instalado

• Núcleo BMAD: .bmad-core/
  • Agentes: .bmad-core/agents/bmad-orchestrator.md, .bmad-core/agents/bmad-master.md
  • Config: .bmad-core/core-config.yaml (paths de PRD, arquitetura, histórias, etc.)
  • KB e templates de tarefas/checklists em .bmad-core/{data|tasks|templates|checklists}
• CLI BMAD: bmad-method (já como dependency)
  • Status: npx bmad-method status (mostra versão/instalação)
  • Expansões: npx bmad-method list:expansions
  • Instalação/refresh: npm run bmad:refresh (equivale a npx bmad-method install -f -i codex)

Onde Estão os Agentes

• Orchestrator: .bmad-core/agents/bmad-orchestrator.md
  • Comandos com prefixo * (ex.: help, agent, workflow, task, *checklist)
  • Orquestra outros agentes e fluxos
• Master: .bmad-core/agents/bmad-master.md
  • Executor direto de tasks/templates/checklists (sem persona específica)

Como Usar (no seu chat/IDE com IA)

• Ativar Orchestrator
  • Abra o conteúdo de .bmad-core/agents/bmad-orchestrator.md no chat como system/prompt inicial.
  • Ele instruirá: rode *help e escolha comandos.
• Comandos úteis (no chat, com prefixo *)
  • *help — ver comandos e recursos
  • *agent bmad-master — virar o agente Master (executor direto)
  • *task create-doc — gerar documento a partir de template (o agente lista opções)
  • *execute-checklist pm-checklist.md — rodar checklist
  • *kb-mode — habilitar modo KB e consultar .bmad-core/data/bmad-kb.md
  • *workflow greenfield-fullstack — iniciar workflow (o Orchestrator guia os passos)
• Exemplos práticos
  • PRD inicial: *task create-doc prd-tmpl.yaml (usa caminhos do .bmad-core/core-config.yaml)
  • Arquitetura: *task create-doc fullstack-architecture-tmpl.yaml
  • Documentar projeto: *task document-project.md
  • Shard de docs longos: *task shard-doc docs/prd.md docs/prd/

Como Usar (via CLI)

• Ver status: npx bmad-method status
• Reinstalar/atualizar núcleo: npm run bmad:refresh
• Instalar pacotes de expansão (opcional):
  • Listar: npx bmad-method list:expansions
  • Instalar: npx bmad-method install --full --expansion-packs bmad-infrastructure-devops
• Flatten do código (útil para dar contexto a um agente externo):
  • npx bmad-method flatten -i . -o .ai/flattened-codebase.xml

Fluxos Sugeridos Para Este Projeto

• Documentação guiada
  • agent bmad-orchestrator → help → *task document-project.md (usa core-config e fragmenta docs)
  • Para PRD/Arquitetura: task create-doc prd-tmpl.yaml e task create-doc fullstack-architecture-tmpl.yaml
• Checklists de qualidade
  • *execute-checklist architect-checklist.md ou story-dod-checklist.md
• Elicitação/Brainstorm
  • task advanced-elicitation.md ou task facilitate-brainstorming-session.md
• KB mode (para dúvidas rápidas)
  • *kb-mode e então navegue por tópicos da KB

Dicas e Observações

• Todos os comandos do Orchestrator começam com . Sem o , ele não executa.
• O Orchestrator só carrega arquivos quando você manda executar algo (não pré-carrega).
• O arquivo .bmad-core/core-config.yaml define onde os documentos de PRD/Arquitetura/etc. serão salvos (ajuste se quiser outros caminhos).
• Caso queira usar o BMAD fora do chat (por scripts), o CLI cobre instalação/status/flatten; a execução de tasks e workflows é pensada para agentes em chat/IDE.

Analise do Uso do BMAD

1