Formação LOOP-R Engenharia · curso 2 de 6 · 8 aulas
Execução Longa: o agente trabalha horas e quem decide que acabou é o teste
Sete arquivos de estado, um goal.md que não se cumpre por atalho, hook que vigia o contexto e o cache, handoff que se confere, loop headless com teto e medição de cada sessão. Tudo com o kit aberto execucao-longa e saídas reais de terminal.
- 8aulas
- 20exercícios com saída esperada
- 73testes no kit (19/10)
- 1vídeo
As aulas
Na ordem em que você monta: pasta e goal, contexto e cache, handoff, loop sem interface, medição e uma execução completa.
Aula 1 · 15 minO kit: sete arquivos que seguram uma execução longaUma sessão longa falha de três jeitos: não sabe quando parar, esquece o que fez depois de compactar e gasta o que não devia. O kit execucao-longa responde com arquivos, não com memória do modelo: o agente relê a pasta em vez de lembrar. Nesta aula você instala o kit e cria a primeira pasta.
Aula 2 · 18 minEscrever o goal.md nível 3+ sem atalho possívelNo piloto do kit, com critério nível 3 e 14 testes congelados, a execução terminou no primeiro ciclo, em 3 minutos. A maior parte do trabalho de uma execução longa é escrever o critério. Aqui você escreve o seu goal.md de forma que o único jeito de cumprir seja fazer o trabalho.
Aula 3 · 18 minContexto em faixas: 50, 70 e 85% do ponto de compactaçãoO maior inimigo de uma sessão longa é a compactação repetida: o objetivo sobrevive, mas o que está feito e o que falta se diluem. O hook-longrun mede o contexto e age antes do limite, em três faixas. Nesta aula você liga o hook e provoca as três faixas num ensaio, sem gastar um token.
Aula 4 · 16 minCache e ociosidade: o que os números de outubro mostramVoltar a uma sessão grande parada há duas horas pode custar centenas de milhares de tokens numa única mensagem. Não é erro: é o cache que venceu. Com os números medidos em outubro de 2026, você entende a linha do tempo de uma sessão parada e decide, com conta, entre reenviar e recomeçar limpo.
Aula 5 · 17 minHandoff que confere se salvouUm handoff escrito pelo próprio agente se autocertifica: ele pode dizer que testou o que não testou e o arquivo pode nem ter sido gravado. Desde 17/10/2026 a prova saiu do texto: um script grava carimbo, commit e impressão digital dos arquivos, e o hook confere na transcrição se o handoff foi mesmo salvo.
Aula 6 · 20 minLoop headless: loop-longrun.sh, flock, timeout e MemoryMaxNo /goal interativo, quem decide que acabou é um avaliador lendo a conversa. No loop headless, quem decide é o teste, rodado pelo próprio loop, com os arquivos de teste protegidos. Nesta aula você roda o loop-longrun.sh com um agente falso: vê concluir, vê a trapaça ser revertida e vê a trava impedir dois loops na mesma pasta, sem gastar cota.
Aula 7 · 17 minMedir a sessão: medir-sessao.py, custo de retomada e recallSem medir, "a sessão ficou cara" e "o agente esqueceu" são impressão. O kit lê as transcrições JSONL do Claude Code e do Codex e devolve duração, compactações, tokens e cache por turno, o custo real de retomar e uma busca em tudo o que já foi dito. Nesta aula você mede um caso conhecido e depois a sua maior sessão.
Aula 8 · 20 minUma execução de horas, do começo ao fimAgora junta tudo numa execução de verdade: pasta, goal nível 3, testes congelados, o modo de rodar, vigiar sem interromper, saber quando parar e fechar com medição. O piloto do kit, de 01/10/2026, serve de referência passo a passo. No fim, o mapa do curso e o seu plano com datas.
Para quem é
- 1Quem já usa Claude Code ou Codex no terminal e quer deixar uma tarefa rodando por horas.
- 2Quem já viu o agente dizer "terminei" com teste apagado, ou esquecer o que fez depois de compactar.
- 3Quem precisa rodar agente em cron ou systemd sem travar a máquina nem gastar a cota à toa.
O que você sai fazendo
- 1Criar a pasta longrun/ e escrever critérios comando → saída que cobrem função, regressão e limite.
- 2Ligar o hook de faixas de contexto e saber quando compactar, gravar handoff ou abrir sessão nova.
- 3Rodar o loop-longrun.sh com flock, timeout, MemoryMax e testes protegidos, primeiro com um agente falso.
- 4Medir a sessão, o custo de retomar e achar decisões antigas com recall.
Antes de começar
- 1Linux ou macOS com git, Python 3 e pytest; no Linux, systemd de usuário para o MemoryMax e os timers.
- 2Claude Code ou Codex instalado e entrando pela sua assinatura. As práticas de ensaio não gastam cota.
- 3Recomendado: o curso 0 (Base) para a escala de critério de pronto e o curso 1 (Verificação) para avaliadores.