Trabalho o dia inteiro com um agente de IA (no meu caso o Claude Code) e por meses vivi o mesmo atrito bobo: toda sessão eu começava do zero. Reexplicava quem eu era, como o projeto era organizado, o que a gente já tinha decidido semana passada. A IA é brilhante dentro de uma conversa e amnésica entre conversas. Fecha a janela, zera tudo.
Um dia procurei no Google por "segundo cérebro" achando que ia encontrar como resolver isso. Só achei o de sempre: método PARA, Notion, Obsidian, segundo cérebro pra humano anotar. Nada sobre dar memória a um agente. Então parei de procurar e construí o meu. Este post é o padrão que sobrou depois de arrumar a casa umas três vezes, generalizado, pra você adaptar. No fim tem um template pra baixar.
O problema: janela de contexto não é memória
A confusão começa aqui, então vale separar:
- Janela de contexto = a memória de curto prazo de uma conversa. É enorme hoje, mas é volátil: acabou a sessão, evaporou.
- Memória persistente = conhecimento que vive fora da conversa, em arquivos. O agente lê no começo de cada sessão e escreve durante o trabalho. Sobrevive.
Copiar e colar o contexto no início de cada conversa "resolve", do mesmo jeito que anotar telefone na palma da mão resolve. Não escala, e você esquece metade. O que escala é dar ao agente um lugar fixo, versionado, de onde ele mesmo lê e pra onde ele mesmo escreve.
A arquitetura em 3 camadas
Depois de tentativa e erro, o formato que se mostrou robusto tem três camadas, do geral pro específico:
Regras globaisQuem você é, como gosta de trabalhar, o que a IA nunca deve fazer. Vale pra todo projeto. No Claude Code é o CLAUDE.md global. É o "sistema operacional" do agente.
Memória por projetoOs fatos que só valem aqui: decisões de arquitetura, regras de negócio, o estado de cada frente. Um fato por arquivo, fácil de atualizar e apagar sem mexer no resto.
O índiceUm arquivo enxuto, uma linha por fato, carregado toda sessão. É o mapa: a IA lê o índice, decide o que é relevante e só então abre o fato inteiro. Barato de manter na cabeça.
A sacada da camada 3 é econômica: o índice é pago em tokens toda sessão. Se ele for um parágrafo por fato, você queima contexto à toa. Uma linha por fato mantém o mapa leve e deixa o detalhe pra quando (e se) for preciso.
Durabilidade: versione, mas por whitelist
Memória boa é memória que não se perde quando o HD morre e que te acompanha entre máquinas. A resposta é velha e chata: git. Você comita o cérebro num repositório privado e espelha na nuvem. Trocou de máquina? git clone e o agente já sabe tudo.
Mas tem uma armadilha de segurança que quase todo mundo cai. Se você versiona por blacklist (ignora .env, ignora *.key...), basta esquecer um padrão pra vazar um segredo no repositório. A inversão salva sua pele: ignore tudo por padrão e libere só o conhecimento.
# ❌ blacklist — perigoso: esqueceu um padrão, vazou
# .env
# *.key
# ✅ whitelist — ignora TUDO, libera só o que é conhecimento
*
!*/
!**/*.md
!.gitignoreCom whitelist, um arquivo com segredo criado por engano simplesmente não entra. O git nem olha pra ele. Credencial fica no .env (fora do versionamento). E se você trabalha com dado de cliente, ergue uma parede dura: o dado e o código do cliente vivem só na infra dele; no seu cérebro pessoal entra, no máximo, o aprendizado destilado, nunca o dado bruto.
As lições que o Google não te conta
- Memória é foto do passado, não estado vivo. O que está escrito era verdade quando foi escrito. Antes de agir com base numa memória, a IA confirma no código/na realidade. Senão ela repete com confiança um fato que já mudou.
- Um fato por arquivo. Atualizar é abrir um arquivo, não caçar um parágrafo no meio de um documento gigante. E dá pra apagar o que ficou errado sem medo.
- Condense o que terminou. História concluída não precisa dos 12 passos. Vira um resumo de uma linha ("feito: X resolvido em tal data"). O cérebro fica magro.
- O índice é sagrado. Ele é o único que a IA lê sempre. Mantê-lo curto e honesto é o que faz o sistema todo funcionar sem torrar contexto.
O template pra você começar hoje
Pra você não montar do zero, deixei um esqueleto sanitizado, o mesmo formato que eu uso, sem nada específico meu. Baixe, renomeie os placeholders e você tem um cérebro funcionando em 10 minutos.
CLAUDE.md— esqueleto das regras globais (camada 1)MEMORY.md— um índice de exemplo (camada 3).gitignore— a whitelist pronta (durabilidade segura)README.md— como plugar e o ritual de sincronizar entre máquinas
É texto puro. Abra, leia e adapte ao seu jeito. Também está na minha Biblioteca, junto de outros recursos grátis.
Em resumo
Agente de IA não tem que ser amnésico. Dá pra ele um segundo cérebro: três camadas (regras globais · memória por projeto · índice), versionado por git com whitelist pra não vazar segredo, portátil entre máquinas. Não é mágica. São arquivos de texto bem organizados e uma disciplina simples de manter. Mas a diferença no dia a dia é enorme: você para de reexplicar e começa a construir de onde parou.
Leitura relacionada: O que são skills de IA. A memória é metade do que torna um agente útil; as skills são a outra metade (o que ele sabe fazer). Ambos fazem parte do guia Como trabalhar com um agente de IA.
Quero um sistema sob medida pro meu negócio
É o que eu faço: transformo o problema do seu negócio em software, com IA aplicada ao negócio, automação e obsessão por segurança. Se isso faz sentido pro seu caso, bora conversar.