Ideia principal

O Claude Code já guarda uma memória do que dissemos a ele, mas a coloca em ~/.claude/projects/: ela pertence à instalação, não ao projeto. Trocar de computador, reler essa memória, saber quando tal decisão entrou ali, compartilhá-la com um colega — nada disso está previsto, porque o lugar de armazenamento nunca foi pensado como objeto de trabalho.

Escrever essa mesma memória em arquivos Markdown depositados no meio do repositório git do projeto muda quatro coisas de uma vez, e todas vêm do mesmo gesto. Ela se desloca com o repositório, então um clone em outra máquina a reencontra. Ela é versionada, então git log memory_sessions/ conta a evolução das decisões técnicas. Ela abre no editor, então você pode corrigi-la à mão quando o agente entendeu errado. E ela se divide como o repositório se divide.

O formato plano não é uma renúncia técnica enquanto algo melhor não vem: é o que torna a memória inspecionável por um humano, e uma memória que nenhum humano relê nunca é corrigida.

Camada trazida por "Os sistemas de informação não vão desaparecer. A forma deles é que vai mudar." (2026-07-08). A mesma divisão vale na escala de uma empresa, e ali o formato pesa ainda menos do que se imagina: Markdown, JSON, base documental, grafo ou base vetorial servem igualmente bem, a linha passa entre o que é deslocável e o que não é. Uma inteligência de trabalho que ficou em históricos de conversa só é útil enquanto a interface existir, enquanto a assinatura estiver ativa e enquanto você achar a conversa certa: isso é um rastro de uso, não uma memória de empresa. O critério que separa é uma lista de operações, não uma preferência estética — poder ser relida por um humano, retomada por outra IA, deslocada, salva, enriquecida, auditada.

Por que isso importa

Isso desloca a pergunta que fazemos diante de uma ferramenta de memória. Normalmente perguntamos o que ela retém; a pergunta que importa primeiro é onde ela escreve, porque é essa escolha que decide todo o resto — portabilidade, histórico, releitura, compartilhamento.

Isso também explica por que uma memória nativa, mesmo boa, deixa uma falta: o que vive dentro da ferramenta está fora do alcance das ferramentas com as quais realmente trabalhamos.

Nuances e limites

Colocar a memória no repositório a torna visível para todos que têm acesso ao repositório. O que é escrito ali automaticamente — o nome de um cliente, um erro cometido, uma hesitação — vira conteúdo publicado na escala do time, sem que ninguém tenha revisado.

E um arquivo versionado fica difícil de reler quando cresce: a inspecionabilidade depende tanto do tamanho quanto do formato.

Questões em aberto

• O que fazer com a memória de um branch abandonado, que foi escrita mas cujo trabalho nunca foi integrado?