¿Qué hace handoff (transferencia de contexto)?
Escribe un documento de transferencia que permita a un agente nuevo continuar este trabajo sin tener que releer toda la conversación. Captura el estado y la intención, no una transcripción.
Dónde guardar
Guarda la transferencia dentro del repositorio del proyecto actual — nunca en el directorio temporal del sistema operativo, ni en línea dentro del chat.
- Resuelve la raíz del repositorio: ejecuta
git rev-parse --show-toplevel. Si falla (no es un repositorio Git), usa como fallback el directorio de trabajo actual. - Asegúrate de que exista un directorio
handoffs/en esa raíz; créalo si falta. - Escribe en
handoffs/<slug>-handoff-<marca-de-tiempo-UTC>.md, donde:<slug>es un tema corto en kebab-case derivado de la tarea (o de los argumentos, si se pasaron), por ejemplonotebook-proxy-review.<marca-de-tiempo-UTC>tiene el formatoYYYYMMDDTHHMMSSZ, por ejemplo20260527T144059Z. La marca de tiempo mantiene cada transferencia distinta — nunca sobrescribas una transferencia existente.
- Después de escribir, imprime la ruta absoluta del archivo que creaste.
Qué escribir
Si se pasaron argumentos a esta habilidad, trátalos como el enfoque de la siguiente sesión y orienta cada sección hacia ellos.
Usa estas secciones. Mantén cada una dentro de su límite; una transferencia es un documento de referencia, no un registro de todo. Omite cualquier sección que esté genuinamente vacía en lugar de rellenarla.
- Encabezado — título, fecha (UTC) y una línea sobre para qué sirve la siguiente sesión. (≤5 líneas)
- Objetivo — la meta y su criterio de éxito. (≤3 oraciones)
- Estado actual — qué está hecho, qué funciona, qué está verificado vs. supuesto. (≤10 viñetas)
- Próximos pasos — acciones concretas y ordenadas para el siguiente agente. (≤8 viñetas)
- Decisiones clave y justificación — elecciones ya fijadas y por qué, para que el siguiente agente no las reabra. (≤8 viñetas)
- Advertencias / minas terrestres — trampas ya encontradas, sorpresas, cosas que parecen hechas pero no lo están. (≤8 viñetas)
- Archivos y referencias relevantes — rutas y URLs a código, PRDs, planes, diffs, issues. Refiérelos; no incrustes su contenido. (≤12 entradas)
- Preguntas abiertas — decisiones sin resolver que necesitan al usuario o trabajo adicional. (≤6 viñetas)
- Habilidades sugeridas — habilidades que el siguiente agente debería invocar, cada una con una línea de por qué. (≤6 entradas)
Reglas
- No dupliques contenido ya capturado en otros artefactos (PRDs, planes, ADRs, issues, commits, diffs). Refiérelos por ruta o URL.
- No pegues contenidos grandes de archivos o salidas completas de comandos en la transferencia. Apunta a la fuente.
- Redacta secretos e información de identificación personal (PII) — cualquier cosa que coincida con API_KEY / SECRET / TOKEN / PASSWORD / PRIVATE_KEY o datos personales. Las rutas de archivos locales están bien.