IA e Automações · 18 de novembro de 2026 · 4 min
Memória para agentes de IA: o que eu guardo, onde e o que envelhece
Memória de agente é o que fica escrito em arquivo e é relido na próxima sessão. As três camadas que eu uso e o tipo de memória que mais engana agente.
- O problema
- O agente esquece o que você ensinou ontem, ou lembra de uma coisa que já deixou de ser verdade e age em cima dela.
- Para aplicar
- Crie uma pasta de lições e escreva a primeira com três partes: o que aconteceu, por que importa e como aplicar. Depois procure nas suas notas uma frase que afirma estado e confira no sistema se ainda vale.
Memória de agente de IA é o que fica escrito em arquivo e é lido de novo na próxima sessão. O modelo não lembra de uma conversa para outra; quem lembra é o texto que você deixa para ele. Eu uso três camadas: um arquivo de regras que vale sempre, uma pasta de lições com uma lição por arquivo e um diário com o que foi feito em cada dia.
E aprendi que a parte difícil é saber o que envelhece. Guardar é fácil.
As três camadas que eu uso
1. Regras. O CLAUDE.md, lido no começo de toda sessão: onde fica cada coisa e o que nunca acontece. Muda pouco, e quando muda, a decisão vai datada. Detalhei em CLAUDE.md: o que é e o que eu coloco no meu.
2. Lições. Um arquivo por aprendizado, com três partes: o que aconteceu, por que importa e como aplicar da próxima vez. Um índice com uma linha por lição é o que o agente lê primeiro, e o arquivo inteiro só é aberto quando o assunto aparece. Em 11 de novembro reescrevi esse índice para caber numa leitura: uma linha curta por tema, o detalhe no arquivo.
3. Diário. Um arquivo por dia, uma linha por tarefa, com o projeto marcado e o identificador do commit quando é código. É a memória do que foi feito, e é a que eu mais consulto.
Por baixo das três está o resto do vault: o manual de cada cliente, as decisões, as réguas de cada canal. Tudo em texto, tudo em pasta. É o que eu chamo de segundo cérebro da empresa.
O que envelhece: frase que afirma estado
Em 19 de setembro, meu agente me pediu pela terceira vez para rodar uma atualização no banco do KAI que, segundo ele, estava pendente. Ela estava aplicada desde 29 de agosto, 19 dias antes.
A origem do erro era um comentário no código, escrito com boa intenção, que dizia "não aplicada". Alguém aplicou e não atualizou o comentário. O agente leu e repetiu, três vezes, com toda a confiança.
Desde então tenho uma regra para memória: frase que afirma estado de sistema, como "está quebrado", "pendente" ou "não foi feito", vale menos a cada dia. Antes de agir sobre ela, o agente mede no sistema. Lição, decisão e motivo duram; estado, não.
O que eu guardo
- Decisão com data e motivo. "28/09: gestão só no KAI." Daqui a seis meses, quando alguém quiser mudar, o motivo está lá.
- Erro que custou caro, com o conserto. Escrito para quem vai cometer o mesmo erro.
- Correção do cliente, na régua do canal daquele cliente, no mesmo dia.
- Preferência dita uma vez. "Site minimalista, sem contador decorativo." Se eu disse, não quero ter que dizer de novo.
O que eu jogo fora
- Lista de pendência que ninguém relê. Quando medi o diário em agosto, as tarefas abertas não voltavam a ser lidas depois de escritas. Hoje a seção de próximos tem teto de três linhas, e o resto vai para um arquivo de ideias sem prazo nem dono.
- Status copiado. O status mora no sistema. A memória aponta para onde olhar.
- A mesma regra em dois lugares. Quando ela muda, uma das cópias vira mentira.
Memória também se perde
Memória em arquivo só existe enquanto o arquivo existe. Duas coisas me ensinaram isso:
- Agentes em paralelo apagando o diário um do outro ao gravar o arquivo inteiro. Hoje o diário só aceita acréscimo, por um script que se recusa a gravar se alguma linha antiga fosse sumir. Contei em Subagentes no Claude Code.
- Pasta de texto sem cópia fora do computador. O vault passou a ter histórico versionado fora da máquina, e a regra pede para conferir se o envio está em dia antes de reorganizar qualquer coisa.
O que fazer amanhã
Crie uma pasta de lições e escreva a primeira com três partes: o que aconteceu, por que importa e como aplicar. Depois procure nas suas notas uma frase que afirma estado, como "isso está quebrado" ou "falta fazer X", e confira no sistema se ainda é verdade. Se não for, você acabou de achar o tipo de memória que mais engana agente.