No pierdas tu trabajo por /clear — Conoce session-handoff

Si alguna vez has terminado una larga sesión de depuración, has pulsado /clear y, una semana después, has deseado recordar cuál de las tres opciones de base de datos había descartado el equipo — esto es para ti.

El problema es pequeño, pero caro. Trabajar con un agente de IA en un proyecto real genera una capa de conocimiento que no existe en ningún otro sitio. Por qué se rechazó una biblioteca concreta. Qué entorno de staging está roto. Qué quería decir realmente el usuario con "la puerta". No está en el código. No está en git. Está en la conversación. Y la conversación está a punto de borrarse.

La prueba de rescate

session-handoff es una pequeña Agent Skill que se ejecuta antes de limpiar. Examina la sesión en busca de hechos y aplica una pregunta decisiva:

"¿Volver a leer el repositorio recuperaría esto?"

Si la respuesta es sí, descártalo: el código es la fuente de la verdad. Si no, quizá merezca la pena guardarlo. Esa única regla heurística elimina aproximadamente el 80% de los guardados falsos y evita que el archivo de memoria a largo plazo se convierta en ruido.

Cómo funciona en la práctica

El flujo consta de siete pasos, pero la experiencia son dos: escribir un disparador como "checkpoint before clearing," revisar qué se guardaría y aprobar. Después, la skill escribe entradas estructuradas en markdown — user para rol y entorno, feedback para reglas de trabajo, project para objetivos y decisiones, reference para referencias a sistemas externos — y actualiza un archivo de índice de una sola línea para que las sesiones futuras lo carguen de forma eficiente.

Dos detalles técnicos que lo hacen realmente útil:

• Normalización de fechas. "Thursday" se convierte en 2026-05-21 en el momento de la extracción, así que la entrada sigue teniendo sentido dentro de tres meses.
• Estructura Why / How. Cada entrada de feedback o project incluye el motivo (a menudo un incidente pasado) y cuándo se aplica la regla. Eso permite que tu yo del futuro evalúe casos límite en lugar de seguir la nota a ciegas.

Quién necesita esto

Si tu trabajo toca migraciones de larga duración, despliegues con múltiples partes interesadas o cualquier cosa en la que los acuerdos verbales sobrevivan a la conversación que los produjo — esto es lo que necesitas. Leads de plataforma, SREs, ingenieros por contrato que hacen la entrega del trabajo. No porque sea ingenioso. Porque la alternativa es reconstruir lo que ya sabías, y hacerlo mal, tres semanas tarde.

El repositorio es abierto y la skill es lo bastante pequeña como para leerla de una sentada:

👉 github.com/andreab67/agent-skills/blob/main/session-handoff/SKILL.md