Hooks, memoria y aprendizaje continuo en ECC: sesiones de Claude Code que no olvidan
Los hooks de ECC son comandos que Claude Code ejecuta solos en momentos fijos (al empezar la sesión, antes de editar un archivo, antes de compactar, al terminar) para comprobar calidad, guardar el estado y aprender de lo que haces. El perfil core registra 28; con /save-session y /resume-session retomas el trabajo al día siguiente y el aprendizaje continuo convierte tus correcciones en "instincts".
Esta es la parte 6 de la guía completa de ECC. Aquí verás qué hooks instala, una prueba real de GateGuard (el hook que obliga a pensar antes de editar), cómo funciona la memoria entre sesiones y cuándo conviene activar el aprendizaje continuo.
Qué es un hook (y por qué importa más que un prompt)
Un prompt le pide algo al modelo; un hook lo hace cumplir. Es un comando que corre fuera del modelo en un evento de Claude Code:
| Evento | Cuándo corre | Puede bloquear |
|---|---|---|
| `SessionStart` | Al abrir la sesión | No |
| `UserPromptSubmit` | Antes de que Claude lea tu mensaje | Sí |
| `PreToolUse` | Antes de usar una herramienta (Bash, Edit…) | Sí (código de salida 2) |
| `PostToolUse` | Después de usarla | No, pero devuelve avisos |
| `PreCompact` | Antes de compactar el contexto | No |
| `Stop` / `SessionEnd` | Al terminar cada respuesta o la sesión | No |
Como ejecutan comandos en tu máquina, ECC no los activa sin preguntar: si el perfil los incluye y no pasas --enable-hooks o --no-hooks, el instalador se detiene.
Los 28 hooks del perfil core
Instalamos el perfil core con hooks en un HOME vacío y contamos lo que quedó registrado en ~/.claude/settings.json:
npx ecc-universal@2.2.3 install --profile core --target claude --enable-hooksLos más útiles según su documentación (hooks/README.md):
- Antes de Bash: bloquea
npm run devfuera de tmux para no perder los logs, recuerda revisar antes degit pushy pasa comprobaciones antes degit commit(lint de lo preparado, formato del mensaje,console.logolvidados). - Después de editar: formatea con Prettier, ejecuta
tsc --noEmiten archivos.tsy avisa deconsole.log. - Ciclo de vida: carga el contexto anterior al empezar, guarda el estado antes de compactar y resume la sesión al terminar.
Prueba real: GateGuard frena la primera edición
El hook más llamativo es GateGuard ("Fact-Forcing Gate"). La primera vez que el agente edita un archivo en una sesión, le niega la edición y le pide que diga qué partes del código dependen del cambio y cuál fue tu instrucción literal. Solo entonces deja pasar.
Le pedimos un cambio trivial a la API de la parte 3 con los hooks de ECC activos:
Cambia server.js para que el puerto salga de process.env.PORT con 3000 por defecto. Luego ejecuta npm test.Resultado: el primer Edit fue denegado, el agente justificó el cambio, lo reintentó y pasó; los 19 tests siguieron en verde. Tardó 17,5 segundos y el CLI reportó 0,08 USD. El propio agente lo contó al final: "la primera edición la bloqueó un hook que pedía justificar el cambio".
¿Vale la pena? El CHANGELOG de ECC es honesto: en su piloto de 72 sesiones el gate costó un 45 % más de turnos y no pudo medir si mejora el resultado, porque todas las variantes resolvieron todas las tareas. Nuestra opinión: actívalo en archivos sensibles (auth, pagos, migraciones, workflows de CI), donde ECC ya lo aplica con más rigor, y desactívalo si te estorba con:
export ECC_GATEGUARD=offControlar los hooks sin editar JSON
ECC lee variables de entorno para ajustar sus hooks:
export ECC_HOOK_PROFILE=standard # minimal | standard | strict
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"
export ECC_SESSION_START_MAX_CHARS=4000 # menos contexto al empezar
export ECC_CONTEXT_MONITOR_COST_WARNINGS=offminimal deja solo los hooks esenciales de ciclo de vida y seguridad; strict añade más recordatorios. Si usas el plugin, cambia el perfil con npx ecc-universal@2.2.3 setup --mode claude-plugin.
Memoria entre sesiones: /save-session y /resume-session
/save-session escribe un archivo con fecha en ~/.claude/session-data/ (por ejemplo 2026-11-22-a1b2c3d4-session.tmp) con lo que se construyó, qué funcionó, qué falló y qué queda. El comando exige rellenar todas las secciones, aunque sea con "Nada todavía", porque "un archivo incompleto es peor que una sección vacía y honesta".
Al día siguiente, /resume-session carga el más reciente y sigues donde lo dejaste. Úsalo:
- Al cerrar Claude Code al final del día.
- Antes de llegar al límite de contexto: guarda, abre sesión nueva y retoma.
- Después de resolver algo difícil que quieres recordar.
Si quieres profundizar en cómo dar memoria persistente al agente con archivos del proyecto, el capítulo 6 de la guía Claude Code de cero a producción lo explica paso a paso.
Aprendizaje continuo: de correcciones a instincts
La skill continuous-learning-v2 observa tus sesiones con hooks y extrae instincts: comportamientos pequeños con un disparador, una acción y una confianza entre 0,3 (tentativo) y 0,9 (casi seguro).
id: prefer-functional-style
trigger: "when writing new functions"
confidence: 0.7
scope: projectDesde la v2.1 son por proyecto (los patrones de tu app de React no contaminan la de Python) y se promueven a globales cuando aparecen en 2 o más proyectos. Los comandos:
| Comando | Qué hace |
|---|---|
| `/instinct-status` | Lista los instincts del proyecto y globales con su confianza |
| `/evolve` | Agrupa instincts y propone skills, comandos o agentes nuevos |
| `/promote` | Pasa instincts del proyecto a globales |
| `/prune` | Borra los pendientes de más de 30 días sin promover |
| `/learn-eval` | Extrae un patrón de la sesión, lo evalúa y decide si guardarlo global o en el proyecto |
Dos avisos: el observador en segundo plano viene desactivado (observer.enabled: false) y no funciona en Windows nativo (necesita WSL2, Linux o macOS). Empieza por /learn-eval a mano al final de una sesión productiva; activa el observador solo cuando veas que te aporta.
Errores frecuentes
- Hooks duplicados: tienes el plugin y además copiaste
hooks.jsonasettings.json. Bórralos desettings.json. npm run devbloqueado: es el hook que impide arrancar servidores de desarrollo fuera de tmux, para que el agente pueda leer los logs. Arráncalo dentro de tmux, como pide el aviso.- Sesiones que empiezan lentas o con mucho contexto: baja
ECC_SESSION_START_MAX_CHARSo ponECC_SESSION_START_CONTEXT=off.
Conclusión
Los hooks son lo que convierte las reglas de ECC en hábitos que se cumplen solos, y /save-session es la forma más barata de no empezar de cero cada mañana. Activa el perfil standard, prueba GateGuard una semana y decide. En la parte 7 vemos cómo medir y recortar el contexto que todo esto ocupa.
// código fuente
Nos ayuda a crecer
codigoagente es gratis y sin muros de pago. Si este artículo te sirvió, cualquiera de estas cosas mantiene el blog en marcha.
- Compártelo con alguien a quien le sirvaWhatsAppLinkedInXFacebook
- Llévate el kit para agenciasVer qué incluyeComprar
- Conoce a nuestro patrocinadorSafe Build Labs
Más sobre Agentes de IA

- Skills para tus agentes
- Claude Code

guía · Guía de psicología para marketing con agentes de IA · #3
- Skills para tus agentes
- Claude Code

guía · Guía de psicología para marketing con agentes de IA · #2
- Skills para tus agentes
- Claude Code