Hablarle a orch desde tu agente

Escribes una frase en tu agente. El Chair la convierte en llamadas MCP. Esto es en qué se convierte cada frase.

Nunca escribes una llamada MCP. Escribes una frase en el agente que abriste con orch claude, orch opencode, orch codex — y ese asiento, el Chair, convierte la frase en llamadas a herramientas de orch mcp.

Estas páginas existen porque la correspondencia no es obvia. "Abre un worker" no es un comando de shell; es dispatch_worker. Conocer la correspondencia es lo que te permite formular la frase para que el Chair haga lo correcto al primer intento.

Por qué el Chair es quien llama a las herramientas#

El primer asiento interactivo que abres en un proyecto es el Chair (role=chair). Todo lo que él lanza es un worker (ORCH_ROLE=worker). Solo el Chair puede ramificar:

dispatch_worker denied: ORCH_ROLE=worker — only the Chair may spawn (use orch msg to the Chair)

Esa negación no es un bug que haya que rodear. Un Chair por proyecto git mantiene un único dueño del ledger, de los locks y del presupuesto de spawns. Un worker que necesita más manos las pide por el bus en vez de tomárselas.

Qué puede y qué no puede hacer un worker#

Chair Worker
Lanzar: dispatch_worker, task_add, task_assign, task_run sí no
Reclamar un ítem: task_claim, task_release sí sí — reclamar lo tuyo no es ramificar
Bus: msg_send, msg_inbox, msg_ack, msg_peers, msg_roster sí sí
Pregunta bloqueante: ask — sí, a su Chair
Responderla: ask_answer, ask_list sí —
Locks, símbolos, grafo, contexto, memoria, consumo sí sí
Reportar evidencia: verify_report — sí, antes de terminar

Debajo de toda la tabla hay dos reglas. Un worker nunca abre otro CLI de agente fuera de orch para "hacer de worker". Y un worker nunca inventa un segundo bus — ni sockets del vendor, ni chats paralelos.

El formato de receta#

Cada página que sigue usa las mismas cinco partes:

  • Prompt — la frase que escribes, en lenguaje natural.
  • Qué hace el Chair — una línea: chequeo de rol, resolución del proyecto, despacho.
  • Llamadas MCP — nombres reales de herramientas y de parámetros, con el equivalente en CLI cuando existe.
  • Respuesta esperada — la forma de lo que vuelve, según client/docs/PROTOCOL-AGENT.md.
  • Trampas — la negación, la compuerta, el preset que todavía no está configurado.

Los argumentos que llevan tu identidad (holder, session, from_session) salen de .orch/ORCH_RUNTIME.md, que el asiento inyecta. No los inventes.

Las ocho recetas#

  1. Dos workers que se corrigen entre sí
  2. Preguntarle a otro proyecto cómo resolvió X
  3. Reclamar un ítem del ledger antes de empezar
  4. Quién llama a esto y qué se rompe si lo cambio
  5. Dejar de leer archivos enteros; comprimir lo que lees
  6. Ver mi consumo y mis fugas
  7. Promover mi worktree
  8. Conectar OpenCode al gateway con mis llaves

Fuera de un taller vinculado (loose mode) las herramientas de locks y símbolos devuelven un texto de salto suave en vez de un error. La gobernanza aplica dentro de un workspace vinculado.