Inicio / Una instalación estructurada

Hooks y latido

Los eventos del ciclo de vida disparan hooks según tres cadencias distintas, SessionStart y SessionEnd forman la pareja natural para automatizar el protocolo de memoria, y la consolidación nocturna sigue siendo una tarea programada del sistema operativo que hay que construir uno mismo, no un mecanismo de Claude Code documentado bajo ese nombre.

Un hook es una acción automática disparada por el harness ante un evento preciso del ciclo de vida, nunca una preferencia que el modelo elige seguir o no. La tabla de eventos disponibles se ha ampliado desde mediados de 2026, la figura que acompaña esta lección cifra el recuento exacto y su fecha de medición en lugar de repetirlo aquí.

Tres cadencias, una pareja natural para la memoria

Los eventos de hook no se disparan todos al mismo ritmo. Algunos corren una sola vez por sesión, SessionStart y SessionEnd. Otros corren una vez por turno, como UserPromptSubmit o Stop. Otros más corren en cada llamada a herramienta dentro del bucle de agente, PreToolUse y PostToolUse. Para el protocolo de memoria descrito en conectar la memoria de archivos a git, SessionStart y SessionEnd forman exactamente la pareja buscada: un hook SessionStart dispara el pull antes de la primera lectura, un hook SessionEnd dispara el commit y el push después de la última respuesta. Los hooks SessionEnd comparten entre todos un presupuesto de 1,5 segundos, un push hacia un remote distante no cabe ahí: hace falta un timeout explícito en el hook, lo que eleva el presupuesto compartido hasta sesenta segundos, y un archivo testigo escrito al final para que la sesión siguiente verifique que el push tuvo éxito en lugar de suponerlo.

{
  "hooks": {
    "SessionStart": [
      { "hooks": [{ "type": "command", "command": "cd ~/memoire && git pull", "timeout": 30 }] }
    ],
    "SessionEnd": [
      { "hooks": [{ "type": "command", "command": "cd ~/memoire && git add notes-du-jour.md && git commit -m sync && git push && date > .dernier-sync-reussi", "timeout": 55 }] }
    ]
  }
}

Dos detalles de este ejemplo cuentan tanto como el timeout. Primero, el add de git cita los archivos deseados en lugar de un git add -A que englobaría toda la carpeta sin filtro, lo que respetaría la regla fijada por la lección anterior de pasar un secreto por grep antes de todo push. Luego, la salida estándar de un hook SessionStart, como la de este git pull, entra en el contexto que Claude puede leer, a diferencia de la mayoría de los demás eventos: una carpeta compartida merece por tanto ser vigilada antes de conectar este tipo de hook. La línea de estado sigue la misma lógica de disparo automático: puede refrescarse sola en un intervalo ajustado en segundos, y no en milisegundos como un ajuste más antiguo podría dar a entender.

La consolidación nocturna sigue fuera del producto documentado

Una tarea programada del sistema operativo, que relanza Claude en modo no interactivo a medianoche para consolidar las notas del día, no tiene un equivalente documentado por Anthropic bajo ese nombre preciso: lo que la documentación llama tareas programadas corre en la aplicación de escritorio, no mediante una tarea de Windows o un cron que pilote la herramienta en línea de comandos. El gesto queda por tanto por construir uno mismo, exactamente como el protocolo de la lección anterior, con una salvaguarda explícita contra bucles: la tarea nunca relanza una nueva sesión mientras la anterior no haya escrito su testigo de fin.