Transferencias de Agentes y Protocolo de Estado

1. Visión general del concepto y problema sistémico

En procesos de ingeniería complejos, un solo modelo no puede abordar adecuadamente todas las etapas: la planificación requiere reflexión filosófica, la escritura de código — un conocimiento riguroso de la sintaxis, y la revisión de código — un escepticismo minucioso.

Si se intenta mantener todo en una larga sesión, surge la "contaminación de la persona" (Persona Pollution): el modelo comienza a alabar su propio código o se confunde con sus propias instrucciones contradictorias.

El Protocolo de Handoff de Agentes es un mecanismo de transferencia controlada del "testigo" entre entidades autónomas. Al igual que los médicos transfieren el historial del paciente durante un cambio de turno, un agente forma un resumen concentrado del estado y delega el control al siguiente especialista.

2. Taxonomía arquitectónica y modelo mental

┌─────────────────────────────────────────────────────────────┐
│                 MAQUINA DE ESTADO DE HANDOFF DE AGENTES     │
├─────────────────────────────────────────────────────────────┤
│ AGENTE A: ARQUITECTO (Explora, Investiga, Genera Especificación) │
│   • Genera: specification.md & checklist                     │
├─────────────────────────────────────────────────────────────┤
│                          │                                  │
│                          ▼ PAQUETE DE HANDOFF               │
│   ┌─────────────────────────────────────────────────────┐   │
│   │ • ID del Agente Anterior: architect-01              │   │
│   │ • Objetivo: Implementar rutas API según especificación │   │
│   │ • Restricciones Clave: Usar validación Zod, sin      │   │
│   │ • Punteros de Artefactos: ["/docs/spec.md"]          │   │
│   │ • Presupuesto de Tokens Restante: 15,000              │   │
│   └─────────────────────────────────────────────────────┘   │
│                          │                                  │
│                          ▼                                  │
│ AGENTE B: CODIFICADOR (Ventana de Contexto Nueva, Lee Especificación y Codifica) │
│   • Cero Deriva de Persona, Alcance de Atención Limpio     │
└─────────────────────────────────────────────────────────────┘

3. Pipeline técnico y mecánica interna

Estructura del paquete de transferencia de contexto (Handoff Payload):

interface AgentHandoffPacket {
  sessionId: string;
  sourceAgent: string;
  targetAgent: string;
  taskSummary: string;
  resolvedContext: {
    userIntent: string;
    acceptedDecisions: string[];
    rejectedApproaches: string[];
  };
  artifactPaths: string[];
  returnOnCompletion: boolean;
}

• Corte de Contexto (Context Slicing): En lugar de 50 mensajes de chat, el nuevo agente recibe 300 palabras de un resumen concentrado, garantizando la máxima precisión en el enfoque de atención del transformador.
• Idempotencia y Rejugabilidad: El paquete de handoff se almacena en la base de datos, permitiendo reiniciar el trabajo del agente ejecutor en caso de fallo sin volver a pasar por fases anteriores.

4. Escenarios prácticos de ingeniería en producción

01. Pipeline desde el briefing del cliente hasta el despliegue

1. Un Discovery Agent realiza una entrevista con el usuario, genera la especificación y hace un handoff al DB Architect Agent.
2. El DB Architect Agent crea el esquema de la base de datos, las migraciones y transfiere el control al Backend Agent.
3. El Backend Agent genera servicios e inicia un handoff al Security Audit Agent.

02. Escalación a humano (Agent-to-Human Handoff)

Si un agente se encuentra con un problema que no puede resolver después de 3 intentos, forma un Handoff Packet para un ingeniero en vivo en Slack o Discord con una descripción precisa del problema, registros y dos botones para elegir la acción a seguir.

03. Transferencia de tareas entre subagentes

Un agente principal delega tareas a subagentes especializados, asegurando que cada subagente reciba un Handoff Packet que contenga solo la información relevante para su tarea específica, minimizando la sobrecarga de contexto.

5. Errores comunes, trampas y seguridad

• Teléfono Roto (Broken Telephone): Si el agente iniciador acorta el contexto de manera demasiado agresiva, el siguiente agente puede perder un detalle crítico (por ejemplo, una versión específica de una biblioteca).
• Sesiones Huérfanas (Orphaned Sessions): Un agente ha transferido una tarea, pero el agente objetivo falla con un error OOM. Es necesario tener un mecanismo de Heartbeat y timeouts que devuelvan la tarea al gestor en caso de silencio.