$ man how-to/parallel-session-handoffs

El patrón predeterminado de traspaso de contexto es un solo archivo en una ruta conocida. ~/.claude/context-handoff.md o similar. Cada sesión lo lee al iniciar y lo escribe al terminar. Esto funciona cuando ejecutas una terminal a la vez. Silenciosamente se rompe en el momento que ejecutas dos. La Terminal A escribe su traspaso. La Terminal B lo sobrescribe 30 segundos después. El contexto de la Terminal A desapareció y nunca lo notas porque el archivo sigue existiendo. Solo tiene el contenido equivocado. Esta es una condición de carrera de última-escritura-gana. Si ejecutas 4 a 6 terminales como yo, pierdes 3 a 5 sesiones de contexto cada día. El sistema se ve saludable porque siempre hay un archivo de traspaso ahí. El daño es invisible hasta que una sesión matutina arranca con la mitad del contexto faltando.

CODE

Paso 1: Crea el directorio. mkdir -p ~/.claude/handoffs Paso 2: Agrega la convención de nombres. Cada archivo de traspaso usa este formato: ~/.claude/handoffs/YYYY-MM-DD_HHMMSS_slug.md El timestamp tiene precisión de segundos. El slug es una descripción corta del trabajo de la sesión. Ejemplos: 2026-02-27_143022_blog-pipeline-fix.md 2026-02-27_143055_wiki-entry-batch.md 2026-02-27_144501_deploy-verification.md Paso 3: Actualiza tu CLAUDE.md con las nuevas instrucciones. Agrega estas reglas a la sección de flujo de trabajo de sesión: Al iniciar sesión: lee todos los traspasos no consumidos de ~/.claude/handoffs/. Salta cualquier archivo que termine en _done.md. Después de leer, renombra cada archivo de .md a _done.md. Al terminar sesión: escribe un nuevo traspaso a ~/.claude/handoffs/ usando la convención de nombres con timestamp. Nunca sobrescribas otro archivo.

PATTERN

Al iniciar sesión, el agente hace tres cosas en orden. Primero, lista todos los traspasos no consumidos: ls ~/.claude/handoffs/*.md 2>/dev/null | grep -v '_done.md$' Segundo, lee cada archivo y fusiona el contexto. Si hay tres traspasos no consumidos de tres terminales diferentes, la nueva sesión obtiene los tres. Nada se pierde. Tercero, marca cada archivo como consumido renombrándolo: mv file.md file_done.md El sufijo _done.md es el marcador de consumo. Las sesiones futuras saltan estos archivos. El contenido original permanece en disco para referencia. Ningún dato se elimina durante el consumo, solo se renombra. Este patrón significa que no importa cuántas terminales escribieron traspasos durante la noche. La sesión matutina lee cada uno de ellos. El contexto de todas las sesiones paralelas se fusiona en un solo punto de partida.

CODE

Los traspasos consumidos se acumulan. Sin limpieza, el directorio crece indefinidamente. Agrega un paso de limpieza que se ejecute al iniciar sesión, después de leer y consumir: find ~/.claude/handoffs -name '*_done.md' -mtime +7 -delete 2>/dev/null Esto elimina traspasos consumidos con más de 7 días de antigüedad. Los traspasos no consumidos nunca se eliminan. La ventana de 7 días te da suficiente historial para debuggear si algo salió mal. Ajusta la ventana según la frecuencia con que referencias traspasos antiguos. El bloque completo de instrucciones para CLAUDE.md: Al Iniciar Sesión: 1. Lee todos los traspasos no consumidos: ls ~/.claude/handoffs/*.md 2>/dev/null | grep -v '_done.md$' 2. También verifica la ubicación legacy: ~/.claude/context-handoff.md 3. Después de leer, marca cada uno como consumido: renombra file.md a file_done.md 4. Limpia traspasos consumidos antiguos: find ~/.claude/handoffs -name '*_done.md' -mtime +7 -delete Al Terminar Sesión: Escribe traspaso a ~/.claude/handoffs/YYYY-MM-DD_HHMMSS_slug.md. Nunca sobrescribas el traspaso de otra sesión.

PRO TIP

Mientras actualizas los traspasos, actualiza tus archivos de memoria también. El mismo problema de archivo plano aplica. Un solo MEMORY.md que cada sesión lee y escribe crecerá hasta que alcance el límite de la ventana de contexto. A más de 200 líneas, el modelo empieza a ignorar la mitad inferior. La solución es un patrón de índice. Mantén MEMORY.md como un índice liviano de menos de 200 líneas. Tiene encabezados de sección y resúmenes de una línea. Las notas detalladas viven en archivos de tema: identity.md, voice-rules.md, infrastructure.md, completed-work.md. MEMORY.md enlaza a ellos. Las sesiones solo cargan un archivo de tema cuando la tarea actual es relevante. Esto refleja cómo funciona el directorio de traspasos. En lugar de un archivo que hace todo, tienes archivos estructurados que se cargan bajo demanda. El índice siempre está en contexto. Los detalles se cargan cuando se necesitan. Ambas actualizaciones siguen el mismo principio: deja de poner todo en un archivo y empieza a usar estructura para gestionar la escala.