El handoff, o traspaso entre sesiones

El cambio de turno en el hospital

Cuando una enfermera acaba su turno no le dice a la siguiente «ha ido bien». Le da una nota: qué pacientes están estables, qué se ha hecho, qué está pendiente y qué vigilar. Nadie tiene que preguntar nada.

Un handoff (traspaso) es esa nota para agentes. Si progress.md es el diario acumulado, el handoff es el resumen corto de esta sesión pensado para la siguiente. Anthropic recomienda justamente archivos de traspaso estructurados con el estado actual, los problemas conocidos y las próximas acciones.

La plantilla de cuatro bloques

La plantilla del curso (session-handoff.md) es breve a propósito. Copia esto:

# Traspaso de sesión

## Verificado ahora
- Qué funciona actualmente:
- Qué verificación se ejecutó realmente:

## Cambiado en esta sesión
- Código o comportamiento añadido:
- Cambios de infraestructura o del harness:

## Roto o sin verificar
- Defecto conocido:
- Ruta sin verificar:
- Riesgo para la próxima sesión:

## Mejor próximo paso
- Función inacabada de mayor prioridad:
- Por qué es la siguiente:
- Qué cuenta como aprobado:
- Qué no debe cambiar durante ese paso:

## Comandos
- Inicio:
- Verificación:
- Depuración enfocada:

Por qué funciona cada bloque

Verificado ahora. Separa lo que se comprobó de lo que se cree. Sin esto, la sesión siguiente tiene que volver a ejecutar todo para saber dónde está, y malgasta contexto diagnosticando desde cero.

Cambiado en esta sesión. Evita trabajo duplicado. Si el agente nuevo duda de si algo ya está hecho, lo vuelve a hacer o, peor, hace la mitad y choca con lo existente.

Roto o sin verificar. Es el bloque más honesto y el más valioso. Decir «esta ruta no la he probado» ahorra una sorpresa desagradable más adelante.

Mejor próximo paso. Con cuatro campos: qué, por qué, cómo se sabrá que está aprobado y qué no hay que tocar. El último es un cinturón de seguridad contra el «ya que estoy, arreglo también esto» que veremos en el módulo siguiente.

Comandos. Cómo arrancar, cómo verificar, cómo depurar. Así la sesión nueva no adivina.

Cómo saber si tu traspaso es bueno

La lección propone una lista de comprobación de continuidad con cuatro preguntas:

1. ¿Puede un agente nuevo identificar el trabajo reciente en menos de cinco minutos?
2. ¿Está documentada la ruta de arranque estable actual?
3. ¿Está claro qué trabajo queda sin terminar?
4. ¿Se ve la siguiente mejor tarea sin leer chats antiguos?

Si alguna respuesta es «no», el traspaso tiene un agujero.

Hasta aquí hemos cuidado la continuidad. Ahora toca el otro extremo: la primera sesión, que merece su propia fase de inicialización.