Fable 5: Guia para Iniciantes em Loop Engineering

A engenharia de loops é a maior mudança que já vimos em prompts de IA.

Combine-a com o Fable 5, e você terá agentes de IA trabalhando para você enquanto dorme, construindo tudo o que puder imaginar.

Este guia ensina exatamente como começar.

Um guia para leigos sobre engenharia de loops e como a pessoa comum pode aproveitar o /loop.

Conteúdo

• O que é um Loop?
• Anatomia do Loop 101
• Prompts 101
• /loop Dicas Profissionais

O que é um Loop?

Resumo

Engenharia de loops é, essencialmente, uma forma dos agentes criarem prompts para si mesmos e evitarem iterações manuais.

Antes da engenharia de loops: Você dá um prompt para a IA → Ela responde → Você itera → Repete

Com a engenharia de loops: Você projeta um loop → O agente retorna com um resultado finalizado (o agente completa toda a pesquisa, idas e vindas, etc.)

A pessoa que realmente construiu o Claude Code (Boris Cherny) colocou de forma simples:

"Eu não dou mais prompts para o Claude. Tenho loops rodando que dão prompts para o Claude. Meu trabalho é apenas escrever loops."

Esta é a maior mudança que já vimos em prompts de IA.

Por enquanto, isso é tudo que você precisa saber. O que é mais importante é a anatomia do loop e como realmente aproveitar essa mudança para desbloquear a produtividade da IA.

Anatomia do Loop 101

Anatomia do Loop 101

Para este guia, vou usar o Claude Code como referência, mas esses princípios se aplicam à maioria das ferramentas e frameworks de IA.

Cada loop no Claude Code tem as mesmas seis partes funcionais.

Domine-as e você será capaz de construir qualquer coisa.

1. Gatilho (Automações)

O gatilho é o que inicia o loop.

No Claude Code, você aciona automações de loop agêntico com /schedule e /loop (mais sobre prompts adiante).

/loop roda em um intervalo especificado; sem um intervalo, ele se auto-regula com base na saída.

2. Camada de Execução

É aqui que o Claude realmente faz o trabalho.

Ele lê o estado atual, age e produz resultados.

Nenhuma entrada manual é necessária - apenas observe o Claude trabalhar.

3. O Verificador

É aqui que você dá um ponto de verificação para o Claude.

Coisas como: Testes, uma build, uma captura de tela para comparar.

Usar uma camada de verificação ajuda a garantir que o Claude está realmente no caminho certo e não produzindo porcaria.

Você pode usar o comando /goal, que vai um passo além ao executar um modelo rápido separado para avaliar o trabalho a cada turno.

4. Regras de Parada

Todo loop precisa de dois tipos de condições de parada:

1. Parada por sucesso (todos os testes passam, tarefa completa)
2. Parada por falha (limite de tentativas excedido, erro irrecuperável).

Você também pode adicionar regras de parada, como um orçamento de tokens, que pode ajudar a gerenciar os gastos com IA.

1Torne-as explícitas em suas instruções, não implícitas:
2Você tem no máximo 20 tentativas. Se todos os testes passarem, relate "TAREFA_COMPLETA" e pare.
3Se você encontrar um erro que não pode resolver após 3 tentativas, relate "TAREFA_FALHOU: [motivo]" e pare.

5. Memória (Arquivo de Progresso)

Manter um arquivo markdown do progresso do Claude é geralmente uma boa prática.

Um registro simples do que foi feito para que você possa verificar seu trabalho e voltar, se necessário.

6. Habilidades (CLAUDE.md)

Habilidades são conjuntos de instruções salvos que congelam o conhecimento do projeto para que o agente não reaprenda o mesmo contexto a cada sessão.

Seu arquivo CLAUDE.md é o que dá personalidade ao loop e define suas restrições para cada execução.

Dica: Mantenha-o curto. Um arquivo de regras inchado é pago em cada batida do loop.

Juntando todos os seis, a estrutura de loop ideal fica assim:

1GATILHO   →  a cada 15min / em comentário de PR / em falha de CI
2EXECUTOR  →  Claude trabalha na tarefa
3VERIFICADOR →  modelo separado avalia a saída
4PARADA    →  todos os testes verdes, ou 10 iterações, ou $5 gastos
5MEMÓRIA   →  progress.md atualizado a cada execução
6HABILIDADES →  CLAUDE.md lido no início de cada sessão

Prompts 101 (juntando as peças)

Escrever prompts para /loop não é o mesmo que prompts normais. Você precisa de uma pequena mudança de mentalidade ao fazer engenharia de loops.

Quando você dá um prompt normal para o Claude, está simplesmente escrevendo uma instrução/tarefa.

Quando você está projetando um loop, está escrevendo uma condição final que deve ser atendida.

Exemplo

Prompt (turno único):

1Corrija os testes com falha no módulo de autenticação.

