/subagents-opencode
Read and follow references/subagents-opencode/protocol.md (protocol SSOT).
Patrón agnóstico de subagent-driven development (controlador + implementer + reviewer +
ledger) para el harness OpenCode; herdr es el mecanismo para correr los subagents como
workers TUI en procesos independientes. El protocol integra las capacidades de
herdr-orchestration (compozy/kb) adaptadas al CLI real herdr.
- Preflight:
herdr status,herdr integration status(runtime debe estarcurrent),herdr pane current --current,herdr agent list. Instala/actualiza la integración del runtime seleccionado (herdr integration install <runtime>) si estáoutdated. - Workers son TUIs (no headless):
herdr agent start <name> --kind <runtime> --pane <id>trasherdr tab create … --label "<model>: <slice>" --no-focus. - Packets de delegación como contrato standalone (ver protocol). Tracking con
herdr agent wait <name> --until done|blocked --timeout <check-in>. - Notificación/atención: opencode-notifier / herdr-terminal-notifier (eventos
permission|complete|subagent_complete|question|error,showSessionTitle: true,focusOnClick,suppressWhenFocusedopt-in; evitar duplicados con el toast de herdr). - Orquestación multi-sesión: cambio de sesión herdr solo desde shell cruda (nested launch prohibido), naming de ventana por OSC 2, y session_name en el ledger.
- Verificación read-only (
agent read), diff review antes de aceptar, yherdr tab closeal retirar. Plan-first: opcional, verreferences/subagents-opencode/plan-mode.md.