🔁Loop engineering · pare de pilotar a IA na mão e faça ela trabalhar sozinha rumo à meta
O nível final da série. Até agora você aprendeu as peças: memória, GitHub, RAG, o brain, C-A-R, agent-browser. Loop engineering é a cola que as transforma em um sistema autônomo: a IA deixa de ser "alguém do outro lado do chat" e passa a ser um motor que itera sozinho rumo a uma meta. Vou te explicar o ciclo, os três freios que te livram de uma fatura surpresa, e como montar seu primeiro ciclo com comandos que existem de verdade.
Jun 23, 202613 min
Para quem é isto?
Para qualquer pessoa que já constrói com IA e percebeu algo incômodo: você é o gargalo. Enquanto está na frente, a IA avança; quando você sai, tudo para. Este recurso é o salto de "eu dirijo cada passo" para "monto um sistema que avança sozinho". Você não precisa ser programador: precisa entender o padrão.
1. O momento: quando você percebe que O MOTOR é você
Pense em como você trabalha hoje com a IA. Você escreve uma instrução. Espera. Lê o que ela fez. Diz "agora corrige isto". Espera de novo. Revisa. "Agora adiciona aquilo". De novo e de novo. Funciona — mas há um problema silencioso: o motor de tudo é você. Sua atenção é o combustível. No segundo em que você levanta pra pegar um café, o projeto congela.
O momento do loop engineering chega quando você pensa: "e se eu não precisasse ficar aqui dando corda a cada passo? E se eu desse uma meta e ela se virasse sozinha até cumprir?". É exatamente isso. Foi muito bem colocado num artigo da Firecrawl sobre o tema: com loop engineering, a IA deixa de ser um colaborador do outro lado do chat; passa a ser uma função que um programa chama em um ciclo.
Imagine assim
Até agora você foi o motorista: com as duas mãos no volante a viagem inteira. Loop engineering é colocar um destino no GPS e ativar o piloto automático: o carro acelera, olha a estrada, corrige o rumo e olha de novo, sozinho, até chegar. Você deixa de dirigir e passa a supervisionar a viagem.
2. A dor: o trabalho manual não escala (e te esgota)
A dor de não dar esse salto é real e honesta — não é um apocalipse, é desgaste. Estes são os sintomas:
Sinais de que o trabalho manual está te limitando
Tarefas longas (auditar o projeto inteiro, pesquisar 8 concorrentes, migrar 40 arquivos) levam horas porque você as faz em fila, uma por uma.
Se você sai do computador, o progresso para na hora. A IA não continua sem você.
Você repete o mesmo tipo de instrução todo dia e sente que é um operador de máquina, não um diretor.
Você não consegue fazer duas coisas grandes ao mesmo tempo porque só tem um par de mãos e um chat aberto.
O mal-entendido mais comum
Muita gente acha que "automatizar a IA" é só dar um prompt mais longo. Não é. Um prompt longo ainda precisa de você pra apertar enviar e revisar. Loop engineering é outra coisa: é fazer o sistema decidir sozinho se continua ou para, sem você apertar nada.
3. O coração: o ciclo Age → Observa → Raciocina → Repete
Todo ciclo, por mais simples ou complexo que seja, gira sobre os mesmos quatro passos. Memorize-os, porque são a essência de tudo:
Os 4 passos de qualquer loop
Age — a IA faz algo (escreve código, busca na web, corrige um teste).
Observa — lê o resultado do que fez (o teste passou? o que a busca retornou?).
Raciocina — compara esse resultado com a meta (já está? falta algo? tem um erro?).
Repete — decide sozinha se recomeça ou se terminou.
A diferença em relação a conversar normalmente é o quarto passo: a IA decide se continua, você não. O ciclo roda sozinho até cumprir a meta ou até tocar um limite que você definiu (já já vemos esses limites, eles são sagrados).
Loop aberto vs. loop fechado
Há dois sabores. Loop aberto: você dá uma meta e liberdade total ("encontre todos os meus concorrentes e pontue cada um") — potente pra explorar, mas se seus critérios são vagos, o resultado sai ruidoso. Loop fechado: você traça o caminho passo a passo, com como verificar cada um — mais previsível, mais barato, melhores resultados. Em produção quase sempre se usa o fechado.
4. Os 3 freios sagrados (sem eles não é um loop, é uma fatura aberta)
Esta é a parte que NINGUÉM te conta e a mais importante. Um ciclo que roda sozinho pode gastar créditos sozinho. A maior parte da arte do loop engineering não é fazer a IA iterar — é evitar que ela itere pra sempre e esvazie sua conta. Há três freios que SEMPRE devem existir:
Os 3 freios que jamais podem faltar
Teto de iterações — um número máximo de voltas. "Tente 10 vezes no máximo, depois pare."
Checagem de mudanças (diff-check) — se depois de N voltas a IA já não muda nada, pare. Está girando em vão.
Teto de gasto — um limite de tokens ou de dinheiro. Quando é atingido, o ciclo termina, tenha cumprido ou não.
O 4º freio que quase ninguém coloca (e é o mais traiçoeiro)
Os três freios acima controlam quantidade (quantas voltas, quanto gasto). Mas há um freio de qualidade que é o que de verdade te salva: a regra anti-trapaça. Se você pede à IA "faça todos os testes passarem", a forma mais fácil de "vencer" pra ela é… apagar o teste, marcá-lo como pulado, ou enfraquecer o que ele verifica. Ela passa nos seus três freios com bandeira verde — e seu app continua quebrado. SEMPRE adicione ao seu loop: "proibido apagar, pular (skip) ou enfraquecer o que se verifica pra fingir sucesso; conserte a causa real". Isso vale pra qualquer meta, não só testes.
A frase que você deve tatuar
Do artigo da Firecrawl, palavra por palavra: "Sem os três freios, o que você está rodando não é um loop. É uma fatura aberta." Antes de lançar qualquer ciclo autônomo, pergunte-se: tenho o teto de voltas, o de mudanças e o de gasto? Se falta um, não lance.
O outro risco: a dívida de compreensão
Quando a IA produz código mais rápido do que você consegue entendê-lo, abre-se uma brecha perigosa: você tem no seu projeto coisas que não compreende. Quanto mais rápido o ciclo roda, mais essa brecha se alarga — a não ser que alguém revise as mudanças. Por isso loop engineering anda de mãos dadas com o protocolo C-A-R: o ciclo constrói, mas você (ou um agente verificador) audita.
5. O hábito: pensar em ciclos, não em mensagens soltas
Loop engineering não é algo que você faz uma vez. É uma mudança de mentalidade constante. Toda vez que for fazer uma tarefa com IA, antes de escrever o primeiro prompt, pergunte-se: "isto é uma mensagem solta, ou é um ciclo?". A maioria das tarefas grandes são ciclos disfarçados de muitas mensagens.
Os momentos em que você SEMPRE deveria pensar em um loop
Quando uma tarefa tem um critério claro de "terminado" (todos os testes passam, 10 bugs encontrados, o documento cobre todos os pontos).
Quando você está repetindo o mesmo ciclo na mão (roda → falha → corrige → roda de novo).
Quando a tarefa é grande demais para uma só passada (auditar tudo, migrar tudo, pesquisar muitas fontes).
Quando você quer que algo aconteça enquanto você não está (revisar um deploy, vigiar um site, uma checagem diária).
A regra do verificador (o padrão de maior retorno)
O truque mais rentável de todos: separe quem faz de quem revisa. Um agente (ou cadeia de agentes) faz as mudanças; outro agente diferente as avalia contra suas regras e testes. O verificador não precisa ser mais esperto — só precisa ser outro, com a cabeça fria de auditor. É exatamente o que faz o protocolo C-A-R: construir e auditar em turnos separados.
6. Como montar seu primeiro loop (com comandos que existem de verdade)
Aqui está o bonito: você não precisa programar nada estranho. Se você usa um agente de código moderno como o Claude Code, ele já traz as peças montadas. Estes comandos são reais e estão na documentação oficial dele:
O kit de loop engineering no Claude Code
/goal <condição> — o coração do loop rumo a uma meta. Você fixa uma condição e, após cada turno, um modelo rápido verifica se ela já foi cumprida; se não, o Claude arranca outra volta sozinho, em vez de devolver o controle a você. É o "trabalha até ficar verde". Precisa de uma condição verificável (ex. "todos os testes passam", "git status limpo").
/loop [intervalo] [prompt] — repetir no tempo, NÃO iterar rumo a uma meta. Executa um prompt a cada certo intervalo (/loop 5m revisa o deploy) ou, sem intervalo, o Claude escolhe o ritmo sozinho. Útil pra vigiar algo, não pra "alcançar X". Não confunda com /goal.
/schedule — cria rotinas na nuvem: tarefas programadas (a cada hora, todo dia) que rodam mesmo com o notebook fechado, ou que reagem a eventos do GitHub.
/batch — divide um trabalho grande em 5 a 30 unidades em paralelo, cada uma no seu próprio subagente e no seu próprio worktree isolado; cada uma faz sua parte, roda os testes e abre seu próprio pull request. (É a versão industrial do loop para migrações e mudanças em massa.)
A distinção que quase ninguém entende
Muita gente mistura `/goal` e `/loop` e são coisas diferentes. `/goal` itera até cumprir uma condição (é o ciclo "trabalha até conseguir"). `/loop` repete num intervalo (é o "a cada X minutos faz isto"). Pra "conserta todos os testes" você quer /goal. Pra "vigia o deploy a cada 5 min" você quer /loop. Confundir os dois é o erro de iniciante número um.
Dado de autoridade · de onde isto vem
Loop engineering não surgiu do nada. Vem do padrão ReAct (Reason → Act → Observe, de um paper de 2022) que ensinou os modelos a raciocinar e agir em ciclo. Depois veio o Reflexion, que adicionou um passo de autocrítica — o agente se corrige a si mesmo. O salto de 2026 é a duração: os agentes passaram de respostas curtas de chat a rodar minutos ou horas sozinhos. Loop engineering é aplicar engenharia séria (e freios) a essa autonomia.
E as peças de apoio que tornam um loop confiável também existem: worktrees (claude --worktree) pra que vários agentes trabalhem sem se atropelar, skills (pastas com um SKILL.md) pra que a IA não redescubra seu contexto toda vez, hooks pra engatar ações em momentos-chave, e conectores MCP pra que o ciclo alcance ferramentas externas (Slack, GitHub, seu banco de dados).
Você já tem quase todas as peças nesta série
O melhor: você não começa do zero. A memória dá ao ciclo um estado que sobrevive entre voltas. O RAG / o brain dá contexto. As skills codificam seu conhecimento. O GitHub dá o ponto de retorno seguro. O agent-browser dá os olhos pra observar de verdade. Loop engineering só conecta tudo isso em um ciclo. Você tem todos nesta série — no fim te deixo os links diretos.
7. Como se usa de verdade: projetar primeiro, depois invocar o comando
Aqui está o detalhe que quase todos os tutoriais pulam, e é CHAVE: o ciclo não arranca sozinho só porque você descreve a tarefa. Colar um texto longo dizendo "monta um loop que conserte meus testes" faz a IA te projetar o plano — mas NÃO o executa. Pra que a IA comece a iterar de verdade, você tem que escrever o comando explicitamente (no Claude Code, /goal ou /loop). São dois passos: primeiro você projeta, depois invoca.
O comando NÃO é opcional
Se você só descreve o loop em linguagem natural, a IA responde com o plano e para — espera seu sinal verde. O ciclo autônomo só dispara quando você digita o comando (/goal … ou /loop …). Isso é bom: te obriga a aprovar o projeto e os freios ANTES de soltar a máquina. Projeto e execução estão separados de propósito.
Passo 1 — Projete o ciclo. Cole isto no seu agente, preenchendo os [colchetes]. Ele vai te devolver o plano, os freios e —importante— o comando exato que você deve digitar depois:
Prompt para projetar seu primeiro loop autônomo (com freios)texto
Quero montar um loop autônomo (loop engineering) para esta tarefa: [DESCREVA A TAREFA, ex: "encontrar e consertar todos os testes que falham" ou "pesquisar a fundo meus 5 concorrentes e sintetizar um relatório"].
Minha ferramenta é: [Claude Code / Cursor / outra]. Antes de projetar, olhe meu projeto e me diga qual é o comando ou o sinal exato que serve de "verdade" para esta tarefa (ex. o comando de testes real, ou como se mede "terminado"). Se não encontrar, me pergunte.
Projete-o comigo seguindo o ciclo Age → Observa → Raciocina → Repete. Preciso que você me proponha, em linguagem clara:
1. A META: a condição exata e VERIFICÁVEL de "terminado" (como saberemos que o loop deve parar porque já cumpriu de verdade).
2. SE CONVÉM loop ABERTO (liberdade) ou FECHADO (passos traçados) para esta tarefa, e por quê.
3. O CICLO: o que a IA faz em cada volta (age), como verifica o resultado (observa), e como decide se continua (raciocina).
4. A SEPARAÇÃO: um agente que FAZ e outro diferente que VERIFICA o resultado (incluindo a regra anti-trapaça de baixo).
5. OS 4 FREIOS, obrigatórios:
- Teto de iterações (número máximo de voltas).
- Checagem de estagnação (parar se já não avança após N voltas).
- Teto de gasto (limite de tokens ou de tempo).
- REGRA ANTI-TRAPAÇA: proibido apagar, pular (skip) ou enfraquecer o que se verifica para fingir sucesso. Tem que consertar a CAUSA RAIZ (o código real), não colocar um remendo que silencie o sintoma. Se uma volta deixa MAIS quebrado do que conserta, reverter essa volta.
6. O COMANDO EXATO QUE EU DEVO DIGITAR para executá-lo (não execute você sozinho). No Claude Code: se a tarefa é "itera até cumprir uma condição" use `/goal <condição>`; se é "repete a cada certo tempo" use `/loop <intervalo> <prompt>`. Me dê a linha já escrita, pronta para copiar, com a condição de parada e os freios incluídos. Verifique que o comando exista de verdade; não invente.
7. O QUE EU POSSO SUPERVISIONAR enquanto roda, em uma linha por volta legível mesmo que eu não programe, para não cair em dívida de compreensão.
Primeiro me mostre SÓ o projeto completo, os 4 freios e o comando exato a digitar. NÃO execute o ciclo: eu vou dispará-lo digitando o comando quando aprovar o projeto.
Passo 2 — Dispare o ciclo com o comando. Quando o projeto e os freios te convencerem, AGORA sim você digita o comando que a IA te deu. Pra "trabalha até cumprir uma condição" (o mais comum), no Claude Code é o /goal. Por exemplo, pra consertar testes seria algo assim:
Claude Code
/goal todos os testes passam (roda a suíte completa), sem apagar nem pular nenhum teste, máximo 15 voltas
A partir daí, a IA roda, observa o resultado, raciocina e tenta de novo sozinha depois de cada turno, até que um modelo rápido confirme que a condição foi cumprida (ou até tocar um freio). Se o que você quer é repetir algo a cada certo tempo (vigiar um deploy, por exemplo) em vez de iterar rumo a uma meta, aí o comando é o /loop:
Claude Code
/loop 5m revisa se o deploy terminou e me avisa o que aconteceu
A regra de ouro dos dois passos
Você projeta em linguagem natural (passo 1) → revisa o plano e os freios → você digita o comando (passo 2). Nunca ao contrário. Essa separação é sua segurança: nenhum ciclo arranca sem que você tenha visto o plano e apertado o botão. Cinco minutos de revisão te poupam uma fatura aberta.
8. Os caminhos mais fáceis · o que a IA faz e o que você decide
Pra não complicar, isto é o que seu agente de código pode fazer sozinho pelo chat, e o que continua sendo decisão sua:
O que o AGENTE faz por você (pelo chat)
Projetar o loop completo: a meta, o ciclo, os freios — e te dar o comando exato a digitar.
Uma vez que VOCÊ dispara o comando (/goal ou /loop), rodar as voltas sozinho: age, observa, raciocina e tenta de novo até cumprir a condição ou tocar um freio.
Lançar agentes em paralelo com /batch para tarefas grandes (auditar, pesquisar, migrar).
Verificar o próprio trabalho em um turno separado (o padrão do verificador).
Criar a skill (SKILL.md) que codifica o contexto pra que o loop seja repetível.
O que VOCÊ decide (não delegue)
A META e quando se considera "terminado" — isto define a qualidade do resultado.
Digitar o comando que dispara o ciclo (/goal … ou /loop …): ele não arranca sozinho, você o liga depois de ver o plano.
Os 4 freios: quantas voltas, quando parar por estagnação, quanto gastar, e a regra anti-trapaça.
Revisar as mudanças que ele produziu (pra não acumular dívida de compreensão).
O critério de qualidade / a rubrica — porque um loop multiplica o bom critério que você coloca, e também o ruim.
No NeuralOS
A filosofia de loop engineering é a que move por dentro os times de agentes do NeuralOS: agentes que recebem uma meta e trabalham rumo a ela, com um agente que coordena e outros que executam ou verificam. Hoje você vê isso desenhado na interface (a visão já tangível); o motor autônomo completo é parte do roadmap do backend. A ideia é que você coloque a meta e o critério — o sistema faz as voltas.
Resumo · seu checklist de loop engineering
Antes de lançar qualquer ciclo, confirme
Tenho uma meta com uma condição de "terminado" clara.
Projetei o ciclo Age → Observa → Raciocina → Repete.
Decidi se é loop aberto ou fechado (em produção, quase sempre fechado).
Tenho os 3 freios: teto de iterações + checagem de mudanças + teto de gasto.
Defini quem faz e quem verifica (turnos separados).
Vou revisar as mudanças pra não acumular dívida de compreensão.
Coloquei meu melhor critério na rubrica — porque o loop vai multiplicá-lo.
O encerramento da série
Se você chegou até aqui seguindo a série, já tem o sistema completo: memória, GitHub, RAG, o brain, graphify, C-A-R, segurança, skills, agent-browser… e agora o ciclo que os une. Você parou de pilotar a IA na mão: agora coloca uma meta, dá bom critério e freios, e deixa ela trabalhar. Isso é construir como um estúdio, não como um operário.