Corrigindo o Inchaço de Contexto na Memória Automática do Claude Code com um Esquema de Nomenclatura e Script de Auditoria

Um desenvolvedor no r/ClaudeAI compartilhou uma skill prática que resolve o desvio de memória e o inchaço de contexto na memória automática do Claude Code após meses de uso. A skill impõe a nomenclatura de arquivos, campos obrigatórios de frontmatter e inclui um script de auditoria em bash para detectar problemas.

O que a Skill Faz

A memória automática do Claude Code (v2.1.59+) escreve markdown simples em ~/.claude/projects/<slug>/memory/. A skill adiciona estrutura sobre isso: os arquivos seguem a nomenclatura <tipo>_<tópico>.md, exigem name, description, type no frontmatter, e entradas de feedback devem incluir uma seção Why. A memória automática ainda escreve; a skill faz o Claude escrever conforme a especificação.

Principais Funcionalidades

• Revisão acionada por frase: Diga "Audit memory" para executar o script de auditoria; "Review session" percorre a sessão recente e sugere o que manter.
• Aviso suave: A auditoria relata desvios, mas não bloqueia as escritas.
• Markdown simples: Os arquivos permanecem editáveis com grep, git, etc. Sem banco de dados ou daemon.

Efeito na Memória

Um tópico por arquivo significa que o Claude encontra a entrada correta na primeira consulta. Uma biblioteca deduplicada carrega menos arquivos por sessão, liberando contexto para o trabalho em si.

Exemplo de Saída da Auditoria

Auditoria de memória · 2026-05-15 · 132 arquivos
Verificações rígidas (devem ser zero):
  frontmatter ausente          0
  campos de frontmatter        0
  feedback sem Why             1
  violações de nomenclatura    0
  links MEMORY.md quebrados    0
Sinais suaves:
  arquivos superdimensionados  78
  grupos com mais de 15 entradas 3
  não tocados há 30+ dias      31
  não presentes no MEMORY.md   0
Conformidade com regras rígidas: 99,2% (1 violação / 132 arquivos)

Instalação

Cole em qualquer sessão do Claude Code: Install the claude-memory-manager skill from https://github.com/jau123/claude-memory-manager. Depois diga "audit memory" para verificar.

Comparação com a Memória Automática Integrada

• Apenas memória automática: Sem esquema, sem auditoria. Claude decide nomenclatura e estrutura.
• Com esta skill: Esquema de 3 tipos + campos obrigatórios + Why em feedback + script de auditoria em um comando.

Limitações

• Apenas escopo de projeto único.
• Sem ranqueamento semântico — a auditoria é apenas correspondência de padrões.
• Script em bash; Windows/git-bash não testados.
• Exagerado para bibliotecas pequenas (menos de ~10 entradas ou 1 mês).