Comprimir archivos CLAUDE.md para reducir la hinchazón del prompt del sistema en Claude Code

Optimización del Uso del Contexto de Claude

Claude Code inyecta archivos CLAUDE.md en cada conversación como contexto del mensaje del sistema, incluyendo el CLAUDE.md a nivel de proyecto, archivos globales en ~/.claude/CLAUDE.md y archivos del sistema de memoria persistente. Cada carácter en estos archivos consume contexto que Claude procesa antes de abordar las solicitudes del usuario, lo que potencialmente reduce el rendimiento cuando la relación señal-ruido es baja.

El Enfoque de Compresión

El autor propone eliminar la decoración legible para humanos y mantener solo la señal legible para máquinas usando estas reglas:

• Eliminar la decoración de markdown: Encabezados (##), negrita (**), cursiva (*), reglas horizontales (---)
• Colapsar la prosa a notación: Usar pares clave-valor compactos o listas delimitadas por barras verticales en lugar de oraciones explicativas
• Eliminar el marco redundante: Eliminar oraciones como "Esta sección contiene..." o "La siguiente tabla muestra..."
• Deduplicar el contexto entre archivos: Mantener información idéntica en una ubicación canónica
• Comprimir el formato de tablas: Reemplazar tablas de markdown verbosas con notación compacta

Ejemplos Antes y Después

Ejemplo de Tabla de Índice de Directorios:

Antes (tabla de markdown):

## Directorios
| Directorio | Qué | Cuándo leer |
|-------------|-----------------------------|---------------------------------------|
| src/ | Código fuente de la aplicación | Trabajando en la lógica de la aplicación |
| infra/ | Archivos de Terraform y Ansible | Modificando la infraestructura |
| docs/ | Documentación de arquitectura | Comprendiendo el diseño del sistema |
| scripts/ | Scripts de despliegue y utilidades | Ejecutando o editando flujos de trabajo de despliegue |

Después de la compresión:

Dirs: src/=código fuente de aplicación | infra/=terraform+ansible | docs/=documentación de arquitectura | scripts/=scripts de despliegue+utilidades

Ejemplo de Instrucciones del Sistema de Memoria:

Antes:

## Sistema de Memoria
La memoria persistente reside en `/path/to/memory/`.
**Inicio de sesión**: Leer `memory/_index.md` para restablecer el contexto al realizar trabajo sustancial en este repositorio.
**Durante el trabajo** — Escribir en la memoria cuando ocurre algo significativo:
- Un descubrimiento o hallazgo no obvio → agregar a `memory/discoveries.md`
- Una nueva habilidad aplicada o aprendida → actualizar `memory/skills.md`

Después de la compresión:

Memory: /path/to/memory/
session-start: leer _index.md para trabajo sustancial
during-work (escribir solo en eventos significativos, señal no ruido):
discovery → agregar memory/discoveries.md
skill learned → actualizar memory/skills.md

Resultados de la Compresión

El autor logró las siguientes reducciones en los archivos:

• _index.md: 3,560 → 2,036 caracteres (reducción del 43%)
• discoveries.md: 11,260 → 5,609 caracteres (reducción del 50%)
• interests.md: 4,315 → 2,561 caracteres (reducción del 41%)
• skills.md: 16,176 → 5,353 caracteres (reducción del 67%)
• career-timeline.md: 17,882 → 5,027 caracteres (reducción del 72%)
• ~/.claude/CLAUDE.md: 2,350 → 1,495 caracteres (reducción del 36%)

Sistema de memoria total comprimido: 60,264 caracteres con aproximadamente un 60-70% de reducción en general. El CLAUDE.md del proyecto se comprimió aún más agresivamente.