--- name: orchestrate-work-plugin description: Explicitly invoked adapter for the bundled orchestrate-work workflow and its session-activated local helpers. --- # Orchestrate work with local helpers Use only on the author's explicit invocation, including bounded assignments within that run. The bundled `orchestrate-work` owns the workflow. Resolve the plugin root from this file's location. In host Plan mode, first read the bundled core's `references/runtime.md#planning-mode` and `references/protocol.md#workstream-plan`. Settle goal mode, choose coordinator placement through `references/runtime.md`, and settle missing review preferences through `references/protocol.md#review-gate`. Use pinned copies for an existing run. Propose the plan in chat; defer setup until the host transitions to execution. 1. For an existing run, use its recorded pinned core/protocol, root, returned CLI and `--run-id `. For a new run, read `/support/skills/orchestrate-work/SKILL.md` and its `references/protocol.md#setup` and `references/verification.md`; obtain the combined understanding/verification confirmation and explicit goal-mode choice before activation. Resolve the author checkout and coordination root through that protocol's **Current state**. Create and verify the root before activation; record it during goal definition. For new packages exposing policy selection, read `references/controls.md` and prepare the Root policy from those confirmed inputs. Use the selected-controls activation below; disclose a legacy or unsupported route instead of claiming its guards. This adds no separate approval question. 2. For helpers, use the host event's canonical `session_id` when available. `CODEX_THREAD_ID` can supply an explicit candidate; its hook coverage remains unobserved until a matching real event arrives. If neither is available, report the capability gap. Run: ```text python /scripts/orchestration.py activate --session --coord-root --author-repo --plugin-data --policy ``` The host's `PLUGIN_DATA` may supply the data root. Use the returned absolute `cli`, `core`, `worker` and `support` paths. Read `core` and its role-required references; resolve named supporting skills beneath returned `support`. Follow the core's goal-mode and coordinator-placement setup, workstream plan, dispatch checks and review gate, including its one-time setup question for missing preferences and mandatory requirements. That example starts a new selected-controls run. Recovery uses the recorded CLI and `--run-id ` without `--policy`; it preserves that run's actual pin and capabilities. 3. Load supporting skills beneath `support` by absolute path when core calls for them, including the completion handoff and optional author-requested `correct`. Give leaves only `worker` and a sufficient brief. Explicitly enroll delegated coordinator sessions against the existing run when needed. For a policy-controlled run, follow the pinned core's `references/controls.md`; use its selected policy and guarded adapter command. Recovery enrollment reuses the existing pin; it does not add capabilities absent from that pin. 4. Use the returned CLI's `--help` for mechanical commands. `status --session ` diagnoses membership. `deactivate --session ` revokes that binding; `deactivate --run-id ` revokes the run's bindings. Continue task holds, review, integration, and acceptance through the pinned core instructions. Installation and activation need separate evidence. Claim hook coverage only for events observed on this host. Counters do not establish capacity, cost or completion. Snapshot paths stay pinned until explicit migration through core's hold/resume protocol.