Corrección de la inflación de contexto en la memoria automática de Claude Code con un esquema de nombres y script de auditoría

Un desarrollador en r/ClaudeAI compartió una habilidad práctica que aborda la deriva de memoria y la hinchazón de contexto en la memoria automática de Claude Code después de meses de uso. La habilidad impone nombres de archivo, campos de metadatos obligatorios e incluye un script de auditoría en bash para detectar problemas.

Qué hace la habilidad

La memoria automática de Claude Code (v2.1.59+) escribe markdown plano en ~/.claude/projects/<slug>/memory/. La habilidad añade estructura sobre esto: los archivos siguen la nomenclatura <type>_<topic>.md, requieren name, description, type en los metadatos, y las entradas de retroalimentación deben incluir una sección Why. La memoria automática aún escribe; la habilidad hace que Claude escriba según la especificación.

Características principales

• Revisión activada por frase: Di "Auditar memoria" para ejecutar el script de auditoría; "Revisar sesión" recorre la sesión reciente y muestra qué conservar.
• Advertencia suave: La auditoría informa deriva pero no bloquea escrituras.
• Markdown plano: Los archivos siguen siendo editables con grep, git, etc. Sin base de datos ni demonio.

Efecto en la memoria

Un tema por archivo significa que Claude acierta en la entrada correcta en la primera búsqueda. Una biblioteca desduplicada carga menos archivos por sesión, liberando contexto para el trabajo en sí.

Ejemplo de salida de auditoría

Auditoría de memoria · 2026-05-15 · 132 archivos
Verificaciones estrictas (deben ser cero):
  metadatos faltantes         0
  campos de metadatos         0
  retroalimentación sin Why   1
  violaciones de nomenclatura 0
  enlaces MEMORY.md rotos     0
Señales suaves:
  archivos sobredimensionados 78
  grupos de más de 15 entradas 3
  sin tocar en 30+ días       31
  no en MEMORY.md             0
Cumplimiento estricto: 99.2% (1 violación / 132 archivos)

Instalación

Pega en cualquier sesión de Claude Code: Instala la habilidad claude-memory-manager desde https://github.com/jau123/claude-memory-manager. Luego di "auditar memoria" para verificar.

Comparación con la memoria automática integrada

• Solo memoria automática: Sin esquema, sin auditoría. Claude decide la nomenclatura y estructura.
• Con esta habilidad: Esquema de 3 tipos + campos obligatorios + Why en retroalimentación + script de auditoría con un solo comando.

Limitaciones

• Solo alcance de proyecto único.
• Sin clasificación semántica: la auditoría solo es coincidencia de patrones.
• Script en bash; Windows/git-bash no probado.
• Excesivo para bibliotecas pequeñas (menos de ~10 entradas o 1 mes).