Treinamento hands-on · Desenvolvimento com agentesTreinamento hands-on · Desenvolvimento com agentes
Agentes na prática: dois caminhos.Agentes na prática: dois caminhos.
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 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 decidem plano, dúvidas e merge. O agente executa o resto.Pessoas decidem plano, dúvidas e merge. O agente executa o resto.
Verificação e freiosVerificação e freios
O agente se testa e se revisa; limites que ele não desliga.O agente se testa e se revisa; 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
Clarificar
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 responde as dúvidas
3
Construir e verificar
O agente implementa, testa e se revisa.
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, 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 · Como chegar lá03 · Como chegar lá
Dois caminhos para o passo 3.Dois caminhos para o passo 3.
Metodologia ou orquestração. Ou os dois.Metodologia ou orquestração. 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 orquestrador
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 · ORQUESTRAÇÃO
Loops no Claude Code
Um objetivo verificável, e 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 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
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
> /bmad-build O login aceita senha vazia. Corrige.● Investigandosrc/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.● 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 planoAntes de qualquer linha de código.
5Ele implementa e se 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 completo, da ideia ao PR, já pronto
Rastro: spec, plano e stories versionados no git
Aprovações embutidas: pergunta, mostra o plano, espera o OK
Revisão em camadas com revisores independentes
Open source e roda em várias IDEs
Contras
Mais cerimônia: comandos, agentes e documentos para aprender
Ainda manual entre etapas: alguém dispara cada workflow
Exagero para tarefas pequenas, se o time não calibrar
Versão em evolução: v7 com mudanças incompatíveis
Sessões interativas: não roda sozinho fora do horário
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
Objetivo, agir, verificar, decidir. E alguém de fora.Objetivo, agir, verificar, decidir. E alguém de fora.
APROVAÇÃO HUMANAEscreve o objetivo e o limite
GOVERNANÇA · FORA DO LOOP · TEM PODER DE PARAR
1
Objetivo
O critério de pronto.
→
2
Agir
Lê, edita, roda comandos.
→
3
Verificar
Testes, lint, checagem.
→
4
Decidir
Atingiu? Para. Senão, volta.
não atingiu: tenta de novo
limite de turnospermissõeshookslimite de custoexpiração
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 obrigatórios: deny no settings.json, hooks que bloqueiam e um limite em todo loop.Freios obrigatórios: deny no settings.json, hooks que bloqueiam e um limite em todo loop.
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
> /goal os testes de src/relatorios 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/relatorios passam...
status:atingida em 5 turnosuso: tokens e tempo da execução
1Você escreve a condiçãoAlgo que um comando confirma, e o que não pode mudar.
2Você põe o limiteO máximo de turnos vai na própria condição.
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 mensagem
Ótimo com fim verificável: testes, lint, CI, migração mecânica
Pouca configuração: comandos nativos do Claude Code
Em paralelo e até fora do horário, com /loop e /schedule
Aprende se a memória for cuidada (CLAUDE.md, dreaming)
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: deny, hooks, limites
O limite do /goal é julgado por um modelo, não garantido
Pouco rastro de decisão: não gera spec nem plano
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
Em cada etapa: dúvidas, plano, 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 o log da sessão
Governança
Aprovações embutidas no fluxo
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 repetívelÉ grande e repetível
É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
/goal com os critérios de aceite da story, skill de verificação e limite.
→
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. Os critérios de aceite da story viram a condição do /goal.
07 · Hands-on07 · Hands-on
Mão na massa.Mão na massa.
Os dois caminhos, na mesma base de código.Os dois caminhos, na mesma base de código.
07 · Etapa 1 · Preparar07 · Etapa 1 · Preparar
Os dois caminhos, instalados em cinco minutos.Os dois caminhos, instalados em cinco minutos.
terminal
git checkout -b piloto-agentesnpx bmad-method install --yes --modules bmm --tools claude-code# .claude/settings.json{ "permissions": { "deny": [ "Bash(git push:*)", "Bash(rm -rf:*)", "Read(./.env)" ] } }# .claude/skills/verificar/SKILL.md# rode os testes; se falhar, corrija e repita; cole a saída
Branch de pilotoBranch de piloto Tudo numa branch separada.Tudo numa branch separada.
Caminho A: BMADCaminho A: BMAD Instala as skills do BMAD para o Claude Code. Requer Node 20.12+ e uv.Instala as skills do BMAD para o Claude Code. Requer Node 20.12+ e uv.
Caminho B: freiosCaminho B: freios Bloqueios (deny) que valem até se alguém aprovar tudo na sessão.Bloqueios (deny) que valem até se alguém aprovar tudo na sessão.
Caminho B: verificaçãoCaminho B: verificação Uma skill curta que não aceita “pronto” sem a saída dos testes.Uma skill curta que não aceita “pronto” sem a saída dos testes.
07 · Exercício · 40 min07 · Exercício · 40 min
Sua vez: a mesma tarefa, dos dois jeitos.Sua vez: a mesma tarefa, dos dois jeitos.
1
Escolha duas tarefas parecidasEscolha duas tarefas parecidas
Dois bugs ou dois testes falhando, do mesmo tamanho.Dois bugs ou dois testes falhando, do mesmo tamanho.
2
Tarefa 1 com /bmad-buildTarefa 1 com /bmad-build
Responda as dúvidas, aprove o plano, revise o diff.Responda as dúvidas, aprove o plano, revise o diff.
3
Tarefa 2 com /goalTarefa 2 com /goal
Critério de pronto por comando, o que não pode mudar, máximo de 15 turnos.Critério de pronto por comando, o que não pode mudar, máximo de 15 turnos.
4
CompareCompare
Tempo até o PR, quantas vezes você interveio, qualidade do diff, custo (/usage).Tempo até o PR, quantas vezes você interveio, qualidade do diff, custo (/usage).
08 · Boas práticas08 · Boas práticas
O que vale para os dois caminhos.O que vale para os dois caminhos.
FaçaDo
Um chat novo por tarefaUm chat novo 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 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
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