orchestrate:initiative
orchestrate:initiative
Section titled “orchestrate:initiative”Plan initiative execution and prepare structured handoff artifacts without claiming host launch; stored handoffs can be replayed inline; —worker WU-ID runs one ready WU through a governed local worker adapter
Options:
| Flag | Description | Required |
|---|---|---|
--worker-handoff <file> | Host-authored worker handoff file for —worker | No |
--adapter <kind> | Worker adapter for —worker: embedded or subprocess | No |
--worker <wuId> | Run ONE ready WU through a worker adapter (excludes supervision) | No |
--max-active-workers <count> | Cap concurrent active workers; overrides software_delivery.orchestration.max_active_workers | No |
--strict-preflight | Treat file-overlap or lane-fit preflight warnings as blocking (overrides software_delivery.orchestrate.preflight) | No |
--print-handoffs | Print stored handoff artifacts inline for manual copy/paste output | No |
--client <name> | Agent host capability profile identifier | No |
--no-checkpoint | Force polling mode | No |
-c, --checkpoint-per-wave | Prepare the next wave then exit (no polling) | No |
-p, --progress | Show current progress only | No |
-d, --dry-run | Show execution plan without writing launch artifacts | No |
-i, --initiative <ids...> | Initiative ID(s) to orchestrate | Yes |