Skip to main content
reopt Handbook
reopt Handbook
Advanced Codex Usage

Foundation

Setup and LoginConfigMemories

Safety and Operations

ApprovalsSecurity

Workflow

Slash CommandsPrompts and SkillsExec and AutomationThread LifecycleCloud TasksMulti-Agent Workflows

Extensions and IDE

Codex App and IDEMCP IntegrationModels and ReasoningGovernance and Rollout

Verification

VerificationUpdates
Handbook›Advanced Codex Usage›Multi-Agent Workflows
한국어English

Multi-Agent Workflows

Split Codex work across bounded agents while preserving ownership and review.

Key takeaways

  • Multi-agent work pays off only when tasks are independent enough to run in parallel; otherwise it adds coordination cost and merge risk.
  • Use bounded roles: Explorer for codebase questions, Worker for a slice of implementation, Verifier for checks during work, and Comparator for alternative solutions.
  • Assign clear file or module ownership, keep write sets disjoint, tell agents about other parallel work, and require final changed-file lists.
  • In 0.142.0-era delegation modes, write down parent/child handoff rules and check /usage before spawning expensive parallel work.
  • In 0.145.0, stabilized Multi-agent V2 adds per-subagent model, reasoning, concurrency, roles, and thread navigation; verify runtime metadata against the intended role config.
  • In 0.149.0–0.150.0, use codex agents, codex queue, and task @ mentions to find, start, message, rename, and stop work on the shared local daemon.
  • Integrate results locally before final verification.
  • Do not delegate the critical next step when the main thread is blocked on it; do that work locally to keep the path clear.

Multi-agent work is powerful only when tasks are independent enough to run in parallel. Otherwise it creates coordination cost and merge risk.

Delegation Patterns

PatternUse
ExplorerAnswer a specific codebase question
WorkerImplement a bounded slice of work
VerifierRun checks or inspect risk while implementation continues
ComparatorTry alternative solutions for the same problem

Task Design

  • Assign clear file or module ownership.
  • Tell agents about other parallel work.
  • Keep write sets disjoint when possible.
  • Require final changed-file lists.
  • Integrate results locally before final verification.

Risk Controls

Avoid delegating the critical next step when the main thread is blocked on it. Do that work locally to keep the path clear.

For 0.142.0-era multi-agent delegation, add two checks to the prompt or runbook:

  • State which agent owns integration and which agent only investigates.
  • Check /usage weekly and rollout token budgets before spawning broad parallel work.

Related docs

Cloud Tasks

Use remote Codex tasks for parallel attempts, long work, and reviewable outputs.

Multi-Agent Architecture

Vercel Enterprise AI Platform · Design supervisor, delegation, pipeline, and review patterns for enterprise agents.

Agentic Development

Enterprise Project Architecture · Use AI agents in enterprise development with context packs, scoped tasks, and review gates.

Cmd. /agent

Codex Command Master · Switch between spawned Codex subagent threads to inspect each agent transcript, status, model, and reasoning effort before merging their work.

Thread Lifecycle

Manage Codex sessions across start, resume, fork, compact, archive, delete, and handoff.

Cloud Tasks

Use remote Codex tasks for parallel attempts, long work, and reviewable outputs.

Codex App and IDE

Use Codex across the app, terminal, and IDE without losing context discipline.

On this page

Delegation PatternsTask DesignRisk Controls