Treinamento hands-on · Parte 2Treinamento hands-on · Parte 2
Do uso manual à orquestração.Do uso manual à orquestração.
ArcelorMittal × BIX Tech · novembro de 2026ArcelorMittal × BIX Tech · novembro de 2026
BIX TechBIX Tech
01 · Onde estamos01 · Onde estamos
O que muda quando você orquestra.O que muda quando você orquestra.
PASSO 2 · MANUAL (HOJE)
PASSO 3 · ORQUESTRADO
Quem dispara
Você, mensagem a mensagem
→
Um orquestrador, a partir de um objetivo
Quantos agentes
Um chat por vez
→
Vários, cada um com um papel
Quando para
Quando você cansa ou acha que está bom
→
Condição verificável e um limite
Quem verifica
Você, olhando a saída
→
Testes e checagens dentro do loop
Quem pode parar
Você, se estiver olhando
→
Regras fora do loop: limites, permissões, hooks
O que aprende
Nada: o chat some
→
Memória versionada no repositório
01 · Como é hoje01 · Como é hoje
Hoje, você é o loop.Hoje, você é o loop.
1
Você pedeVocê pede
Digita o pedido no chat e espera.Digita o pedido no chat e espera.
2
Você lêVocê lê
Confere a resposta, roda o código, vê o erro.Confere a resposta, roda o código, vê o erro.
3
Você cola o erroVocê cola o erro
“Deu isso aqui, corrige.” E espera de novo.“Deu isso aqui, corrige.” E espera de novo.
4
Você repeteVocê repete
Dez vezes. Você é o motor, o verificador e o único freio.Dez vezes. Você é o motor, o verificador e o único freio.
Funciona, mas não escala: o agente para toda vez que você para.Funciona, mas não escala: o agente para toda vez que você para.
02 · A metodologia02 · A metodologia
Seis princípios para orquestrar agentes.Seis princípios para orquestrar agentes.
Objetivo verificávelObjetivo verificável
O fim é algo que um comando confirma, não “ficou bom”.O fim é algo que um comando confirma, não “ficou bom”.
Um papel por agenteUm papel por agente
Quem faz, quem verifica e quem coordena são separados.Quem faz, quem verifica e quem coordena são separados.
Verificação dentro do loopVerificação dentro do loop
Testes rodam a cada iteração, não só no final.Testes rodam a cada iteração, não só no final.
Freios fora do loopFreios fora do loop
Limites, permissões e hooks que o agente não desliga.Limites, permissões e hooks que o agente não desliga.
Humano aprovaHumano aprova
Pessoas definem o objetivo e aprovam o resultado.Pessoas definem o objetivo e aprovam o resultado.
Memória que aprendeMemória que aprende
O erro de hoje vira regra no repositório.O erro de hoje vira regra no repositório.
02 · O ciclo02 · O ciclo
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
1Objetivo
O critério de pronto.
→
2Agir
Lê, edita, roda comandos.
→
3Verificar
Testes, lint, checagem.
→
4Decidir
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.
02 · Níveis02 · Níveis
Quanto menos você acompanha, mais governança precisa.Quanto menos você acompanha, mais governança precisa.
INNER LOOP · AGORAINNER LOOP · AGORANa sua sessão, em minutosNa sua sessão, em minutos
Skill de verificação e /goal. Você está perto e vê o resultado logo.Skill de verificação e /goal. Você está perto e vê o resultado logo.
OUTER LOOP · NO PILOTOOUTER LOOP · NO PILOTOAgendado, em horasAgendado, em horas
/loop e /schedule em branch. Você só entra no plano e no PR./loop e /schedule em branch. Você só entra no plano e no PR.
FÁBRICA SEM LUZ · PASSO 4FÁBRICA SEM LUZ · PASSO 4Dark factory: sem revisão humanaDark factory: sem revisão humana
Loops que fazem merge e deploy sozinhos. Não é meta deste piloto.Loops que fazem merge e deploy sozinhos. Não é meta deste piloto.
02 · Vantagens02 · Vantagens
O que o time ganha ao orquestrar.O que o time ganha ao orquestrar.
Sai do caminhoSai do caminho
O agente não para quando você vai a uma reunião.O agente não para quando você vai a uma reunião.
Em paraleloEm paralelo
Vários fluxos ao mesmo tempo, cada um em sua branch.Vários fluxos ao mesmo tempo, cada um em sua branch.
Sempre testadoSempre testado
Todo ciclo roda os testes, não só quando sobra tempo.Todo ciclo roda os testes, não só quando sobra tempo.
AprendeAprende
Cada erro corrigido vira regra para o próximo loop.Cada erro corrigido vira regra para o próximo loop.
O ganho vem de montar o fluxo uma vez e reusar, não de digitar mais rápido.O ganho vem de montar o fluxo uma vez e reusar, não de digitar mais rápido.
03 · Desafios03 · Desafios
Funcionar
não é ser seguro.Funcionar
não é ser seguro.
O problema raramente é o loop. É quem pode pará-lo.O problema raramente é o loop. É quem pode pará-lo.
03 · Um caso real03 · Um caso real
240 tentativas, 3 horas, e nada que parasse.240 tentativas, 3 horas, e nada que parasse.
1
Um erro ambíguoUm erro ambíguo
Um agente de código encontra uma mensagem de erro que não entende.Um agente de código encontra uma mensagem de erro que não entende.
2
Ele tenta de novoEle tenta de novo
Faz exatamente o que foi pedido: tentar até dar certo.Faz exatamente o que foi pedido: tentar até dar certo.
3
Três dashboardsTrês dashboards
O custo aparece em tempo real em três telas diferentes.O custo aparece em tempo real em três telas diferentes.
4
US$ 4.200US$ 4.200
240 tentativas depois. Nenhuma tela tinha poder de parar o loop.240 tentativas depois. Nenhuma tela tinha poder de parar o loop.
Caso relatado em linas.substack.com, “AI agent loop governance”.Caso relatado em linas.substack.com, “AI agent loop governance”.
03 · Desafios03 · Desafios
Os desafios e como mitigar.Os desafios e como mitigar.
Desafio
O que acontece
Como mitigar
Loop sem fim
Erro ambíguo, o agente tenta de novo, e de novo.
Limite de turnos ou iterações em todo loop.
Revisão vira gargalo
Dez fluxos geram dez PRs para a mesma pessoa revisar.
Poucos fluxos em paralelo, PR pequeno, revisão em rodízio.
Custo escondido
Cada iteração gasta tokens; ninguém soma até a fatura chegar.
Piloto pequeno, modelo menor no braçal, custo medido por loop.
Objetivo mal escrito
O agente “passa” apagando o teste que falhava.
Condição verificável e o que não pode mudar, escritos no objetivo.
Ação irreversível
Push, deploy ou exclusão no meio da madrugada.
Deny no settings.json e hooks. Loop só em branch.
Agentes em ping-pong
Dois agentes pedem esclarecimento um ao outro sem parar.
Um responsável por loop e um limite de iterações.
Memória ruim
Regra errada ou desatualizada passa a guiar todo loop seguinte.
Memória no git, mudança só por PR, revisão periódica.
03 · Onde prestar atenção03 · Onde prestar atenção
Nem tudo se orquestra do mesmo jeito.Nem tudo se orquestra do mesmo jeito.
Orquestre jáOrquestre já
Testes falhando, lint, CI quebrado, dependências, triagem de bugs. O fim é claro e verificável.Testes falhando, lint, CI quebrado, dependências, triagem de bugs. O fim é claro e verificável.
Com spec e revisão forteCom spec e revisão forte
Feature com spec aprovada, refatoração grande, migração de código.Feature com spec aprovada, refatoração grande, migração de código.
Humano decideHumano decide
Arquitetura, segurança, dados de produção, deploy. O agente só apoia.Arquitetura, segurança, dados de produção, deploy. O agente só apoia.
Regra prática: se você não consegue escrever a condição de parada, ainda não é hora de orquestrar.Regra prática: se você não consegue escrever a condição de parada, ainda não é hora de orquestrar.
04 · O exemplo04 · O exemplo
Loops no
Claude Code.Loops no
Claude Code.
A orquestração mais simples: um objetivo, um verificador, um freio.A orquestração mais simples: um objetivo, um verificador, um freio.
A virada de 2026A virada de 2026
“Não escrevo mais prompt. Meu trabalho é escrever loops.”“Não escrevo mais prompt. Meu trabalho é escrever loops.”
Boris Cherny, criador do Claude Code, junho de 2026Boris Cherny, criador do Claude Code, junho de 2026
04 · As ferramentas04 · 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.
Comece pela mais simples que resolve. Agendamento na nuvem é o último degrau, não o primeiro.Comece pela mais simples que resolve. Agendamento na nuvem é o último degrau, não o primeiro.
04 · Freios04 · Freios
Observar mostra o problema. Parar resolve.Observar mostra o problema. Parar resolve.
Observar
Mostra o problema
- Dashboard de custo em tempo real
- Alerta no Slack ou no e-mail
- Log de cada iteração
- Alguém precisa ver, entender e agir. De madrugada, ninguém vê.
Parar
Resolve o problema
- Máximo de iterações:
/ralph-loop ... --max-iterations 20
- Bloqueios (deny):
git push, rm -rf, .env
- Hook que bloqueia comando perigoso antes de rodar
- Expiração: o
/loop morre sozinho em 7 dias
- Limite no /goal (“máximo de 15 turnos”) ajuda, mas quem julga é um modelo: combine com um limite rígido
Dashboard não é controle. Controle é o que para o loop sem ninguém olhando.
04 · O harness04 · O harness
O loop é descartável. O harness fica no git.O loop é descartável. O harness fica no git.
CLAUDE.mdCLAUDE.md
Regras e comandos do projeto, lidos em toda sessão.Regras e comandos do projeto, lidos em toda sessão.
SkillsSkills
Procedimentos repetíveis, como “verificar antes de entregar”.Procedimentos repetíveis, como “verificar antes de entregar”.
PermissõesPermissões
O que o agente nunca pode fazer, em .claude/settings.json.O que o agente nunca pode fazer, em .claude/settings.json.
HooksHooks
Scripts que rodam antes ou depois de cada ação e podem bloquear.Scripts que rodam antes ou depois de cada ação e podem bloquear.
Condição e limiteCondição e limite
Objetivo verificável e máximo de turnos, escritos junto do pedido.Objetivo verificável e máximo de turnos, escritos junto do pedido.
Limite de custoLimite de custo
Quanto um loop pode gastar e por quanto tempo pode rodar.Quanto um loop pode gastar e por quanto tempo pode rodar.
Harness = tudo o que envolve o loop: contexto, regras e freios. No git, revisado por PR.Harness = tudo o que envolve o loop: contexto, regras e freios. No git, revisado por PR.
04 · Memória04 · Memória
Quatro camadas, da mais simples à mais completa.Quatro camadas, da mais simples à mais completa.
1
CLAUDE.mdCLAUDE.md
Um arquivo de notas lido em toda sessão. Simples e “absurdamente eficaz”.Um arquivo de notas lido em toda sessão. Simples e “absurdamente eficaz”.
2
Memória na sessãoMemória na sessão
O agente anota o que descobriu enquanto trabalha.O agente anota o que descobriu enquanto trabalha.
3
SkillsSkills
Procedimentos que o agente só carrega quando precisa.Procedimentos que o agente só carrega quando precisa.
4
Memória em arquivosMemória em arquivos
Notas organizadas e pesquisáveis, que agentes leem e atualizam.Notas organizadas e pesquisáveis, que agentes leem e atualizam.
04 · Dreaming · consolidação de memória04 · Dreaming · consolidação de memória
Dreaming: um loop que revisa os outros loops.Dreaming: um loop que revisa os outros loops.
1Sessões
Conversas, comandos e erros de vários agentes e dias.
→
2Revisão fora da sessão
Um agente separado procura o erro que se repete e a regra desatualizada.
→
3Proposta com evidência
“Rodem pnpm test, não npm test”, citando as sessões.
APROVAÇÃO HUMANAAceita ou recusa
4Memória nova
Versionada, com autor. O próximo loop já começa sabendo.
todo loop seguinte começa melhor
Como o professor que vê a turma toda errar a mesma questão e corrige a aula, não cada prova.
05 · Hands-on05 · Hands-on
Mão na
massa.Mão na
massa.
Harness, verificação, /goal, freios e memória.Harness, verificação, /goal, freios e memória.
05 · Etapa 1 · O harness05 · Etapa 1 · O harness
Cinco minutos para pôr os freios.Cinco minutos para pôr os freios.
terminal
git checkout -b piloto-loops
claude # na sessão: /init → gera o CLAUDE.md
# .claude/settings.json
{ "permissions": { "deny": [
"Bash(git push:*)", "Bash(rm -rf:*)",
"Read(./.env)", "Read(./.env.*)"
] } }
git add CLAUDE.md .claude/ && git commit -m "harness"
- Branch e CLAUDE.mdBranch e CLAUDE.md
Loop só roda em branch. O /init lê o repositório e escreve o CLAUDE.md; revise e corte.Loop só roda em branch. O /init lê o repositório e escreve o CLAUDE.md; revise e corte. - Bloqueios (deny)Bloqueios (deny)
Nem se você pedir, o agente faz push, apaga em massa ou lê o .env.Nem se você pedir, o agente faz push, apaga em massa ou lê o .env. - Commit do harnessCommit do harness
É código do time: vai para o git e passa por PR.É código do time: vai para o git e passa por PR.
05 · Etapa 2 · Verificar sempre05 · Etapa 2 · Verificar sempre
Uma skill que não aceita “pronto” sem prova.Uma skill que não aceita “pronto” sem prova.
.claude/skills/verificar/SKILL.md
---
name: verificar
description: Use antes de dizer que qualquer tarefa terminou.
---
1. Rode `npm test` e `npm run lint`.
2. Se algo falhar, corrija e volte ao passo 1.
3. Nunca diga que terminou só porque a edição deu certo.
4. Nunca apague ou pule um teste para ele passar.
5. Termine colando a saída dos comandos como evidência.
- A descrição disparaA descrição dispara
O agente lê só a descrição e carrega a skill quando vai encerrar.O agente lê só a descrição e carrega a skill quando vai encerrar. - O ciclo testa-corrigeO ciclo testa-corrige
Testar, corrigir, testar de novo: a etapa Verificar do loop.Testar, corrigir, testar de novo: a etapa Verificar do loop. - Os freiosOs freios
Proíbe o atalho e exige evidência na resposta.Proíbe o atalho e exige evidência na resposta.
05 · Etapa 3 · Iterar até concluir05 · Etapa 3 · Iterar até concluir
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
- 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 · Etapa 4 · Um loop com freio05 · Etapa 4 · Um loop com freio
Um hook que bloqueia antes de rodar.Um hook que bloqueia antes de rodar.
.claude/hooks/bloqueia.sh
#!/usr/bin/env bash
cmd=$(cat | jq -r '.tool_input.command')
if echo "$cmd" | grep -Eiq 'prod|drop table|deploy'; then
echo "Bloqueado pela governança: $cmd" >&2
exit 2
fi
exit 0
# registre em .claude/settings.json > hooks > PreToolUse (Bash)
# depois, na sessão do Claude Code, com o freio ativo:
# > /loop 10m confira o CI do meu PR e corrija só falhas de teste
- Lê o comandoLê o comando
Antes de cada comando, o Claude Code manda o pedido em JSON para o script.Antes de cada comando, o Claude Code manda o pedido em JSON para o script. - Exit 2 bloqueiaExit 2 bloqueia
O comando não roda e o motivo volta para o agente.O comando não roda e o motivo volta para o agente. - Registre o hookRegistre o hook
No settings.json do projeto, versionado no git.No settings.json do projeto, versionado no git. - Agora o loopAgora o loop
Com o freio configurado, o /loop pode rodar sozinho. Expira em 7 dias.Com o freio configurado, o /loop pode rodar sozinho. Expira em 7 dias.
05 · Etapa 5 · Aprender05 · Etapa 5 · Aprender
Dreaming manual: o agente propõe, o time aprova.Dreaming manual: o agente propõe, o time aprova.
terminal
claude -p "
Leia o git log e os comentários de PR das últimas 2 semanas.
Encontre erros ou correções que se repetiram.
Compare com o CLAUDE.md: falta regra? Alguma está desatualizada?
Proponha até 3 mudanças, cada uma citando o commit ou PR.
Não edite nada: mostre só o diff do CLAUDE.md."
# você lê, escolhe o que faz sentido, e abre um PR
- Fonte: o históricoFonte: o histórico
Commits e revisões mostram onde o time e o agente erraram.Commits e revisões mostram onde o time e o agente erraram. - Procura o padrãoProcura o padrão
Não o erro isolado: o que se repete e a regra desatualizada.Não o erro isolado: o que se repete e a regra desatualizada. - Evidência e limiteEvidência e limite
Até 3 propostas, cada uma com prova. Sem editar.Até 3 propostas, cada uma com prova. Sem editar. - Aprovação humanaAprovação humana
Memória só muda por PR, como código.Memória só muda por PR, como código.
05 · Exercício · 30 min05 · Exercício · 30 min
Sua vez: um loop completo, com freio e aprendizado.Sua vez: um loop completo, com freio e aprendizado.
1
Monte o harnessMonte o harness
Bloqueios (deny), skill verificar e CLAUDE.md revisado, num commit.Bloqueios (deny), skill verificar e CLAUDE.md revisado, num commit.
2
Escolha uma tarefa verificávelEscolha uma tarefa verificável
Testes falhando, lint, um bug com teste que reproduz.Testes falhando, lint, um bug com teste que reproduz.
3
Rode um /goal com limiteRode um /goal com limite
Condição checável por comando, o que não pode mudar e no máximo 15 turnos.Condição checável por comando, o que não pode mudar e no máximo 15 turnos.
4
Registre o aprendizadoRegistre o aprendizado
Rode o dreaming manual e abra um PR com uma regra nova.Rode o dreaming manual e abra um PR com uma regra nova.
06 · Agente × time × governança06 · Agente × time × governança
O agente itera. O time decide.O agente itera. O time decide.
AgenteAgente
TimeTime
GovernançaGovernança
Objetivo e limiteObjetivo e limiteCritério de pronto e quando pararCritério de pronto e quando parar
!
✓
✕
Iterar e testarIterar e testarEditar, rodar, corrigirEditar, rodar, corrigir
✓
✕
!
Parar o loopParar o loopLimite, permissão, hook, expiraçãoLimite, permissão, hook, expiração
✕
!
✓
MemóriaMemóriaPropor regra nova ou corrigir desatualizadaPropor regra nova ou corrigir desatualizada
✓
✓
!
Merge e deployMerge e deployPR, aprovação e produçãoPR, aprovação e produção
✕
✓
!
✓FazFaz!Apoia ou limitaApoia ou limita✕Não fazNão faz
06 · Boas práticas06 · Boas práticas
O que separa um loop útil de uma fatura.O que separa um loop útil de uma fatura.
FaçaDo
- Condição que um comando confirmaCondição que um comando confirma
- Limite de turnos em todo loopLimite de turnos em todo loop
- Deny e hooks versionados no gitDeny e hooks versionados no git
- Loop só em branch, nunca na mainLoop só em branch, nunca na main
- Memória mudando só por PRMemória mudando só por PR
EviteAvoid
- “Melhore o código” como objetivo“Melhore o código” como objetivo
- Deixar rodando à noite sem limiteDeixar rodando à noite sem limite
- Contar com dashboard como freioContar com dashboard como freio
- Dois agentes conversando sem responsávelDois agentes conversando sem responsável
- Agente editando o CLAUDE.md diretoAgente editando o CLAUDE.md direto
Obrigado.Obrigado.
Perguntas?Perguntas?
Material completo:Full material:
bix-loops-arcelor.pages.dev
BIX Tech · bix-tech.comBIX Tech · bix-tech.com