Memória de Loop
Memória verbal estilo Reflexion: o agente reflete sobre cada tentativa por escrito, armazena a reflexão e lê reflexões recentes antes de agir. Pesquisas (Shinn et al., 2023) mostram que esse mecanismo — refletir, armazenar, reler — supera repetições cegas por ampla margem (+22% em tarefas de decisão em 12 tentativas, +11% em código) e supera memória sem reflexão em 8 pontos. O ganho vem de razões escritas, não de tentar com mais força.
O protocolo
Antes de agir (a cada tarefa)
- Leia
.loop/LESSONS.md. - Aplique a seção Regras permanentes incondicionalmente.
- Leia as 3 entradas mais recentes. Se alguma for relevante para a tarefa atual, declare em uma linha como ela muda sua abordagem. Se nenhuma for relevante, prossiga — não force.
Depois de agir (a cada tentativa, sucesso ou falha)
Adicione exatamente uma entrada no formato do arquivo:
## [data] — [tarefa, máx. 5 palavras] — SUCESSO|FALHA
- O que aconteceu: [uma linha]
- Causa raiz / por que funcionou: [uma linha]
- Da próxima vez: [uma instrução específica e verificável]
Padrão de qualidade para "Da próxima vez":
- ❌ "Ser mais cuidadoso com o banco de dados" — não verificável
- ✅ "Execute
npx prisma migrate deployantes de qualquer script de seed" — verificável - ❌ "Lembre-se que a API é complicada" — vago
- ✅ "O endpoint /users pagina em 50; sempre passe ?page= ao contar"
Reflexão sobre falha, especificamente
Quando uma tentativa falhou, a reflexão deve responder: o que eu acreditava que estava errado? Tentativas fracassadas geralmente vêm de uma suposição falsa, não de um erro de digitação. Nomeie a suposição. Essa é a lição.
Manutenção (quando o arquivo excede ~30 entradas)
- Leia todas as entradas da mais antiga para a mais nova.
- Qualquer lição que aparecer 2+ vezes é promovida para Regras permanentes, reescrita como uma única linha imperativa.
- Apague as 20 entradas mais antigas após a promoção.
- Nunca apague Regras permanentes sem a aprovação do usuário.
O que NÃO armazenar
- Segredos, chaves, tokens, dados pessoais — nunca, mesmo que tenham causado a falha.
- Narração ("Então tentei X, depois do qual Y…") — armazene apenas conclusões.
- Lições duplicadas — se já estiver lá, não adicione novamente; considere promovê-la.
- Culpa ou autocrítica — lições são instruções, não sentimentos.
Modos de falha a evitar
- Teatro da memória: escrever entradas, mas nunca lê-las. A etapa de leitura é o valor; a etapa de escrita sozinha é um diário.
- Superajuste a um incidente: um soluço ambiental isolado não é uma lição. Se não pode se repetir, não o registre.
- Crescimento ilimitado: um arquivo de 200 entradas que ninguém lê é memória morta. Comprima.