| name | auto-swarm |
| description | Distributed agent swarm orchestrator — spawns parallel subagent clusters for any task with configurable depth, swarm size, and convergence criteria |
| argument-hint | [task, mode, or depth] |
auto-swarm
Overview
Use this as the Codex-first swarm workflow. In Codex it should preserve the decomposition and convergence ideas from ProductionOS while defaulting to practical execution: decompose clearly, parallelize only when the user wants it, and keep a visible coverage map.
Source references:
.claude/commands/auto-swarm.md
agents/swarm-orchestrator.md
agents/worktree-orchestrator.md
Inputs
- required
task
- optional
mode
- optional
depth
- optional
swarm_size
- optional
iterations
Codex Workflow
- Analyze the task and choose the mode.
- Decompose the work into independent slices.
- Build a coverage map before execution starts.
- Execute serially by default in Codex unless the user explicitly wants sub-agents or parallel work.
- After each wave, synthesize:
- what was covered
- what remains
- whether another wave is justified
- Stop when coverage is sufficient or returns diminish.
Expected Output
- task decomposition
- coverage map
- per-wave synthesis
- final compiled result
Guardrails
- do not parallelize by reflex
- keep subtask boundaries explicit
- stop when additional waves are not producing meaningful coverage gains