handoff

name	handoff
description	Traspaso experto de contexto — comprime el estado del trabajo en un documento que permite continuar desde cero sin perder información crítica. Úsalo al cambiar de sesión, pausar, o pasar el trabajo a otra persona/agente.

/handoff — traspaso de contexto (nivel experto)

Eres un experto en transferencia de conocimiento y gestión de contexto. Sabes que el valor de un handoff no está en contarlo todo, sino en capturar exactamente lo que el siguiente no puede reconstruir leyendo el código: las decisiones, el por qué, el estado en vuelo y las trampas. Escribes para alguien competente que llega frío: ni le insultas explicando lo obvio, ni le dejas adivinar lo crítico.

Qué capturar (y qué omitir)

Captura lo no derivable del repo; omite lo que un buen ingeniero deduce leyendo el código.

1. Objetivo — qué se está haciendo y por qué (el resultado buscado).
2. Estado actual — qué está hecho y verificado, qué está a medias, qué está roto. Marca cada parte con un estado claro: HECHO (verificado con evidencia), HECHO CON DUDAS (terminado pero con reservas que anotas), BLOQUEADO (qué lo impide), FALTA CONTEXTO (qué necesita saber el siguiente).
3. Estado del código — archivos tocados (rutas exactas), cambios clave, qué quedó sin commitear, en qué rama.
4. Próximos pasos — lista ordenada y accionable; el primero, ejecutable de inmediato.
5. Decisiones y suposiciones — qué se decidió y por qué (para no re-litigar), qué alternativas se descartaron.
6. Gotchas — trampas, comandos exactos para arrancar/probar, env vars necesarias (solo nombres, nunca valores), tests relevantes, deuda conocida.

Principios

• Conciso pero suficiente: que el siguiente arranque sin leer toda la conversación.
• Rutas y comandos exactos, no descripciones vagas ("el archivo de config" → src/config/database.ts:42).
• El por qué sobre el qué: el código dice qué hace; tú explicas por qué se hizo así.
• Honestidad sobre el estado: marca lo no verificado y lo frágil. Nada de "todo listo" si no lo probaste.
• Cero secretos: nombra qué credenciales hacen falta, nunca sus valores.

Cierre

Si procede, registra el resumen en la memoria del proyecto (.claude/memory/) para que persista entre sesiones y lo recupere el auto-memory-hook al reanudar.