BIX Tech
Treinamento hands-on · BMAD MethodTreinamento hands-on · BMAD Method

Desenvolvimento orientado a agentes, na prática.Desenvolvimento orientado a agentes, na prática.

ArcelorMittal × BIX Tech · novembro de 2026ArcelorMittal × BIX Tech · novembro de 2026

BIX TechBIX Tech

01 · Onde estamos01 · Onde estamos

Do passo 2 ao 3: muda o processo, não a ferramenta.Do passo 2 ao 3: muda o processo, não a ferramenta.

PASSO 2 · HOJE
PASSO 3 · COM AGENTES
Quem executa
A pessoa, com a IA sugerindo
→
O agente, a partir de um pedido claro
Contexto
O que coube no prompt
→
Código, spec e regras do time no repositório
Onde o humano entra
Em tudo, linha a linha
→
Nas decisões: plano, dúvidas e PR
Revisão
Depende de quem revisa
→
Revisores do agente e depois o humano
Rastro
Some com o chat
→
Spec, plano e commits versionados
02 · A metodologia02 · A metodologia

Seis princípios do desenvolvimento com agentes.Seis princípios do desenvolvimento com agentes.

Intenção antes do códigoIntenção antes do código

O que deve ser verdade no fim, o que não muda e o que fica fora.O que deve ser verdade no fim, o que não muda e o que fica fora.

Contexto no repositórioContexto no repositório

Spec, regras e convenções versionadas. Não na memória do chat.Spec, regras e convenções versionadas. Não na memória do chat.

Papéis especializadosPapéis especializados

Um agente para analisar, outro para planejar, outro para construir.Um agente para analisar, outro para planejar, outro para construir.

Humano nos portõesHumano nos portões

Pessoas decidem plano, dúvidas e merge. O agente executa o resto.Pessoas decidem plano, dúvidas e merge. O agente executa o resto.

Revisão em camadasRevisão em camadas

O agente se revisa com revisores independentes; depois, o humano.O agente se revisa com revisores independentes; depois, o humano.

Planejar no tamanho certoPlanejar no tamanho certo

Bug não precisa de PRD. Projeto não cabe num prompt.Bug não precisa de PRD. Projeto não cabe num prompt.

02 · O ciclo02 · O ciclo

Quatro etapas, dois portões humanos.Quatro etapas, dois portões humanos.

1

Clarificar

Ideia vira intenção clara: o que deve ser verdade no fim.

Analista
→
2

Planejar

Spec ou plano do tamanho da mudança.

PM · Arquiteto
PORTÃO HUMANOAprova o planoe responde as dúvidas
3

Construir e verificar

O agente implementa, testa e se revisa.

Dev
PORTÃO HUMANORevisa o PRe decide o merge
4

Aprender e ajustar

O que deu errado vira regra no repositório.

Retrospectiva
o aprendizado volta para o próximo plano
O agente trabalha entre os portões. Nada passa de um portão sem uma pessoa.
02 · Capacidades02 · Capacidades

O que os agentes já fazem bem hoje.O que os agentes já fazem bem hoje.

Ler código existenteLer código existente

Investigam o repositório e seguem os padrões que encontram.Investigam o repositório e seguem os padrões que encontram.

Implementar de ponta a pontaImplementar de ponta a ponta

Uma mudança completa em vários arquivos, com testes.Uma mudança completa em vários arquivos, com testes.

TestarTestar

Escrevem e rodam testes unitários, de API e end-to-end.Escrevem e rodam testes unitários, de API e end-to-end.

Revisar códigoRevisar código

Vários revisores em paralelo: casos de borda, lacunas de teste, aderência à spec.Vários revisores em paralelo: casos de borda, lacunas de teste, aderência à spec.

PlanejarPlanejar

Transformam requisitos em spec, épicos e stories com critérios de aceite.Transformam requisitos em spec, épicos e stories com critérios de aceite.

Pesquisar e documentarPesquisar e documentar

Comparam opções técnicas e escrevem o contexto do projeto.Comparam opções técnicas e escrevem o contexto do projeto.

Limite: o agente não sabe o que não está escrito. Regra de negócio implícita é a principal fonte de erro.Limite: o agente não sabe o que não está escrito. Regra de negócio implícita é a principal fonte de erro.
02 · Vantagens02 · Vantagens

O que o time ganha.O que o time ganha.

Velocidade com controleVelocidade com controle

