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 precisa estar pronto no fim, o que não muda e o que fica fora.O que precisa estar pronto 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 aprovaHumano aprova
Pessoas aprovam o plano, tiram dúvidas e decidem o merge.Pessoas aprovam o plano, tiram dúvidas e decidem o merge.
Verificação e freiosVerificação e freios
Testa e revisa o próprio trabalho, com limites que ele não desliga.Testa e revisa o próprio trabalho, com limites que ele não desliga.
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, duas aprovações humanas.Quatro etapas, duas aprovações humanas.
1
Entender
Ideia vira intenção clara: o critério de pronto.
Analista
→
2
Planejar
Spec ou plano do tamanho da mudança.
PM · Arquiteto
APROVAÇÃO HUMANAAprova o planoe tira as dúvidas
3
Construir e verificar
O agente implementa, testa e revisa o próprio código.
Dev
APROVAÇÃO HUMANARevisa 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 as aprovações. Nada avança sem uma pessoa.
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, CLAUDE.md atualizado. Tirar as dúvidas com cuidado.
Dívida técnica
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 de revisores, pareamento.
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, boilerplate.Bugs isolados, testes, refatoração com testes, documentação, boilerplate.
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 · Como chegar lá03 · Como chegar lá
Dois caminhos para o passo 3.Dois caminhos para o passo 3.
Metodologia ou loop autônomo. Ou os dois.Metodologia ou loop autônomo. Ou os dois.
03 · Visão geral03 · Visão geral
Um time de agentes ou um agente em loop.Um time de agentes ou um agente em loop.
CAMINHO A · METODOLOGIA
BMAD Method
Um time de agentes por papel, guiado por documentos.
Analista, PM, arquiteto e dev, com um guia (/bmad-help)
Spec, PRD e stories no repositório como contrato
Você dispara cada workflow e aprova plano e PR
Comando típico: /bmad-build
CAMINHO B · LOOP AUTÔNOMO
Loops no Claude Code
Um critério de pronto verificável; o agente itera até cumprir.
Objetivo, agir, verificar, decidir, sem você no meio
Freios fora do loop: limites, deny e hooks
Você define o objetivo e revisa o resultado
Comando típico: /goal
Os dois resolvem o passo 3. Não são excludentes: no final vamos ver como combinar.
04 · Caminho A · BMAD04 · Caminho A · BMAD
Um guia, cinco especialistas.Um guia, cinco especialistas.
GUIABMAD Method
Lê o projeto e recomenda o próximo passo e o agente certo: /bmad-help
Analista
Mary
Pesquisa, brainstorm, brief e contexto do projeto.
bmad-agent-analyst
PM
John
PRD, épicos, stories e o check antes do dev.
bmad-agent-pm
Arquiteto
Winston
Decisões de arquitetura que mantêm o sistema coerente.
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
EntenderPlanejarPlanejarPlanejarConstruir
04 · Caminho A · Na prática04 · Caminho A · Na prática
Como é uma sessão de bmad-build.Como é uma sessão de bmad-build.
claude · meu-projeto · ilustrativo
> /bmad-build O login aceita senha vazia. Corrige.● Investigandosrc/auth/, testes e CLAUDE.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.● Plano2 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 revisando3 revisores✓ 2 achados corrigidos · 1 adiado (fora do escopo)
✓ testes passando · commit local feito
1Você pedeUma frase, uma issue ou uma story.
2Ele investigaLê o código antes de perguntar qualquer coisa.
3Você decideResponde só o que o código não responde.
4Você aprova o planoQuando há dúvida ou risco, antes do código.
5Ele implementa e revisaVocê recebe o diff pronto para o PR.
04 · Caminho A · Prós e contras04 · Caminho A · Prós e contras
BMAD: processo pronto, com cerimônia.BMAD: processo pronto, com cerimônia.
Prós
Processo pronto de ponta a ponta, da ideia ao PR
Rastro: spec, plano e stories versionados no git
Aprovações embutidas: pergunta e mostra o plano quando há risco
Revisão em camadas: 3 revisores em contexto isolado
Open source e roda em várias IDEs
Contras
Mais cerimônia: comandos, agentes e documentos para aprender
Autonomia opcional e experimental: bmad-build-auto, BMad Loop em beta
Pesado demais para tarefa pequena, se o time não calibrar
Versão em evolução: v7 com breaking changes
Dependências: Node, Python 3.10+, uv e subagentes
Melhor para features e mudanças com decisão de negócio, onde o plano importa mais que a velocidade.
05 · Caminho B · Loops05 · Caminho B · Loops
Definir, agir, verificar, decidir. E um freio de fora.Definir, agir, verificar, decidir. E um freio de fora.
DEFINIÇÃO HUMANAEscreve o critério de pronto e o limite
APROVAÇÃO HUMANARevisa o resultado e decide o merge
O loop trabalha entre as aprovações. A governança fica do lado de fora, onde o loop não consegue desligá-la.
05 · Caminho B · As ferramentas05 · Caminho B · As ferramentas
Quatro formas de pôr o agente em loop.Quatro formas de pôr o agente em loop.
Skill de verificaçãoSkill de verificação
Obriga o agente a testar antes de dizer “pronto”.Obriga o agente a testar antes de dizer “pronto”.
/goal/goal
Itera até uma condição ser atingida. Outro modelo confere.Itera até uma condição ser atingida. Outro modelo confere.
/loop/loop
Repete um pedido num intervalo, na sua sessão. Ex.: monitorar o CI.Repete um pedido num intervalo, na sua sessão. Ex.: monitorar o CI.
/schedule/schedule
Tarefa agendada na nuvem: roda com o notebook fechado.Tarefa agendada na nuvem: roda com o notebook fechado.
Freios mínimos: deny, branch isolada e um limite rígido com claude -p ... --max-turns.Freios mínimos: deny, branch isolada e um limite rígido com claude -p ... --max-turns.
05 · Caminho B · Na prática05 · Caminho B · Na prática
Com /goal, você escreve o fim, não os passos.Com /goal, você escreve o fim, não os passos.
claude · meu-projeto · ilustrativo
> /goal os testes de src/relatorio_turno passam e o lint
está limpo, sem apagar teste. Máximo de 15 turnos.● Turno 1roda testes✗ 4 falhando● Turno 3corrige datas✗ 1 falhando● Turno 5corrige arredondamento✓ 38 testes passando · ✓ lint limpo
● Avaliadorcondição atingida, encerrando> /goalcondição: os testes de src/relatorio_turno passam...
status:atingida em 5 turnosuso: tokens e tempo da execução
1Você escreve a condiçãoVerificável por comando, mais o que não pode mudar.
2Você põe o limiteNa condição, e um rígido com --max-turns.
3Ele itera sozinhoVocê não manda “continua”.
4Um avaliador decideOutro modelo lê a conversa e julga se a condição foi atingida.
5Você revisa o diffA revisão do PR não muda.
05 · Caminho B · Prós e contras05 · Caminho B · Prós e contras
Loops: velocidade sem você no meio, com freios por sua conta.Loops: velocidade sem você no meio, com freios por sua conta.
Prós
Você sai do meio: o agente itera sem esperar sua resposta
Ótimo quando o pronto é verificável: testes, lint, CI
Pouca configuração: comandos nativos do Claude Code
Em paralelo, uma sessão e uma branch por tarefa
Aprende se o CLAUDE.md for mantido
Contras
Exige critério de pronto: sem ele, roda até o limite
Custo e loop sem fim se faltar freio
Governança por sua conta; sozinho só em auto mode
O limite do /goal é julgado por um modelo; rígido só no modo headless
Sem spec nem plano por padrão: o rastro é o log
Melhor para trabalho com fim claro e repetitivo, onde o critério de pronto cabe num comando.
06 · Lado a lado06 · Lado a lado
BMAD × loops, ponto a ponto.BMAD × loops, ponto a ponto.
A · BMAD
B · Loops
Ponto de partida
Uma ideia, issue ou story
Um critério de pronto verificável
Humano entra
Dúvidas, plano (se houver risco) e PR
No objetivo e no PR
Melhor para
Features, regra de negócio, projetos
Testes, CI, lint, tarefas repetitivas
Rastro
Spec, plano e stories no git
Commits e log do /goal; spec só se pedir
Governança
Embutida; modo autônomo com limites (beta)
Montada por você: deny, hooks, limites
Curva de aprendizado
Média: agentes e comandos novos
Baixa para usar, alta para usar bem
Risco principal
Aprovar plano sem ler
Loop sem freio ou com objetivo ruim
06 · Quando usar06 · Quando usar
A pergunta certa: dá para escrever o critério de pronto?A pergunta certa: dá para escrever o critério de pronto?
Sim, num comandoSim, num comando
Testes falhando, lint, CI, dependências. Loop com /goal e freios.Testes falhando, lint, CI, dependências. Loop com /goal e freios.
Não, precisa decidirNão, precisa decidir
Feature, regra de negócio, integração. BMAD: spec, plano, aprovação.Feature, regra de negócio, integração. BMAD: spec, plano, aprovação.
É grande e dá para fatiarÉ grande e dá para fatiar
Épico com várias stories. Os dois: BMAD planeja, loop executa.Épico com várias stories. Os dois: BMAD planeja, loop executa.
Na dúvida, comece pelo BMAD. Loop sem critério de pronto é só um jeito mais caro de errar.Na dúvida, comece pelo BMAD. Loop sem critério de pronto é só um jeito mais caro de errar.
06 · O melhor dos dois06 · O melhor dos dois
BMAD planeja, o loop executa.BMAD planeja, o loop executa.
BMAD
Planejar
bmad-spec escreve a spec e quebra em stories.
→
HUMANO
Aprovar
O time lê e aprova a spec e as stories.
→
LOOP
Executar cada story
Sessão nova por story. /goal com o que virou teste, skill de verificação e --max-turns.
→
HUMANO
Revisar o PR
E o aprendizado vira regra no CLAUDE.md.
O BMAD dá o plano e o rastro. O loop dá a execução sem você no meio. O que der para virar teste vira a condição; o resto fica na revisão.
07 · Hands-on07 · Hands-on
Mão na massa.Mão na massa.
Os dois caminhos, no mesmo repositório de exercício.Os dois caminhos, no mesmo repositório de exercício.
07 · Etapa 0 · Antes de começar07 · Etapa 0 · Antes de começar
Checagem de dois minutos.Checagem de dois minutos.
terminal
claude --version # Claude Code instalado e logado na conta aprovadanode -v # 20.12 ou maiorpython --version # 3.10 ou maioruv --versiongit --version # no Windows: Git for Windows (Git Bash)git clone <repo-de-exercicio> && cd <repo-de-exercicio>
Claude CodeClaude Code Instalado e logado com a conta liberada pela Arcelor.Instalado e logado com a conta liberada pela Arcelor.
Para o BMADPara o BMAD Node, Python e uv. Proxy corporativo costuma travar o npx.Node, Python e uv. Proxy corporativo costuma travar o npx.
GitGit No Windows, o Git Bash evita surpresa com scripts.No Windows, o Git Bash evita surpresa com scripts.
Repo de exercícioRepo de exercício Dois bugs plantados, cada um com teste falhando.Dois bugs plantados, cada um com teste falhando.
07 · Etapa 1 · Preparar07 · Etapa 1 · Preparar
Preparando os dois caminhos.Preparando os dois caminhos.
terminal
git checkout -b piloto-agentesnpx bmad-method@6.12.4 install --yes --modules bmm --tools claude-code# .claude/settings.json (deny é rede, não muro){ "permissions": { "deny": [ "Bash(git push:*)", "Bash(rm -rf:*)", "Read(./.env)" ] } }# .claude/skills/verificar/SKILL.md---description: Use antes de dizer que uma tarefa terminou.---Rode os testes e o lint. Se falhar, corrija e repita.Nunca apague teste. Cole a saída como evidência.
Branch de pilotoBranch de piloto Tudo numa branch separada.Tudo numa branch separada.
Caminho A: BMADCaminho A: BMAD Versão fixada. Requer Node 20.12+, Python 3.10+ e uv.Versão fixada. Requer Node 20.12+, Python 3.10+ e uv.
Caminho B: freiosCaminho B: freios Deny pega o comando literal: rm -fr escapa. Some branch e hook.Deny pega o comando literal: rm -fr escapa. Some branch e hook.
Caminho B: verificaçãoCaminho B: verificação Skill que não aceita “pronto” sem a saída dos testes.Skill que não aceita “pronto” sem a saída dos testes.
07 · Exercício · 45 min + 15 de conversa07 · Exercício · 45 min + 15 de conversa
Sua vez: a mesma tarefa, dos dois jeitos.Sua vez: a mesma tarefa, dos dois jeitos.
1
Em dupla, no repo de exercícioEm dupla, no repo de exercício
Dois bugs do mesmo tamanho, cada um com um teste falhando.Dois bugs do mesmo tamanho, cada um com um teste falhando.
2
Pessoa A: /bmad-buildPessoa A: /bmad-build
Tire as dúvidas, aprove o plano, revise o diff.Tire as dúvidas, aprove o plano, revise o diff.
3
Pessoa B: /goalPessoa B: /goal
Sessão nova, critério de pronto por comando, o que não pode mudar, 15 turnos.Sessão nova, critério de pronto por comando, o que não pode mudar, 15 turnos.
4
CompareCompare
Tempo de relógio, quantas vezes interveio, qualidade do diff. Depois troquem.Tempo de relógio, quantas vezes interveio, qualidade do diff. Depois troquem.
08 · Boas práticas08 · Boas práticas
O que vale para os dois caminhos.O que vale para os dois caminhos.
FaçaDo
Uma sessão nova por tarefaUma sessão nova por tarefa
Ler o plano e o diff antes de aprovarLer o plano e o diff antes de aprovar
Critério de pronto escrito antes de começarCritério de pronto escrito antes de começar
Deny, hooks e regras versionados no gitDeny, hooks e regras versionados no git
Escrever a regra de negócio da cabeça de alguémEscrever a regra de negócio da cabeça de alguém
EviteAvoid
Aprovar plano ou diff sem lerAprovar plano ou diff sem ler
Loop sem limite ou sem critério de prontoLoop sem limite ou sem critério de pronto
Usar o caminho pesado para tarefa trivialUsar o caminho pesado para tarefa trivial
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
08 · Próximos passos08 · Próximos passos
Piloto nas próximas duas semanas.Piloto nas próximas duas semanas.
0/6
Obrigado.Obrigado.
Perguntas?Perguntas?
Material completo:Full material: bix-agentes-arcelor.pages.dev
BIX Tech · bix-tech.comBIX Tech · bix-tech.com
ArcelorMittal × BIX · Agentes: dois caminhosArcelorMittal × BIX · Agentes: dois caminhos
←/→ navegar · F tela cheia · G índice←/→ navigate · F fullscreen · G index