Subagent Orchestration

subagent-orchestration is a Codex marketplace plugin from Claire Novotny LLC for using Codex multi_agent_v2 subagents without turning the root thread into a cluttered working context.

It packages:

• a subagent-orchestration skill
• a prompt-gated Node hook that reminds Codex when subagent delegation is relevant
• bundled agent definitions for mapper, debugger, reviewer, test, docs, browser, engineer, lead, investigation, and planner roles
• a Codex plugin package published through the shared Claire Novotny LLC marketplace

This plugin targets multi_agent_v2 only. In the local Codex build used to create the package, multi_agent_v2 is listed as under development and disabled by default, so validation sessions should enable it explicitly.

Layout

plugins/subagent-orchestration/
  .codex-plugin/plugin.json
  hooks.json
  skills/subagent-orchestration/SKILL.md
  scripts/hooks/subagent-orchestration-reminder.js
  scripts/validate-plugin.js
  agents/*.toml
  assets/icon.svg

Local Development

Validate the package from the repository root:

node plugins/subagent-orchestration/scripts/validate-plugin.js

For a GitHub marketplace install:

codex plugin marketplace add novotnyllc/marketplace --enable multi_agent_v2
codex plugin add subagent-orchestration --marketplace novotnyllc --enable multi_agent_v2

When starting a session that should use these examples, enable multi_agent_v2:

codex --enable multi_agent_v2

Usage

Invoke the skill when a task needs delegated work:

Use subagent-orchestration to split this debugging task into lead and leaf agents.

The root thread should stay the user-facing integrator. Use:

• agent_organizer for short-lived spawn planning
• implementation_lead or investigation_lead for bounded branches
• leaf roles like code_mapper, debugger, reviewer, test_automator, docs_researcher, and browser_debugger for narrow work

Runtime Notes

Current local checks found:

• multi_agent_v2 exists but is disabled by default in this build.
• UserPromptSubmit hook shape is supported by installed plugins.
• Shared marketplace discovery succeeds through novotnyllc/marketplace.
• Agent files are packaged at plugin level and may need a fresh --enable multi_agent_v2 session for direct spawn validation.

If agent TOMLs are not auto-discovered by the current runtime, copy the desired files from plugins/subagent-orchestration/agents/ into either repo-local .codex/agents/ or user-level <codex-home>/agents/.