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

Na 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 PILOTO

Agendado, 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 4

Dark 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.

1

Sessões

Conversas, comandos e erros de vários agentes e dias.

→
2

Revisão fora da sessão

Um agente separado procura o erro que se repete e a regra desatualizada.

→
3

Proposta com evidência

“Rodem pnpm test, não npm test”, citando as sessões.

APROVAÇÃO HUMANAAceita ou recusa
4

Memó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"
  1. 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.
  2. 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.
  3. 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.
  1. 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.
  2. 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.
  3. 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
  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 · 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
  1. 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.
  2. 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.
  3. Registre o hookRegistre o hook
    No settings.json do projeto, versionado no git.No settings.json do projeto, versionado no git.
  4. 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
  1. 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.
  2. 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.
  3. 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.
  4. 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
06 · Próximos passos06 · Próximos passos

Piloto de loops nas próximas duas semanas.Piloto de loops nas próximas duas semanas.

0/6
BIX Tech

Obrigado.Obrigado.

Perguntas?Perguntas?

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

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

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

ÍNDICEINDEX