Compactación Estratégica del Contexto

Guía de implementación para sesiones largas de Claude Code — basada en el módulo CRM de cultivaia-next como sesión de ejemplo.

Umbrales configurados para CULTIVA

160k

Primer aviso (ventana 200k)

Alerta inicial al cruzar 160,000 tokens de contexto acumulado

+60k

Intervalo de repetición

Se repite cada 60k tokens adicionales si no se compacta

Llamadas a herramientas

Señal secundaria: 50 tool calls, luego cada 25 adicionales

Sesión analizada — módulo CRM de cultivaia-next

Fase 1

Investigación

Acumulado: ~45k tokens

Docs Supabase, schema existente

ZONA SEGURA

Fase 2

Planificación

Acumulado: ~85k tokens

Tablas, endpoints API definidos

/compact AQUI ✓

Fase 3

Implementación

Acumulado: ~160k tokens

React + API routes escritas

ALERTA SCRIPT

Fase 4

Testing

Acumulado: ~210k tokens

Tests pasados, errores resueltos

/compact AQUI ✓

Fase 5

Nuevo módulo

Acumulado: ~215k tokens

Herramientas (tema nuevo)

AUTO-COMPACT RIESGO

Presión de contexto a lo largo de la sesión Ventana: 200k tokens

Investigación (45k) 22.5% usado

Tras planificación (85k) — COMPACTAR AQUÍ → reset a 17k tras /compact

/compact

Implementación (160k acumulado) — script sugiere /compact 80% — ALERTA

Fin testing (210k) sin compactar — PELIGRO REAL 105% — AUTO-COMPACT INMINENTE

Tras /compact estratégico al final de testing 8.5% — ESPACIO LIBRE PARA SIGUIENTE FASE

Tabla de decisión — flujos habituales de CULTIVA IA

Transición de fase	¿Compactar?	Por qué
Investigación → Planificación	SÍ	Los docs leídos son voluminosos; el plan es el output destilado que importa
Planificación → Implementación	SÍ	El plan ya está en TodoWrite o archivo; libera contexto para escribir código
Implementación → Testing	QUIZÁS	Mantener si los tests referencian código reciente; compactar si cambias foco
Debugging → siguiente feature	SÍ	Los stack traces y trazas de error contaminan el contexto de trabajo nuevo
Módulo CRM → Módulo Herramientas	SÍ	Cambio de dominio completo; el contexto previo es ruido puro
Mid-implementación (código parcial)	NO	Perderías nombres de variables, rutas de archivos y estado parcial
Tras enfoque fallido	SÍ	Limpia el razonamiento erróneo antes de probar una nueva aproximación
Revisión de PR → nueva sesión	SÍ	El diff y comentarios del PR ya no son relevantes para trabajo independiente

Configuración de CULTIVA IA

~/.claude/settings.json

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit",
        "hooks": [{
          "type": "command",
          "command": "node ~/.claude/scripts/
    hooks/suggest-compact.js"
        }]
      },
      {
        "matcher": "Write",
        "hooks": [{
          "type": "command",
          "command": "node ~/.claude/scripts/
    hooks/suggest-compact.js"
        }]
      }
    ]
  }
}

~/.claude/scripts/hooks/suggest-compact.js

// Variables de entorno CULTIVA
// (ventana 200k → umbral 160k)

const COMPACT_THRESHOLD = 50;
const COMPACT_CONTEXT_THRESHOLD
  = 160_000;
const COMPACT_CONTEXT_INTERVAL
  = 60_000;
const COMPACT_STATE_TTL_DAYS
  = 14;

// Leer transcript de sesión
// Sumar input_tokens +
// cache_read_input_tokens +
// cache_creation_input_tokens
// Comparar con umbral
// Si supera → sugerir /compact

Qué sobrevive a la compactación

PERSISTE tras /compact

Instrucciones en CLAUDE.md del proyecto
Lista de tareas de TodoWrite
Archivos de memoria (~/.claude/memory/)
Estado de git (commits, branches, stash)
Todos los archivos en disco
Variables de entorno configuradas
Configuración de hooks en settings.json

SE PIERDE tras /compact

Razonamientos intermedios y análisis
Contenido de archivos leídos en sesión
Contexto multistep de la conversación
Historial de llamadas a herramientas
Preferencias de usuario expresadas verbalmente
Stack traces de sesiones de debug
Resultados de búsquedas web anteriores