Multi-Agent Orchestration · recorded 2026-08-29 · applies to 1 tool(s) ✓ Verified

Problem: Multi-agent tasks not auto-delegated/claimed in session —— Trove problem library

Verified 2026-08-29agents not auto-delegated — rerun /omc-setup in the correct project root (CLAUDE.md is generated per project), then check whether rules loaded.

Quick fix

# One-liner: rerun /omc-setup in the correct project root, then check the rules are loaded
/omc-setup

Run at the project root (CLAUDE.md is generated per project).

What you will run into

Multi-agent is configured, but tasks in the session aren't auto-delegated/claimed. Multi-agent set up but not doing work.

Why this happens

CauseNotes
CLAUDE.md not loadedDelegation rules live in CLAUDE.md and Claude Code didn't load it
Plugin installed in the wrong directoryInstalled in another project's dir; rules aren't in the current project

Auto-delegation is not a daemon — it is rules read once at session startup: Claude Code loads CLAUDE.md from the project root when a session starts and registers the delegation rules (which task goes to which sub-agent) into that session.

This load is silent — it does not error when it fails; it just looks like "rules not active". So "configured but not working" only has two directions to check: is the rules file in the current project, and is its content recognized.

That is also why "I ran setup in another directory" equals "not configured": rules are generated per project, so a different directory means a different ruleset.

Step by step

1. Check whether CLAUDE.md is loaded — Required

In the session, check whether /context includes the OMC delegation rules.

2. Rerun /omc-setup in the correct project root — Required

/omc-setup

CLAUDE.md is generated per project; it must run in the target project root.

3. Confirm the delegation rule format — Required

Consistent with the v5 docs (guidance schema contract, see AGENTS.md).

How to confirm it works

Session context includes the delegation rules (expected shape):

/context → output includes the OMC delegation rules
Task submit → auto-delegation/claim works

Other environments

EnvironmentNotes
CLAUDE.md not loadedRerun /omc-setup at the project root (CSDN 2026-03)
Plugin in wrong directoryInstall into the target project
Rule formatConsistent with the v5 guidance schema
Not measuredPlugin form needs a Claude Code session; not measured here (CLI form is pure command surface,)

Symptom

Multi-Agent is configured, but tasks are not auto-delegated/claimed in sessions.

Cause

Claude Code did not load OMC's CLAUDE.md (delegation rules live in CLAUDE.md); or the plugin was installed into another project directory.

Solution

  1. Check whether CLAUDE.md is loaded: ask in the session / check /context for OMC delegation rules.
  2. Re-run /omc-setup in the correct project root (CLAUDE.md is generated per project).
  3. Confirm the delegation rule syntax matches the v5 docs (guidance schema contract, see AGENTS.md).
Verification Evidence
  • Web case: CSDN (agent not auto-delegated -> check CLAUDE.md not loaded, 2026-03).
  • Verified in this marketplace: CLI form does not depend on CLAUDE.md (pure command surface,); plugin form needs a Claude Code session, not tested.

Applicable tools (1)

This problem is linked from the tool pages below — reachable from either side.

oh-my-claudecode

Source & evidence

Recorded Verified ✓ VerifiedApplies to 1 tool(s)
Entries contain locally measured or reviewable-source solutions; unmeasured items are explicitly labeled.

← Multi-Agent Orchestration domain | Problem Catalog Experience | Facing another issue? Go to the Helpdesk