Skip to main content
subagent CX Codex

multi-agent-coordinator · voltagent/awesome-codex-subagents — Codex subagent: planning and setup

The multi-agent-coordinator subagent divides work between the parent agent and parallel delegates, sets ownership boundaries, and plans how results come together. Use it for tasks with separable workstreams.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/multi-agent-coordinator.toml
Open on GitHub

What multi-agent-coordinator does

The subagent maps a task’s critical path and identifies work that can happen in parallel. For each delegate, it defines a role, objective, and expected output; it also sets dependency and wait points so the parent agent knows when to proceed or pause.

Before parallel implementation starts, it calls for an integration checklist and plans how to handle overlapping findings or edits. If a delegate returns an incomplete or uncertain result, the plan includes a fallback. Urgent blocking work stays with the parent agent unless that agent explicitly asks to delegate it.

For Codex, add .codex/agents/multi-agent-coordinator.toml to the project. Concurrent edits need clear write ownership; otherwise, agents can work on overlapping scopes.

What it helps with

  • split a task into critical-path and parallel work
  • assign agents separate scopes for code changes
  • set dependencies and points to wait for results
  • define output formats and an integration plan
  • prepare a fallback for an incomplete delegate result

Example prompts for the agent

  • Plan work for several agents, separating the critical path from tasks that can run in parallel.
  • Give each delegate an objective, an owned change scope, and an expected output format; include dependencies and integration steps.
  • Identify the main risk of conflicting edits and plan what to do if a delegate returns incomplete findings.

How to install multi-agent-coordinator

Manually: put the files in place

.codex/agents/multi-agent-coordinator.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about multi-agent-coordinator

How do I install multi-agent-coordinator in Codex?

Add .codex/agents/multi-agent-coordinator.toml to your Codex project.

What does multi-agent-coordinator do?

It plans how the parent agent and delegates divide work, coordinate dependencies, and integrate their results.

What work should stay with the parent agent?

Urgent blocking work should stay with the parent agent unless it explicitly requests delegation.

Source text

multi-agent-coordinator.toml · MIT
# multi-agent-coordinator

Use when a task needs a concrete multi-agent plan with clear role separation, dependencies, and result integration.

Own multi-agent coordination as execution design that maximizes parallel progress without losing integration control.

Keep the parent agent on the critical path while delegating bounded, high-yield tasks to specialized threads.

Working mode:
1. Map task graph into critical-path work and parallel sidecar opportunities.
2. Assign roles with explicit ownership and disjoint write scopes where possible.
3. Define dependency and wait points with clear integration contracts.
4. Plan reconciliation of results, conflicts, and follow-up branches.

Focus on:
- local-first handling of immediate blockers before delegation
- role fit between task complexity and selected agent capability
- parallelization boundaries that avoid duplicate or conflicting edits
- explicit output schema expected from each delegated thread
- wait strategy (when to block, when to continue local work)
- merge/conflict risk control for concurrent implementation tasks
- contingency branch when a delegate result is partial or uncertain

Quality checks:
- verify every delegated task is materially useful and non-overlapping
- confirm at most one owner per write-critical scope
- check dependency ordering for hidden blocking edges
- ensure integration checklist exists before launch of parallel work
- call out highest coordination risk with mitigation step

Return:
- multi-agent plan with local vs delegated split
- per-agent ownership, objective, and expected output contract
- dependency/wait/integration timeline
- conflict-resolution strategy for overlapping findings
- main coordination risk and fallback plan

Do not delegate urgent blocking work that the parent agent should execute immediately unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

multi-agent-coordinator by other authors comes first.

multi-agent-coordinator VoltAgent Community multi-agent-coordinator plans how Claude Code subagents sequence work, share state through files, and handle failures. Use it when a task has parallel workers or hand-offs. CX Codex 632installs multi-agent-coordinator rohitg00 multi-agent-coordinator decomposes complex tasks into parallel branches, resolves dependencies, and merges outputs from multiple agents into coherent deliverables. CX Codex ★ 2,858repo stars error-coordinator rohitg00 error-coordinator — a subagent classifies failures in multi-agent workflows, selects retry or fallback paths, and preserves the context needed for recovery. CX Codex ★ 2,858repo stars adaptive-coordinator ruvnet adaptive-coordinator orchestrates agent swarms by switching network topology between mesh, hierarchical, and ring structures. Useful for heavy multi-agent workloads. CX Codex ★ 850repo stars multi-agent-patterns NeoLabHQ multi-agent-patterns is a Claude Code skill for planning systems that split work across agents. It activates when a task breaks into subtasks or one agent runs into context limits. CX Codex +1 1,400installs edict-multi-agent-orchestration reason-machines edict-multi-agent-orchestration orchestrates 12 specialized AI agents through an OpenClaw pipeline with quality gates, per-agent model configs, and a React kanban board. CX Codex +1 1,400installs open-multi-agent-orchestration reason-machines open-multi-agent-orchestration — a skill that teaches your agent to build AI agent teams on the open-multi-agent TypeScript framework: roles, models, task dependencies. CX Codex +1 718installs multi-agent-optimize Seth Hobson The multi-agent-optimize command helps diagnose bottlenecks in multi-agent systems and tune context, coordination, and costs. Use it when you need to weigh performance against quality and resource limits. CX Codex +1 ★ 42,780repo stars

From the same set176

The whole set →
ab-test-analysis ab-test-analysis evaluates A/B test data, inspects statistical and practical significance, and delivers principled ship or no-ship decisions. CX Codex ★ 6,505repo stars workflow-orchestrator The workflow-orchestrator subagent turns a complex request into staged Codex work, with delegation rules, validation gates, integration steps, and failure handling. CX Codex ★ 6,505repo stars task-distributor task-distributor is a Codex subagent that breaks broad tasks into work units with boundaries, dependencies, and ownership. It divides work across agents without duplication or overlap. CX Codex ★ 6,505repo stars performance-monitor performance-monitor triages build, runtime, and operational metrics, weeds out noise, and pinpoints responsible subsystems before heavy profiling starts. CX Codex ★ 6,505repo stars knowledge-synthesizer knowledge-synthesizer merges reports from several agents into one picture: what is confirmed, where findings disagree, and what to do next. CX Codex ★ 6,505repo stars it-ops-orchestrator it-ops-orchestrator coordinates complex operational planning across infrastructure, identity, endpoints, and incident response teams. CX Codex ★ 6,505repo stars error-coordinator error-coordinator groups multiple errors by likely cause, sets investigation priorities, and routes each cluster to a suitable specialist. Use it when symptoms pile up and the first fault is unclear. CX Codex ★ 6,505repo stars context-manager context-manager builds a short project brief that other subagents read before starting deeper work. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open