O agente faz o trabalho braçal; o time gasta tempo nas decisões.O agente faz o trabalho braçal; o time gasta tempo nas decisões.

Qualidade constanteQualidade constante

Toda mudança passa por plano, testes e revisão, não só quando sobra tempo.Toda mudança passa por plano, testes e revisão, não só quando sobra tempo.

Conhecimento que ficaConhecimento que fica

Specs, decisões e regras ficam no repositório, não saem com as pessoas.Specs, decisões e regras ficam no repositório, não saem com as pessoas.

Escala sem incharEscala sem inchar

O mesmo squad atende mais demanda, sem perder rastreabilidade.O mesmo squad atende mais demanda, sem perder rastreabilidade.

O ganho vem do processo. Ferramenta sem processo é só um chat mais caro.O ganho vem do processo. Ferramenta sem processo é só um chat mais caro.
02 · Riscos02 · Riscos

Os riscos e como mitigar.Os riscos e como mitigar.

Risco
O que acontece
Como mitigar
Confiança excessiva
Código plausível, mas errado, passa porque “a IA fez”.
Ler o plano e o diff. Testes obrigatórios. PR com revisão humana.
Dados sensíveis
Segredo ou dado de produção vai parar no prompt.
Só ferramentas e contas aprovadas. Nada de dado real. Regras no repositório.
Contexto ruim
O agente inventa uma regra de negócio ou um padrão.
Pedido claro, spec curta, AGENTS.md atualizado. Responder as dúvidas com cuidado.
Dívida acumulada
Cada sessão adiciona um pouco e ninguém vê o todo.
Retrospectiva por épico. Decisões de arquitetura escritas.
Time desaprende
Quem só aprova perde a noção do próprio código.
Walkthrough das mudanças, rodízio, revisão em par.
Ferramenta em evolução
Versões mudam rápido e às vezes quebram o fluxo.
Fixar a versão estável. Piloto antes de escalar.
02 · Onde prestar atenção02 · Onde prestar atenção

Nem tudo se delega do mesmo jeito.Nem tudo se delega do mesmo jeito.

DELEGUEDELEGUE

Agente faz, time confereAgente faz, time confere

Bugs isolados, testes, refatoração com testes, documentação, código repetitivo.Bugs isolados, testes, refatoração com testes, documentação, código repetitivo.

DELEGUE COM CUIDADODELEGUE COM CUIDADO

Revisão forteRevisão forte

Regra de negócio, integrações, migração de dados, telas novas.Regra de negócio, integrações, migração de dados, telas novas.

HUMANO DECIDEHUMANO DECIDE

Agente só apoiaAgente só apoia

Arquitetura, segurança e acessos, regras regulatórias, deploy em produção.Arquitetura, segurança e acessos, regras regulatórias, deploy em produção.

03 · O exemplo03 · O exemplo

BMAD: a metodologia
pronta para usar.BMAD: a metodologia
pronta para usar.

Open source, roda na IDE que o time já usa.Open source, roda na IDE que o time já usa.

03 · BMAD Method03 · BMAD Method

Os seis princípios, já empacotados.Os seis princípios, já empacotados.

Na sua IDENa sua IDE

Skills como bmad-build no Claude Code, Cursor, Codex e outros.Skills como bmad-build no Claude Code, Cursor, Codex e outros.

Agentes por papelAgentes por papel

Analista, PM, arquiteto, UX e dev, com um orquestrador.Analista, PM, arquiteto, UX e dev, com um orquestrador.

Docs como contratoDocs como contrato

Spec, PRD e stories no repositório.Spec, PRD e stories no repositório.

Portões embutidosPortões embutidos

Pergunta, mostra o plano, se revisa e espera o seu OK.Pergunta, mostra o plano, se revisa e espera o seu OK.

Open source, versão estável 6.12. Site: docs.bmad-method.org.Open source, versão estável 6.12. Site: docs.bmad-method.org.
03 · O time de agentes03 · O time de agentes

Um orquestrador, cinco especialistas.Um orquestrador, cinco especialistas.

ORQUESTRADORBMAD Method

Lê o projeto, decide o próximo passo e chama o agente certo. Na dúvida: /bmad-help

Analista

Mary

Pesquisa, brainstorm, brief e contexto do projeto.

bmad-agent-analyst
PM

John

PRD, épicos e stories, prontidão para construir.

bmad-agent-pm
Arquiteto

Winston

Decisões que mantêm as partes consistentes.

bmad-agent-architect
UX

Sally

