Skip to main content
subagent CX Codex

agent-organizer · voltagent/awesome-codex-subagents — Codex subagent: task splitting and setup

The agent-organizer subagent helps a parent agent split large work into bounded threads, choose what to delegate, and coordinate the results.

MIT ★ 6,505 updated 2026-10-05

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

What agent-organizer does

agent-organizer helps the parent agent decide which parts of a task stay local and which go to subagents. It maps critical-path and sidecar work, assigns roles, orders dependencies, and sets explicit read and write boundaries.

Each delegated thread gets an output contract and a prompt skeleton. The subagent also checks for duplicate ownership, unnecessary offloading, wait points, blocking risks, and a fallback for conflicting results. Two concurrent write threads touching the same area create a merge risk, so their write scopes need to stay separate.

For Codex, place the agent configuration at .codex/agents/agent-organizer.toml. The agent frontmatter selects gpt-5.6-sol.

What it helps with

  • split a large task into bounded subagent threads
  • decide which work should remain local
  • assign separate read and write scopes
  • order dependencies and integration checkpoints
  • prepare prompts for delegated work

Example prompts for the agent

  • Break this task into critical-path and sidecar work, then recommend the subagent lineup.
  • Decide what the parent agent should keep local and what to delegate, with read and write boundaries.
  • Create the execution order, wait points, integration checks, and a fallback for conflicting results.

How to install agent-organizer

Manually: put the files in place

.codex/agents/agent-organizer.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 agent-organizer

How do I install agent-organizer in Codex?

Place the agent configuration at .codex/agents/agent-organizer.toml.

What does agent-organizer do?

It helps a parent agent choose subagents, divide a larger task into bounded threads, and define roles, dependencies, and output contracts for each thread.

How does agent-organizer reduce coordination conflicts?

It checks for overlapping ownership and separates write scopes. It also marks dependency gates and integration checkpoints for delegated work.

Source text

agent-organizer.toml · MIT
# agent-organizer

Use when the parent agent needs help choosing subagents and dividing a larger task into clean delegated threads.

Own subagent organization as task-boundary design for high-throughput, low-conflict execution.

Optimize delegation so each thread has one clear purpose, predictable output, and minimal overlap with other threads.

Working mode:
1. Map the full task into critical-path and sidecar components.
2. Decide what stays local versus what is delegated by urgency and coupling.
3. Assign roles with explicit read/write boundaries and dependency order.
4. Define output contracts so parent-agent integration is straightforward.

Focus on:
- decomposition by objective rather than by file list alone
- parallelization opportunities that do not block immediate next local step
- write-scope separation to avoid merge conflict and duplicated effort
- read-only vs write-capable role selection by task risk
- dependency and wait points where parent must gate progress
- prompt specificity needed for bounded, high-signal subagent output
- fallback plan if one thread returns uncertain or conflicting results

Quality checks:
- verify each delegated task is concrete, bounded, and materially useful
- confirm no duplicate ownership across concurrent write tasks
- check critical-path work is not unnecessarily offloaded
- ensure output expectations are explicit and integration-ready
- call out orchestration risks (blocking, conflicts, stale assumptions)

Return:
- recommended agent lineup with role rationale
- work split (local vs delegated) and execution order
- dependency/wait strategy with integration checkpoints
- prompt skeleton per delegated thread
- main coordination risk and mitigation approach

Do not propose delegation patterns that duplicate work or stall critical-path progress unless explicitly requested by the parent agent.

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

Similar subagents

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

agent-organizer by other authors comes first.

agent-organizer VoltAgent Community agent-organizer breaks down complex projects into subtasks, maps them to available subagents, and writes an execution plan in Markdown. Useful for coordinating multi-agent setups. CX Codex 562installs agent-organizer qdhenry The agent-organizer subagent studies a project, chooses specialist agents, and plans their work. Use it when a task needs structured multi-agent coordination. CX Codex ★ 1,357repo stars do-in-steps NeoLabHQ do-in-steps splits a complex task into dependent steps, runs them in order, and has a separate judge check each step before the next one starts. CX Codex +1 1,300installs advisor-orchestrator-worker Shubham Saboo advisor-orchestrator-worker is a Claude Code skill that splits large tasks across an advisor and parallel workers. It handles tasks too large for one model to complete in a single pass. CX Codex +1 704installs oma-orchestration First Fluke oma-orchestration breaks a complex request into prioritized tasks and dispatches them to parallel specialist agents while tracking progress through to a final report. CX Codex +1 ★ 1,472repo stars agentic-engineering affaan-m agentic-engineering guides autonomous workflows by enforcing an eval-first test loop and decomposing tasks into 15-minute units. CX Codex +1 6,500installs plan hyperb1iss A skill for Claude Code, Codex, Cursor, and other AI coding platforms that breaks down complex work into verifiable tasks and dependencies. Activates when you ask for a plan, request step-by-step breakdown, or ask to decompose a feature. CX Codex +1 606installs task-decomposition jwynia task-decomposition breaks overwhelming features and epics into manageable vertical slices. Useful when dependencies block progress or scope creeps past realistic estimates. CX Codex +1 603installs

From the same set176

The whole set →
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 codebase-orchestrator codebase-orchestrator — a Codex subagent for repository-wide refactoring with risk prioritization, diff previews, and mandatory human approval gates. CX Codex ★ 6,505repo stars agent-installer agent-installer — a subagent that selects, copies and organizes custom agents from the repository into Codex directories. Plans installation scope, detects naming conflicts and checks dependencies before setup. CX Codex ★ 6,505repo stars wordpress-master wordpress-master handles WordPress implementation and debugging across themes, plugins, and operational site workflows. CX Codex ★ 6,505repo stars ux-researcher The ux-researcher subagent turns UI feedback and observations into ranked UX issues, implementation guidance, and validation steps for product and engineering work. CX Codex ★ 6,505repo stars technical-writer technical-writer is a Codex subagent that drafts release notes, migration guides, and onboarding from real code changes. It launches for implementation-accurate technical documentation scoped to its audience. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open