Condição de objetivo (loop):

1/loop todos os testes no módulo de autenticação passam e a cobertura está acima de 80%

Um prompt diz ao Claude o que fazer, enquanto uma condição de objetivo diz ao Claude quando parar.

A anatomia de uma boa condição de objetivo

Todo prompt /loop forte tem três coisas:

1. Um estado final verificável
2. Uma restrição de escopo (quais arquivos, quais pastas, quais tarefas)
3. Uma regra de parada (iterações máximas ou orçamento)

Aqui está o modelo:

/loop [estado final verificável/tempo], tocando apenas em [escopo], pare após [X] restrições, use [X] Habilidades, use agentes verificadores para [x] ponto de verificação e mantenha um arquivo de memória de todo o seu trabalho.

Esta é a estrutura base de /loop que todo iniciante deve usar para obter ótimos resultados sem complicar demais.

CLAUDE.md

Pense no seu CLAUDE.md como o documento de briefing que seu loop lê antes de iniciar cada execução.

Certifique-se de incluir tudo o que você normalmente repetiria em um prompt: sua stack, suas regras, suas preferências, etc.

Novamente, mantenha-o curto. Cada linha extra de contexto inchado custa tokens.

Juntando tudo (um exemplo de /loop de briefing de pesquisa):

1CLAUDE.md (definido uma vez):
2Estilo de pesquisa: abrangente, citado, sem enrolação
3Formato de saída: markdown com cabeçalhos claros
4Nunca crie arquivos fora de /research
5Fontes preferidas: fontes primárias, publicações respeitáveis, dados oficiais
6Orçamento máximo por sessão: $3
7Habilidade (definida uma vez):
8/skill verify-research: antes de marcar qualquer seção como concluída, confirme
9se cada afirmação importante tem uma fonte, cada seção tem pelo menos 3 pontos de dados
10de apoio, e não há lacunas óbvias. Nunca entregue pesquisa superficial.
11O loop:
12/loop a cada 30 minutos,
13
14tocando apenas em /research/brief.md,
15
16pare após 10 iterações ou se a mesma consulta de pesquisa aparecer
173 vezes seguidas sem que novas informações surjam,
18
19use a habilidade verify-research após cada seção ser rascunhada,
20
21use um agente verificador para verificar a qualidade da fonte e a completude
22da cobertura no meio do caminho e antes do envio final,
23
24e mantenha um arquivo de memória em /research/progress.md que registre
25quais seções estão concluídas, quais fontes foram usadas,
26e quais ângulos ainda precisam de cobertura — leia-o no início
27de cada execução e atualize-o no final.
28
29Tópico: [seu tópico aqui]
30
31Todos os princípios em um só lugar. O loop roda em um temporizador, permanece no escopo de um arquivo, para sozinho em caso de estagnação ou orçamento, usa uma habilidade salva como gate de qualidade, ativa um verificador separado em dois pontos de verificação e mantém um arquivo de memória persistente para que cada execução continue exatamente de onde a última parou.

/loop Dicas Profissionais

Uma seção de dicas profissionais de /loop para você começar

• Comece com /goal antes de /loop: É o mesmo comportamento, mas mais fácil de entender para iniciantes.
• Gaste mais tempo no entregável: Ao projetar loops, concentre-se em como você quer que o objetivo final se pareça - todo o resto é praticamente ruído.
• Combine o nível de esforço com a tarefa: Seu esforço de raciocínio padrão deve ser alto. Use xHigh, Max e Ultracode apenas para construções complexas.
• Subagentes: Cada subagente começa com uma janela de contexto nova. Aproveite para implantar subagentes dentro de loops.
• Sempre limite: Crie o hábito de definir um limite rígido de iterações e um orçamento em dólares antes de cada execução.
• Execute /compact manualmente antes de sessões longas: Quando a janela de contexto se aproxima do seu limite, o SDK compacta automaticamente. Você também pode acioná-lo mais cedo com /compact.
• Loops funcionam para muito mais do que código: Você pode usar /loop para todas as tarefas. Sinta-se à vontade para ser criativo e usar loops para escrita, pesquisa e tarefas não convencionais que não envolvam código.

Conclusão

Espero que você tenha achado este guia de /loop valioso.

Se gostou, não deixe de me seguir no @aiedge_ - Publico artigos de IA como este 2 a 3 vezes por semana.

Se você gosta de conteúdo escrito sobre IA, sinta-se à vontade para se inscrever na minha newsletter gratuita aqui:

https://newsletter.aiedgehq.co/

https://newsletter.aiedgehq.co/

100% gratuito, sem spam e cancele quando quiser.

Por último, se puder, siga minha nova conta de clipes onde publico pequenos vídeos discutindo tópicos de tendências em IA/mercado - tenho certeza de que você vai obter muito valor💙

https://x.com/DeutscherClips/status/2072924183861018957