Experiência e design de telas.

bmad-agent-ux-designer
Dev

Amelia

Build, testes, code review, sprint e retro.

bmad-agent-dev
ClarificarPlanejarPlanejarPlanejarConstruir
03 · Planejar no tamanho certo03 · Planejar no tamanho certo

Três caminhos, conforme o tamanho da mudança.Três caminhos, conforme o tamanho da mudança.

Pequena · uma sessãoPequena · uma sessão

Bug, ajuste, feature curta (até ~500 linhas). Direto para bmad-build.Bug, ajuste, feature curta (até ~500 linhas). Direto para bmad-build.

Média · um épicoMédia · um épico

bmad-spec escreve a spec e quebra em stories. Um bmad-build por story.bmad-spec escreve a spec e quebra em stories. Um bmad-build por story.

Grande · projetoGrande · projeto

bmad-prd, bmad-architecture, épicos e bmad-sprint-planning antes de construir.bmad-prd, bmad-architecture, épicos e bmad-sprint-planning antes de construir.

Na dúvida, pergunte ao bmad-help: ele olha o repositório e recomenda o caminho.Na dúvida, pergunte ao bmad-help: ele olha o repositório e recomenda o caminho.
04 · Hands-on04 · Hands-on

Mão na
massa.Mão na
massa.

Instalar, fazer a primeira mudança, revisar.Instalar, fazer a primeira mudança, revisar.

04 · Passo 1 · Instalar04 · Passo 1 · Instalar

Dois minutos para instalar.Dois minutos para instalar.

terminal
# pré-requisito: Node.js 20.12+ (e uv para o bmad-build)
cd meu-projeto
git checkout -b piloto-bmad
npx bmad-method install
# ou, sem perguntas, para Claude Code:
npx bmad-method install --yes --modules bmm --tools claude-code
claude
/bmad-help o que eu faço primeiro neste repositório?
  1. Branch de pilotoBranch de piloto
    Comece num repositório real, mas numa branch separada.Comece num repositório real, mas numa branch separada.
  2. Rode o instaladorRode o instalador
    Escolha o módulo BMad Method (bmm) e a sua ferramenta. Ele cria a pasta _bmad e as skills.Escolha o módulo BMad Method (bmm) e a sua ferramenta. Ele cria a pasta _bmad e as skills.
  3. Valide com o bmad-helpValide com o bmad-help
    Se a ferramenta reconhece o comando, está pronto.Se a ferramenta reconhece o comando, está pronto.
04 · Passo 2 · Primeira mudança04 · Passo 2 · Primeira mudança

Como é uma sessão de bmad-build.Como é uma sessão de bmad-build.

claude · meu-projeto
> /bmad-build O login aceita senha vazia. Corrige.

● Investigando src/auth/, testes e AGENTS.md
  Validação ausente em LoginForm.ts e auth.service.ts

● Pergunta
  A API também deve rejeitar (400) ou só a tela?
> As duas.

● Plano  2 arquivos · 1 teste novo · nada irreversível
  1. Validar no formulário   2. Retornar 400 na API
  3. Teste para senha vazia e só espaços
> Aprovado.

● Implementando e revisando 3 revisores
  ✓ 2 achados corrigidos · 1 adiado (fora do escopo)
  ✓ testes passando · commit local feito
  1. 1Você pedeUma frase, uma issue ou uma story.
  2. 2Ele investigaLê o código antes de perguntar qualquer coisa.
  3. 3Você decideResponde só o que o código não responde.
  4. 4Você aprova o planoAntes de qualquer linha de código.
  5. 5Ele implementa e se revisaVocê recebe o diff pronto para o PR.
04 · Exercício · 20 min04 · Exercício · 20 min

Sua vez: uma mudança real, do pedido ao PR.Sua vez: uma mudança real, do pedido ao PR.

1

Escolha algo pequenoEscolha algo pequeno

Um bug ou ajuste do backlog que caiba em uma sessão.Um bug ou ajuste do backlog que caiba em uma sessão.

2

Chat novo + /bmad-buildChat novo + /bmad-build

Descreva a mudança do seu jeito. Responda as perguntas com cuidado.Descreva a mudança do seu jeito. Responda as perguntas com cuidado.

3

Leia e aprove o planoLeia e aprove o plano

Discorde se estiver errado. Peça mudanças antes de implementar.Discorde se estiver errado. Peça mudanças antes de implementar.

4

Revise e abra o PRRevise e abra o PR

