## Orchestration — generally available

Run multi-agent pipelines where a designated orchestrator coordinates specialist workers — a coder, reviewer, auditor, release agent, or any roles that fit your project. Previously, this capability existed in the codebase but was undocumented and effectively hidden from users.

Define an `[[orchestrations]]` block in `.dot-agent-deck.toml` with one role marked `start = true` as the orchestrator and the rest as workers. Press `Ctrl+n`, navigate to your project directory, and cycle the **Mode** field to the orchestration name — the deck opens a dedicated tab with a pane for every role. The orchestrator reads a task, delegates work to workers, waits for results, and chains the next step. Workers run independently in their own panes and report back when done. Parallel delegation is supported: the orchestrator can send work to multiple roles simultaneously.

A built-in role library (coder, reviewer, auditor, tester, documenter, release, researcher) provides starting-point prompts and commands for common workflows. Generate a project-tailored config in one step by pressing `Ctrl+d` → `g` on the dashboard — the agent analyzes your project and proposes roles, commands, and prompt templates. Treat the generated config as a starting point and edit it freely.

See [Orchestration](https://devopstoolkit.ai/docs/ui/orchestration) for the full configuration reference, examples, and troubleshooting.
