Plantilla de handoff de sesión en Claude Code: deja contexto útil para otra persona o agente

Claude Code mejora cuando una sesión puede sobrevivir al handoff

Muchos fallos vienen de perder contexto entre sesiones. Una nota de handoff permite que otra persona, o tú mañana, retome el trabajo sin adivinar.

Este artículo conecta el runbook de primera tarea con la plantilla de bug report.

Plantilla de handoff para copiar

# Claude Code Handoff

## Goal
- Objetivo de hoy:
- No hacer hoy:

## Current state
- branch:
- last commit:
- dirty files:
- URLs relacionadas:

## What changed
- Cambios:
- Archivos tocados:
- Intención:

## Verification
- Comandos ejecutados:
- Resultado:
- Revisión visual:

## Risks
- Zonas frágiles:
- No tocar:
- Sin verificar:

## Next prompt
En la próxima sesión, empieza con git status y el diff reciente.
Confirma que no contradicen este handoff antes de editar.

Buen ejemplo

## Goal
- Añadir enlaces internos desde /en/products/ a los 3 artículos del 25/5
- No cambiar la estructura de pricing hoy

## Verification
- npm.cmd run build: correcto
- production /en/products/: 200
- mobile 390px: sin overflow horizontal

## Risks
- Gumroad link prioriza la versión en inglés
- Revisar cuerpos no ingleses en URL pública

Omisiones comunes

• Escribir solo “build OK” sin URL pública
• Dejar dirty files sin explicación
• Ocultar pendientes con “parece bien”
• No dejar el siguiente prompt

Un handoff no es un diario. Debe permitir reiniciar en 5 minutos.

Siguiente paso

Para uso individual, fija el checklist con el cheatsheet gratuito. Para equipos, combina Setup Guide y Prompt Templates. Para adopción guiada, visita consultoría.

El handoff debe ser más completo que un commit message y más corto que un diario

La nota de handoff es dato operativo. Un commit message no suele incluir verificación ni riesgos; un diario es demasiado largo. Guarda estado actual, motivo del cambio, verificación, zonas frágiles y el siguiente prompt.

Revisa este handoff:
1. no contradice git status
2. el motivo del cambio cabe en una frase
3. build y URL pública están separados
4. los riesgos no verificados están explícitos
5. el siguiente prompt permite reiniciar

En un sitio multilingüe, registra URL pública, idioma, ancho móvil y estado de CTA. Un build correcto no prueba que la página visible para usuarios sea correcta.