Leia o diff e rode o sistema. Travou? /bmad-help.Leia o diff e rode o sistema. Travou? /bmad-help.

05 · Exemplos05 · Exemplos

Seis usos para começar segunda-feira.Seis usos para começar segunda-feira.

Bug a partir da issueBug a partir da issue

/bmad-build com o link da issue. Ele investiga, propõe e corrige./bmad-build com o link da issue. Ele investiga, propõe e corrige.

Testes em código legadoTestes em código legado

bmad-qa-generate-e2e-tests cria a rede de segurança antes de mexer.bmad-qa-generate-e2e-tests cria a rede de segurança antes de mexer.

Refatoração seguraRefatoração segura

Testes primeiro, depois /bmad-build com o que não pode mudar escrito no pedido.Testes primeiro, depois /bmad-build com o que não pode mudar escrito no pedido.

Feature novaFeature nova

bmad-spec para a spec e as stories; um build por story.bmad-spec para a spec e as stories; um build por story.

Documentar um sistemaDocumentar um sistema

bmad-project-context gera o AGENTS.md com as convenções do repositório.bmad-project-context gera o AGENTS.md com as convenções do repositório.

Revisar PR de alguémRevisar PR de alguém

/bmad-code-review com o link do PR e a spec, se houver./bmad-code-review com o link do PR e a spec, se houver.

05 · Agente × time05 · Agente × time

O agente executa. O time decide.O agente executa. O time decide.

AgenteAgente
TimeTime
Spec e planoSpec e planoEscreve, o time aprovaEscreve, o time aprova
✓
!
Perguntas em abertoPerguntas em abertoDecisões que o código não respondeDecisões que o código não responde
!
✓
Código e testesCódigo e testesImplementação da storyImplementação da story
✓
!
RevisãoRevisãoRevisores do agente + leitura humana do diffRevisores do agente + leitura humana do diff
✓
✓
Merge e deployMerge e deployPR, aprovação e produçãoPR, aprovação e produção
✕
✓
✓FazFaz!Apoia ou revisaApoia ou revisa✕Não fazNão faz
05 · Escalar para o time05 · Escalar para o time

Mesmas regras para todo mundo.Mesmas regras para todo mundo.

Contexto do projetoContexto do projeto

bmad-project-context gera um AGENTS.md curto com as convenções do repositório.bmad-project-context gera um AGENTS.md curto com as convenções do repositório.

Regras do time no gitRegras do time no git

Overrides em _bmad/custom/ (ex.: sempre consultar o Jira). Quem faz pull herda.Overrides em _bmad/custom/ (ex.: sempre consultar o Jira). Quem faz pull herda.

Revisão sob medidaRevisão sob medida

Adicione uma camada própria ao code review, como um checklist de segurança.Adicione uma camada própria ao code review, como um checklist de segurança.

bmad-customize escreve esses arquivos para você: descreva a regra em português.bmad-customize escreve esses arquivos para você: descreva a regra em português.
06 · Boas práticas06 · Boas práticas

O que separa o passo 3 de um chat bonito.O que separa o passo 3 de um chat bonito.

FaçaDo

  • Um chat novo por workflowUm chat novo por workflow
  • Ler o plano antes de aprovarLer o plano antes de aprovar
  • Mudanças pequenas, uma por sessãoMudanças pequenas, uma por sessão
  • Versionar _bmad e as specs no gitVersionar _bmad e as specs no git
  • Escrever a regra de negócio que só existe na cabeçaEscrever a regra de negócio que só existe na cabeça

EviteAvoid

  • Aprovar plano ou diff sem lerAprovar plano ou diff sem ler
  • Pedir um épico inteiro num build sóPedir um épico inteiro num build só
  • Reaproveitar o chat de outra tarefaReaproveitar o chat de outra tarefa
  • Pular a revisão humana do PRPular a revisão humana do PR
  • Colar dado sensível ou de produção no promptColar dado sensível ou de produção no prompt
06 · Próximos passos06 · Próximos passos

Piloto nas próximas duas semanas.Piloto nas próximas duas semanas.

0/6
BIX Tech

Obrigado.Obrigado.

Perguntas?Perguntas?

QRMaterial completo:Full material:
bix-bmad-arcelor.pages.dev

BIX Tech · bix-tech.comBIX Tech · bix-tech.com

←/→ navegar · F tela cheia · G índice←/→ navigate · F fullscreen · G index

ÍNDICEINDEX