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
| Cause | Notes |
|---|---|
| CLAUDE.md not loaded | Delegation rules live in CLAUDE.md and Claude Code didn't load it |
| Plugin installed in the wrong directory | Installed 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 worksOther environments
| Environment | Notes |
|---|---|
| CLAUDE.md not loaded | Rerun /omc-setup at the project root (CSDN 2026-03) |
| Plugin in wrong directory | Install into the target project |
| Rule format | Consistent with the v5 guidance schema |
| Not measured | Plugin 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
- Check whether CLAUDE.md is loaded: ask in the session / check
/contextfor OMC delegation rules. - Re-run
/omc-setupin the correct project root (CLAUDE.md is generated per project). - 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-claudecodeSource & evidence
← Multi-Agent Orchestration domain | Problem Catalog Experience | Facing another issue? Go to the Helpdesk