Camadas de memória

Problema

Claude não tem memória entre sessões. Cada conversa começa do zero: quem você é, o que está tocando, como você gosta de trabalhar. Você re-explica tudo, várias vezes por dia, sem perceber que esse é o custo escondido do uso casual de IA. O atrito acumula.

A solução não é a memória nativa do Claude, que é limitada e opaca. É uma pasta de arquivos que o agente lê no início de cada sessão. Três arquivos. Cada um responde uma pergunta diferente.

Técnica

O sistema tem três arquivos na raiz da pasta de trabalho, cada um com uma função distinta:

CLAUDE.md: Comportamento (regras estáveis). Responde: “Como você quer que eu trabalhe?” Suas preferências, regras de comportamento, e um mapa de roteamento. Muda raramente. Pensa nele como uma constituição: vale em toda sessão. Exemplos do que vai aqui: “nunca use travessão”, “antes de produzir texto em meu nome, leia voice-principles.md”, “quando eu disser ‘lembre disso’, escreva no MEMORY.md imediatamente”.

MEMORY.md: Estado do mundo (fatos mutáveis). Responde: “O que está acontecendo no seu mundo?” Projetos ativos, contatos importantes, decisões recentes. O Claude atualiza automaticamente conforme você ensina coisas. Teto de 150 linhas: se ultrapassar, comprime entradas verbosas ou arquiva as obsoletas. Exemplos do que vai aqui: “projeto X está na fase Y”, “minha parceira cuida do processo Z”, “setup do sistema feito em [data]”.

INDEX.md: Mapa de recursos (catálogo do que existe). Responde: “O que existe na sua pasta?” Uma linha por arquivo de referência. O Claude carrega esse mapa no início e só abre o arquivo completo quando o mapa indica relevância. Sem o INDEX.md, arquivos criados dentro de projetos ficam invisíveis pra sessões futuras.

Os três se complementam sem sobreposição. A regra de dois testes resolve qualquer dúvida de onde guardar algo:

• “Prescreve comportamento?” (sempre, nunca, antes de X faça Y) → CLAUDE.md
• “Descreve um fato que pode mudar?” (status de projeto, contato, decisão) → MEMORY.md

Como aplicar

Estrutura de empilhamento raiz → área → projeto. Cada área de vida e cada projeto pode ter seu próprio CLAUDE.md e MEMORY.md, que se somam ao raiz, nunca o substituem. Regras do raiz são como uma constituição federal. Regras das áreas somam como leis estaduais. Regras de projetos são as municipais, mais específicas ainda. O que está no raiz não precisa ser repetido em nenhum nível abaixo.

Tabela de roteamento, com exemplos genéricos. O CLAUDE.md raiz tem um Mapa de Roteamento que diz pro Claude qual pasta carregar pra cada tipo de pedido. Adicionar uma linha quando criar uma área ou projeto novo:

Como começar do zero. Crie a pasta de trabalho. Crie os três arquivos na raiz: CLAUDE.md com suas preferências e as regras de comportamento que importam, MEMORY.md com data de setup e dois ou três fatos sobre você, INDEX.md vazio com a estrutura de seções. Abra o Cowork apontado pra essa pasta e diga: “leia o setup e me ajude a montar a estrutura”. O sistema cresce conforme a necessidade aparece. Começar com tudo não é o objetivo; começar com o suficiente é.