How oh-my-claudecode orchestrates multi-agent workflows.
oh-my-claudecode enables Claude Code to orchestrate specialized agents through a skill-based routing system.
┌─────────────────────────────────────────────────────────────────────────┐
│ OH-MY-CLAUDECODE │
│ Intelligent Skill Activation │
└─────────────────────────────────────────────────────────────────────────┘
User Input Skill Detection Execution
────────── ─────────────── ─────────
│ │ │
▼ ▼ ▼
┌─────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ "ultrawork │ │ CLAUDE.md │ │ SKILL ACTIVATED │
│ refactor │─────────────▶│ Auto-Routing │──────────▶│ │
│ the API" │ │ │ │ ultrawork + │
└─────────────┘ │ Task Type: │ │ default + │
│ - Implementation│ │ git-master │
│ - Multi-file │ │ │
│ - Parallel OK │ │ ┌─────────────┐ │
│ │ │ │ Parallel │ │
│ Skills: │ │ │ agents │ │
│ - ultrawork ✓ │ │ │ launched │ │
│ - default ✓ │ │ └─────────────┘ │
│ - git-master ✓ │ │ │
└──────────────────┘ │ ┌─────────────┐ │
│ │ Atomic │ │
│ │ commits │ │
│ └─────────────┘ │
└─────────────────┘
Skills are behavior injections that modify how the orchestrator operates. Instead of swapping agents, we inject capabilities through composable skills:
- Execution Skills: Primary task handlers (
default,planner,orchestrate) - Enhancement Skills: Additional capabilities (
ultrawork,git-master,frontend-ui-ux) - Guarantee Skills: Completion enforcement (
ralph)
Skills can stack and compose:
Task: "ultrawork: refactor API with proper commits"
Skills: ultrawork + default + git-master
32 specialized agents organized by complexity tier:
| Tier | Model | Use For |
|---|---|---|
| LOW | Haiku | Quick lookups, simple operations |
| MEDIUM | Sonnet | Standard implementations |
| HIGH | Opus | Complex reasoning, architecture |
See REFERENCE.md for the complete agent roster.
Work is delegated through the Task tool with intelligent model routing:
Task(
subagent_type="oh-my-claudecode:executor",
model="sonnet",
prompt="Implement feature..."
)Categories like visual-engineering and ultrabrain auto-select model tier, temperature, and thinking budget.
Skills compose in layers:
┌─────────────────────────────────────────────────────────────┐
│ GUARANTEE LAYER (optional) │
│ ralph: "Cannot stop until verified done" │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ ENHANCEMENT LAYER (0-N skills) │
│ ultrawork (parallel) | git-master (commits) | frontend-ui-ux│
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ EXECUTION LAYER (primary skill) │
│ default (build) | orchestrate (coordinate) | planner (plan) │
└─────────────────────────────────────────────────────────────┘
Formula: [Execution Skill] + [0-N Enhancements] + [Optional Guarantee]
State files follow standardized locations:
Local Project State:
.omc/state/{name}.json- Session state (pipeline, team).omc/notepads/{plan-name}/- Plan-scoped wisdom capture
Global State:
~/.omc/state/{name}.json- User preferences and global config
Legacy locations are auto-migrated on read.
oh-my-claudecode includes 31 hooks in src/hooks/ for lifecycle events:
| Event | Purpose |
|---|---|
UserPromptSubmit |
Keyword detection, mode activation |
Stop |
Continuation enforcement, session end |
PreToolUse |
Permission validation |
PostToolUse |
Error recovery, rules injection |
See REFERENCE.md for the complete hooks list.
The verification module ensures work completion with evidence:
Standard Checks:
- BUILD: Compilation passes
- TEST: All tests pass
- LINT: No linting errors
- FUNCTIONALITY: Feature works as expected
- ARCHITECT: Opus-tier review approval
- TODO: All tasks completed
- ERROR_FREE: No unresolved errors
Evidence must be fresh (within 5 minutes) and include actual command output.
- Complete Reference: See REFERENCE.md
- Internal API: See FEATURES.md
- User Guide: See README.md
- Skills Reference: See CLAUDE.md in your project