handoff-protocol

Handoff Protocol — Sistema de delegación entre agentes

Principio fundamental

build usa task() directo por defecto. Handoff solo cuando el contenido a transferir ya fue generado por otro agente.

Esto minimiza tokens de build (modelo API online) y mueve el costo de escritura/lectura a los modelos locales (Ollama).

Regla de decisión

build origina la tarea	→ task() directo con instrucciones inline
Subagente A produce output para subagente B	→ A escribe handoff, build pasa solo la ruta a B

Gestión de handoffs

El orquestador (build) gestiona todos los handoffs. Los agentes NO buscan ni asignan handoffs automáticamente. build indica la ruta exacta a cada agente.

⚠️ Generación de session_id con timestamp real (OBLIGATORIO)

build DEBE generar timestamps reales, NO hardcodear 000000. Para ello, build necesita permiso bash para ejecutar:

node -e "const d=new Date();const pad=n=>String(n).padStart(2,'0');console.log(pad(d.getDate())+'-'+pad(d.getMonth()+1)+'-'+String(d.getFullYear()).slice(2)+'-'+pad(d.getHours())+pad(d.getMinutes())+pad(d.getSeconds()))"

El output (ej: 09-06-26-143000) se usa como session_id. Para carpetas de agente (code-writer143000, verifier143000), se extrae HHMMSS del mismo timestamp.

Configuración necesaria en opencode-v1.json para build:

"bash": {
  "*": "deny",
  "node -e *console.log(Date.now())*": "allow",
  "node -e *new Date()*": "allow",
  "node -e *pad(Date*": "allow"
}

Estructura de directorios

/tmp/handoff/{idSession}/
  ├── (raíz, build delega a code-writer para crearla)
  ├── {agente_destino}{hh:mm:ss}/
  │   └── tarea1.json
  │   └── tarea2.json
  └── {agente_destino}{hh:mm:ss}/
      └── tarea1.json

Variable	Descripción
{idSession}	ID único DD-MM-AA-HHMMSS. Lo genera build. Conocido por todos los agentes de la sesión.
{agente_destino}	Agente que ejecutará la tarea (code-writer, verifier, qa-validator, ui-designer).
{hh:mm:ss}	Timestamp de creación. build lo usa para generar nombres de carpeta únicos y ordenar asignaciones.
tareaN.json	Archivo JSON con especificación de una tarea nuclear (unidad atómica ejecutable).