| 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.
- Objetivo — qué se está haciendo y por qué (el resultado buscado).
- 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).
- Estado del código — archivos tocados (rutas exactas), cambios clave, qué quedó sin commitear, en qué rama.
- Próximos pasos — lista ordenada y accionable; el primero, ejecutable de inmediato.
- Decisiones y suposiciones — qué se decidió y por qué (para no re-litigar), qué alternativas se descartaron.
- 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.
