BIX Tech
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.

● 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 · 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 1  roda testes   ✗ 4 falhando
● Turno 3  corrige datas ✗ 1 falhando
● Turno 5  corrige arredondamento
  ✓ 38 testes passando · ✓ lint limpo
● Avaliador  condição atingida, encerrando

> /goal
  condição: os testes de src/relatorios passam...
  status:   atingida em 5 turnos
  uso:      tokens e tempo da execução
  1. 1Você escreve a condiçãoAlgo que um comando confirma, e o que não pode mudar.
  2. 2Você põe o limiteO máximo de turnos vai na própria condição.
  3. 3Ele itera sozinhoVocê não manda “continua”.
  4. 4Um avaliador decideOutro modelo lê a conversa e julga se a condição foi atingida.
  5. 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-agentes

npx 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
  1. Branch de pilotoBranch de piloto
    Tudo numa branch separada.Tudo numa branch separada.
  2. 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.
  3. 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.
  4. 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
BIX Tech

Obrigado.Obrigado.

Perguntas?Perguntas?

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

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

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

ÍNDICEINDEX