softaworks/session-handoff

¿Qué hace session-handoff?

Crea documentos de transferencia completos para transferencias de sesión de agente de IA sin interrupciones. Se activa cuando: (1) el usuario solicita guardar transferencia/memoria/contexto, (2) la ventana de contexto se acerca a su capacidad, (3) se completa un hito importante de la tarea, (4) finaliza la sesión de trabajo, (5) el usuario dice 'save state', 'create handoff', 'I need to pause', 'context is getting full', (6) se reanuda el trabajo con 'load handoff', 'resume from', 'continue where we left off'. Sugiere transferencias de forma proactiva después de trabajo sustancial (múltiples ediciones de archivos, depuración compleja, decisiones de arquitectura). Resuelve el agotamiento del contexto en agentes de larga ejecución, permitiendo que agentes nuevos continúen con cero ambigüedad.

¿Cómo funciona?

1. Activación: La habilidad detecta desencadenantes explícitos (palabras clave del usuario) o implícitos (indicadores de finalización de sesión, saturación de contexto).
2. Recopilación de contexto: Recopila toda la información relevante de la sesión actual: historial de cambios, estructura del proyecto, decisiones clave, archivos afectados y estado de las tareas.
3. Generación del documento: Compila un documento de transferencia estructurado en formato Markdown (por ejemplo, HANDOFF.md) con secciones claras.
4. Persistencia: Guarda el documento en el sistema de archivos del proyecto para que otros agentes o sesiones futuras puedan cargarlo.
5. Reanudación: Cuando un nuevo agente carga la transferencia, reconstruye el contexto rápidamente y continúa el trabajo sin necesidad de repetir explicaciones.

¿Por qué es útil?

• Evita la pérdida de contexto: Las sesiones largas de agente ya no se pierden debido a la limitación de tokens.
• Colaboración entre agentes: Diferentes instancias de agentes pueden retomar el trabajo de manera eficiente.
• Continuidad: Los usuarios pueden pausar y reanudar el trabajo en cualquier momento sin perder el progreso.
• Productividad: Reduce el tiempo de preparación y la repetición de instrucciones.

Plataformas compatibles

• Claude Code
• Cursor
• Codex
• Otros agentes de IA que admitan documentos de transferencia personalizados.

Activación manual

El usuario puede activar la transferencia escribiendo comandos como:

• save state
• create handoff
• load handoff
• resume from
• continue where we left off
• context is getting full

Activación proactiva

La habilidad sugiere automáticamente la creación de una transferencia después de:

• Múltiples ediciones de archivos (por ejemplo, más de 5 archivos modificados en una sesión).
• Sesiones de depuración complejas (más de 10 llamadas a API o pasos de resolución de errores).
• Decisiones de arquitectura importantes (cambios en la estructura del proyecto o dependencias).

Formato del documento de transferencia

# Transferencia de sesión

## Contexto del proyecto
- Nombre del proyecto: [nombre]
- Estado actual: [descripción]

## Hitos alcanzados
- [ ] Tarea 1 completada
- [x] Tarea 2 en progreso

## Archivos modificados
- `path/to/file.py`
- `path/to/config.json`

## Decisiones técnicas
- Decisión 1: [explicación]

## Próximos pasos
1. Continuar con la tarea pendiente.
2. Revisar los cambios recientes.

Configuración

No se requiere configuración adicional. La habilidad funciona de manera predeterminada en cualquier proyecto de agente de IA.

Limitaciones

• Depende del sistema de archivos del proyecto para almacenar los documentos de transferencia.
• La calidad de la transferencia depende de la precisión con la que el agente recopile el contexto.

Licencia

MIT