Treinamento hands-on · Parte 2Treinamento hands-on · Parte 2
Do agente manual à orquestração.Do agente manual à orquestração.
ArcelorMittal × BIX Tech · novembro de 2026ArcelorMittal × BIX Tech · novembro de 2026
BIX TechBIX Tech
01 · Onde estamos01 · Onde estamos
Do agente manual à orquestração.Do agente manual à orquestração.
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 fluxoVerificação dentro do fluxo
Testes rodam a cada volta, não só no final.Testes rodam a cada volta, não só no final.
Freios fora do fluxoFreios fora do fluxo
Limites, permissões e hooks que o agente não desliga.Limites, permissões e hooks que o agente não desliga.
Humano nos portõesHumano nos portões
Pessoas escrevem o objetivo e aprovam o resultado.Pessoas escrevem 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.
PORTÃO HUMANOEscreve o objetivo e o limite
GOVERNANÇA · FORA DO LOOP · PODE PARAR
1Objetivo
O que deve ser verdade no fim.
→
2Agir
Lê, edita, roda comandos.
→
3Verificar
Testes, lint, checagem.
→
4Decidir
Atingiu? Para. Senão, volta.
não atingiu: tenta de novo
limite de turnospermissõeshooksorçamentoexpiração
PORTÃO HUMANORevisa o resultado e decide o merge
O loop trabalha entre os portões. A governança fica do lado de fora, onde o loop não consegue desligá-la.
02 · Níveis02 · Níveis
Quanto mais longe você fica, mais governança.Quanto mais longe você fica, mais governança.
INNER LOOP · AGORAINNER LOOP · AGORANa sua sessão, em minutosNa sua sessão, em minutos
Turno com verificação e /goal. Você está perto e vê o resultado logo.Turno com 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ê entra só nos portões: plano e PR./loop e /schedule em branch. Você entra só nos portões: plano e PR.
DARK FACTORY · PASSO 4DARK FACTORY · PASSO 4Sem revisão humanaSem 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.
Você sai do meioVocê sai do meio
O agente não para quando você vai a uma reunião.O agente não para quando você vai a uma reunião.
ParaleloParalelo
Vários fluxos ao mesmo tempo, cada um em sua branch.Vários fluxos ao mesmo tempo, cada um em sua branch.
Verificação constanteVerificação constante
Todo ciclo roda os testes, não só quando sobra tempo.Todo ciclo roda os testes, não só quando sobra tempo.
Aprende com o tempoAprende com o tempo
Cada erro corrigido vira regra para o próximo.Cada erro corrigido vira regra para o próximo.
O ganho vem de desenhar o fluxo uma vez e reusar, não de digitar mais rápido.O ganho vem de desenhar o fluxo uma vez e reusar, não de digitar mais rápido.
03 · Desafios03 · Desafios
Um fluxo que funciona
não é um fluxo seguro.Um fluxo que funciona
não é um fluxo 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, ninguém para parar.240 tentativas, 3 horas, ninguém para parar.
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 volta consome tokens; ninguém soma até a fatura.
Piloto pequeno, modelo menor no braçal, uso 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.
Permissões negadas e hooks. Loop só em branch.
Agentes em eco
Dois agentes pedem esclarecimento um ao outro sem parar.
Um dono humano por loop e um limite de rodadas.
Memória ruim
Regra errada ou velha 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
“Eu não dou mais prompt. Meu trabalho é escrever loops.”“Eu não dou 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.
Turno + verificaçãoTurno + verificação
Uma skill que obriga o agente a testar antes de dizer “pronto”.Uma skill que 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.: olhar o CI.Repete um pedido num intervalo, na sua sessão. Ex.: olhar 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. Rotina na nuvem é o último degrau, não o primeiro.Comece pela mais simples que resolve. Rotina 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
- Permissões negadas:
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 (“ou pare após 15 turnos”) ajuda, mas quem julga é um modelo: some um freio duro
Dashboard não é controle. Controle é o que para o loop sem precisar de algué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.
OrçamentoOrçamento
Quanto um loop pode custar, por quanto tempo pode rodar.Quanto um loop pode custar, por quanto tempo pode rodar.
Versionado no repositório, revisado por PR. Quem faz pull herda as mesmas regras.Versionado no repositório, revisado por PR. Quem faz pull herda as mesmas regras.
04 · Memória04 · Memória
Quatro camadas, da mais simples à mais rica.Quatro camadas, da mais simples à mais rica.
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 · Dreaming04 · Dreaming
Dreaming: um loop sobre os outros loops.Dreaming: um loop sobre 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 velha.
→
3Proposta com evidência
“Rodem pnpm test, não npm test”, citando as sessões.
PORTÃO HUMANOAceita 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 · Passo 1 · O harness05 · Passo 1 · O harness
Cinco minutos para pôr os freios.Cinco minutos para pôr os freios.
.claude/settings.json
// git checkout -b piloto-loops e /init (gera o CLAUDE.md)
{
"permissions": {
"deny": [
"Bash(git push:*)",
"Bash(rm -rf:*)",
"Read(./.env)",
"Read(./.env.*)"
]
}
}
// e versione: git add CLAUDE.md .claude/ && git commit
- 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. - Permissões negadasPermissões negadas
Nem pedindo o agente faz push, apaga em massa ou lê segredo.Nem pedindo o agente faz push, apaga em massa ou lê segredo. - 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 · Passo 2 · Verificar sempre05 · Passo 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 loop internoO loop interno
Testar, corrigir, testar de novo: o passo 3 do loop.Testar, corrigir, testar de novo: o passo 3 do loop. - As travasAs travas
Proíbe o atalho e exige evidência na resposta.Proíbe o atalho e exige evidência na resposta.
05 · Passo 3 · Iterar até cumprir05 · Passo 3 · Iterar até cumprir
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. Ou pare após 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, mais o que não pode mudar.
- 2Você põe o limiteTurnos dentro da 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 diffO portão do PR continua igual.
05 · Passo 4 · Um loop com freio05 · Passo 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
# em .claude/settings.json: hooks > PreToolUse > matcher "Bash"
/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 freio no lugar, o /loop pode girar sozinho. Expira em 7 dias.Com freio no lugar, o /loop pode girar sozinho. Expira em 7 dias.
05 · Passo 5 · Aprender05 · Passo 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á velha?
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 que envelheceu.Não o erro isolado: o que se repete e a regra que envelheceu. - 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. - Portão humanoPortão humano
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
Permissões negadas, skill verificar e CLAUDE.md revisado, num commit.Permissões negadas, 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 por comando, o que não pode mudar e no máximo 15 turnos.Condição 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
Agente itera, time decide, regra para.Agente itera, time decide, regra para.
AgenteAgente
TimeTime
GovernançaGovernança
Objetivo e limiteObjetivo e limiteO que deve ser verdade e quando pararO que deve ser verdade 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 velhaPropor regra nova ou corrigir velha
✓
✓
!
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
- Permissões negadas e hooks no gitPermissões negadas e hooks 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 donoDois agentes conversando sem dono
- 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