~/codigoagente
Agentes de IA

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:

EventoCuándo correPuede bloquear
`SessionStart`Al abrir la sesiónNo
`UserPromptSubmit`Antes de que Claude lea tu mensajeSí
`PreToolUse`Antes de usar una herramienta (Bash, Edit…)Sí (código de salida 2)
`PostToolUse`Después de usarlaNo, pero devuelve avisos
`PreCompact`Antes de compactar el contextoNo
`Stop` / `SessionEnd`Al terminar cada respuesta o la sesiónNo

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:

terminalsh
npx ecc-universal@2.2.3 install --profile core --target claude --enable-hooks
28 hooks en 8 eventos tras instalar el perfil core · codigoagente

Los más útiles según su documentación (hooks/README.md):

  • Antes de Bash: bloquea npm run dev fuera de tmux para no perder los logs, recuerda revisar antes de git push y pasa comprobaciones antes de git commit (lint de lo preparado, formato del mensaje, console.log olvidados).
  • Después de editar: formatea con Prettier, ejecuta tsc --noEmit en archivos .ts y avisa de console.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:

snippettext
Cambia server.js para que el puerto salga de process.env.PORT con 3000 por defecto. Luego ejecuta npm test.
GateGuard negó la primera edición; tras justificarla, pasó y los 19 tests siguieron en verde · codigoagente

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:

terminalsh
export ECC_GATEGUARD=off

Controlar los hooks sin editar JSON

ECC lee variables de entorno para ajustar sus hooks:

terminalsh
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=off

minimal 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).

snippetyaml
id: prefer-functional-style
trigger: "when writing new functions"
confidence: 0.7
scope: project

Desde 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:

ComandoQué 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.json a settings.json. Bórralos de settings.json.
  • npm run dev bloqueado: 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_CHARS o pon ECC_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

Repositorio del artículo
El código del que habla este artículo es público: revísalo, dale una estrella o clónalo desde aquí.

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.

// newsletter

Un correo a la semana con los repos que valen la pena

Los artículos nuevos de la semana, probados con código real. Sin spam; te das de baja con un clic.

rea-video es una skill Apache-2.0 que desmonta un vídeo plano a plano: si es real, IA o código, voz, música, subtítulos y cómo rehacerlo. Prueba real y costos.
  • Skills para tus agentes
  • Claude Code
leer artículo
Agentes de IA

guía · Guía de psicología para marketing con agentes de IA · #3

Parte 3 de la guía: anclaje, decoy, paradoja de la elección, Hick's Law y activation energy aplicados a la página de precios, con ejemplos reales.
  • Skills para tus agentes
  • Claude Code
leer artículo
Agentes de IA

guía · Guía de psicología para marketing con agentes de IA · #2

Parte 2 de la guía: autoridad, compromiso, escasez real y framing con la skill marketing-psychology, con fragmentos reales reescritos del blog codigoagente.
  • Skills para tus agentes
  • Claude Code
leer artículo