Aula 7
Loop engineering: o agente que ninguém chamou

Quatro camadas

O loop mais simples que existe

while :; do cat PROMPT.md | claude -p ; done

A técnica “Ralph Wiggum”, publicada por Geoffrey Huntley em julho de 2025. Em português: entregue o conteúdo de PROMPT.md ao Claude, espere ele terminar e entregue de novo. Para sempre.

• O que ela acerta: cada volta começa com a janela de contexto limpa, e o progresso fica no disco, não na memória do modelo
• O que falta: quem dispara, quando para, e quem é chamado quando dá errado. São as três perguntas desta aula

Um loop para copiar e colar

Na pasta da aplicação de vocês, crie um TODO.md com tarefas pequenas:

- [ ] Validar o formato do e-mail no cadastro
- [ ] Escrever um teste para a função de login
- [ ] Traduzir as mensagens de erro para português

E rode no terminal:

for i in 1 2 3 4 5; do
  grep -q -- "- \[ \]" TODO.md || break   # acabaram as tarefas? para
  claude -p "Leia TODO.md. Faça só o primeiro item sem [x] e marque-o com [x]." \
    --permission-mode acceptEdits
done

• Cada volta é uma sessão nova do Claude, que não lembra da anterior
• O que já foi feito fica no TODO.md: é por ele que a volta seguinte sabe onde continuar
• Para quando não sobra item sem [x], ou depois de cinco voltas, o que vier primeiro

Anatomia de um loop

Toda volta termina de um de três jeitos: passou, tenta de novo ou escalou. Um loop sem a terceira saída roda até o dinheiro acabar.

1. O gatilho: agenda ou evento

Discussão: que gatilho usar?

Em qualquer caso, o prompt fica num arquivo do repositório (loop/PROMPT.md). Mudar o comportamento do loop é editar esse arquivo, e a mudança passa por revisão como qualquer código.

2. O critério de parada

• É o critério de aceite do SPEC.md da aula 5. Spec sem critério verificável dá loop sem parada

Quem decide que terminou?

Toda vez que o agente diz “terminei”, um porteiro confere antes de deixar ele parar:

3. O ponto de escalação

O loop para e chama alguém quando:

Escalar bem é deixar o caso pronto para o humano: o que foi tentado, por que falhou, onde parou. Escalar a cada volta é só notificação, e notificação demais ninguém lê.

O que dá errado

• Custo descontrolado. Um loop que tentava fazer os testes passarem, sem teto de voltas, gastou cerca de 8 milhões de tokens em 48 horas
• Correção infinita. A volta 4 desfaz a volta 3, que desfez a volta 2
• Verificador de fachada. Aprova sem conferir nada. Se o agente escreve o código e o teste, quem verifica é ele mesmo
• Fadiga de revisão. O loop abre mais PRs do que a dupla consegue ler. A revisão vira carimbo, e os testes continuam verdes

Exercício: um loop na aplicação da AP1

• 1. Escolham uma tarefa recorrente da aplicação e o gatilho dela: agenda ou evento? Justifiquem
• 2. Escrevam o critério de parada de um jeito que uma máquina consiga conferir. “Ficar bom” não vale
• 3. Listem quando o loop deve parar e chamar vocês, incluindo as partes do código que ele não pode tocar
• 4. Coloquem tudo em loop/PROMPT.md e rodem o agente com ele até três vezes, cada volta numa sessão nova. Depois de cada volta, vocês são o porteiro: rodem os testes e decidam se para, tenta de novo ou escala

Anotem cada volta em loop/ESTADO.md: o que o agente fez, se passou e por quê. Registrem em diario/2026-10-13.md onde o loop parou e o que vocês automatizariam primeiro. Commit no dia.