Skip to main content
subagent CX Codex

workflow-orchestrator · voltagent/awesome-codex-subagents — Codex subagent: use and install

The workflow-orchestrator subagent turns a complex request into staged Codex work, with delegation rules, validation gates, integration steps, and failure handling.

MIT ★ 6,505 updated 2026-10-05

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

What workflow-orchestrator does

workflow-orchestrator designs an explicit path for a multi-stage Codex task. It splits the objective into discovery, implementation, validation, and integration, then marks which work stays with the parent agent and which work can be delegated. Each stage gets dependencies, wait points, continuation rules, and a defined deliverable.

The workflow also highlights the critical path and safe parallel work. Validation gates block the next stage until its output is checked. Integration covers conflict handling and final verification, while retry and rollback branches address failed or unclear results.

Place the subagent file at .codex/agents/workflow-orchestrator.toml. Codex does not spawn, synchronize, or merge agents on its own; those actions require explicit instructions from the parent agent.

What it helps with

  • break a complex request into dependent stages
  • assign local and delegated ownership per stage
  • define wait points and continuation rules
  • validate outputs before advancing
  • plan retry and rollback paths for failed stages

Example prompts for the agent

  • Split this task into discovery, implementation, validation, and integration, and assign an owner to each stage.
  • Write an end-to-end plan for the parent agent, including local work, delegated work, wait points, and continuation conditions.
  • Define deliverable contracts, validation gates, merge conditions, and rollback branches for this multi-stage task.

How to install workflow-orchestrator

Manually: put the files in place

.codex/agents/workflow-orchestrator.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 workflow-orchestrator

How do I install workflow-orchestrator in Codex?

Place the subagent file at .codex/agents/workflow-orchestrator.toml.

What does workflow-orchestrator do?

It designs a staged workflow for complex Codex executions, covering delegation, dependencies, validation gates, integration, and failure branches.

Does workflow-orchestrator spawn and synchronize subagents automatically?

No. The parent agent must explicitly control spawning, synchronization, and result integration.

Source text

workflow-orchestrator.toml · MIT
# workflow-orchestrator

Use when the parent agent needs an explicit Codex subagent workflow for a complex task with multiple stages.

Own workflow orchestration as explicit stage design for complex Codex executions.

Translate broad requests into local-first, delegate-aware workflows with clear gates, integration steps, and risk controls.

Working mode:
1. Map objective into stages: discovery, implementation, validation, and integration.
2. Decide per stage what runs locally versus via subagents.
3. Define explicit wait points, continuation rules, and merge conditions.
4. Provide execution script the parent agent can follow end-to-end.

Focus on:
- critical-path identification and early blocker removal
- stage-level parallelization opportunities with dependency safety
- delegation criteria by task coupling, urgency, and complexity
- output contracts that make cross-stage integration deterministic
- validation checkpoints before advancing to next stage
- rollback/retry handling when a stage fails or returns ambiguous results
- keeping workflow minimal while preserving robustness

Quality checks:
- verify stage order reflects true dependencies, not arbitrary sequencing
- confirm delegated stages have bounded scope and explicit deliverables
- check parent-agent control points are clear for go/no-go decisions
- ensure integration stage includes conflict-resolution and final verification
- call out workflow assumptions that require user/environment confirmation

Return:
- staged workflow with local/delegated ownership per stage
- wait/continue rules and integration checkpoints
- per-stage deliverable contract and validation gate
- risk hotspots and contingency branches
- concise execution order the parent agent can run directly

Do not assume Codex auto-spawns, auto-synchronizes, or auto-integrates agents without explicit parent-agent instructions unless explicitly requested by the parent agent.

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

Similar subagents

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

workflow-orchestrator by other authors comes first.

workflow-orchestrator VoltAgent Community workflow-orchestrator designs state machines, process transitions, and compensation logic in Markdown or YAML specs. Ideal when you need to specify a multi-step workflow before running it. CX Codex 423installs fable-baton realgarit fable-baton turns Fable 5 into an orchestrator in Claude Code, routing implementation to tiered Opus, Sonnet, and Haiku subagents. ★ 1,013repo stars codebase-orchestrator VoltAgent Community codebase-orchestrator — a subagent that runs repository-wide refactors in stages: repo map, weighted risk priorities, diff previews, and an explicit approval gate before any edit. CX Codex ★ 26,718repo stars it-ops-orchestrator VoltAgent Community it-ops-orchestrator coordinates multi-domain IT operations by routing tasks across PowerShell, Azure, M365, and Active Directory subagents. CX Codex 194installs orchestrator curiositech orchestrator breaks complex requests into subtasks, delegates them to specialist skills, and combines their work. It can also create a skill when a needed capability is missing. CX Codex +1 2installs antigravity-workflows sickn33 antigravity-workflows is a Claude Code skill that turns a complex goal into a verified sequence of specialized skill calls, each with an expected artifact and a passing check. CX Codex +1 923installs commands-workflow-orchestration BuildWithClaude Community The commands-workflow-orchestration plugin adds commands for coordinating complex workflows. Use it when a process needs starting, status checks, resuming, or synchronization. ★ 3,785repo stars

From the same set176

The whole set →
data-researcher The data-researcher subagent for Codex gathers and synthesizes datasets, metrics, and quantitative evidence for engineering and product decisions, rather than dumping raw links. CX Codex ★ 6,505repo stars competitive-analyst competitive-analyst compares tools, products, libraries, and implementation options against criteria for a specific decision. Useful when adoption and maintenance matter as much as features. CX Codex ★ 6,505repo stars cohort-analysis cohort-analysis — a subagent for diagnosing product health via retention curves and user cohort behavior. Separates product-market-fit problems from growth issues and identifies activation moments that predict long-term engagement. CX Codex ★ 6,505repo stars 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 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 multi-agent-coordinator 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. 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

Project sponsors

Companies that keep this analytics open