johpaz/hive/task-orchestrator

Task Orchestrator — referencia operativa

La doctrina de orquestación (descomponer → delegar en paralelo → terminar el turno → sintetizar en el fan-in) está en tu system prompt. Esta skill es la referencia de las herramientas.

Herramientas

Fan-out

// Tres partes independientes → tres llamadas en la MISMA respuesta
task_delegate({ worker_id: "web_researcher",            task_description: "...", mode: "async" })
task_delegate({ worker_id: "office_document_agent",     task_description: "...", mode: "async" })
task_delegate({ worker_id: "schedule_automation_agent", task_description: "...", mode: "async" })

Cada llamada devuelve task_id, job_id y run_id: prueba de que la tarea quedó persistida.

Fan-in

Hive te reinvoca con:

[Sistema] Todas las tareas delegadas de este turno alcanzaron estado terminal.
[{ task_id, worker_id, task, ok, result, error }, ...]

Sintetiza una sola respuesta. Las entradas con ok: false se reportan con su motivo real.

Crear un worker (último recurso)

get_available_models({ capabilities: "analysis" })
// → [{ providerId: "anthropic", modelId: "claude-sonnet-4-6", ... }]
agent_create({
  name: "data_analyst",
  description: "Experto en análisis de datos",
  system_prompt: "Sos analista de datos experto...",
  tools_json: ["web_search", "web_fetch", "save_note"],
  providerId: "anthropic",   // OBLIGATORIO
  modelId: "claude-sonnet-4-6", // OBLIGATORIO
})

Para una integración MCP sin especialista, pide autorización primero. Si el usuario acepta, crea un worker con mcp_server_id; si participan varios servidores, crea o reutiliza uno por servidor. Nunca pases servidores MCP dinámicos a task_delegate.

Errores a evitar

• ❌ Serializar tareas independientes en vez de fan-out paralelo
• ❌ Polling con task_status esperando el resultado — el fan-in llega solo
• ❌ Declarar éxito antes de recibir el [Sistema], o presentar ok=false como éxito
• ❌ Reportar éxito sin revisar acceptance/checks de la entrega, o ignorar un checks.status="failed"
• ❌ Corregir a mano lo que task_revise puede reencolar en el mismo worker
• ❌ Crear un worker que el catálogo ya cubre
• ❌ Delegar saludos, preguntas simples o la conversación
• ❌ Usar delegate_task, find_agent, create_agent, get_task_status, publish_to_bus, get_bus_messages — no existen