Document hybrid delegation model for Claude Code

README now explains when Claude Code delegates to the orchestrator
vs. handles tasks natively, matching the updated CLAUDE.md rules.
This commit is contained in:
Adam Moussa 2026-05-08 16:41:46 -04:00
parent ca96b488e6
commit acfeb543d9

View file

@ -44,11 +44,27 @@ python3 run.py "What is the LangGraph checkpoint API?"
python3 run.py --route-only "Review this code for security issues"
```
From Claude Code (via CLAUDE.md delegation):
From Claude Code (via CLAUDE.md hybrid delegation):
```bash
# Claude Code delegates automatically when another model is better for the task
python3 ~/Documents/repositories/orchestrator/run.py "<task description>"
# Check routing without executing
python3 ~/Documents/repositories/orchestrator/run.py --route-only "<task description>"
```
### When Claude Code delegates vs. handles natively
Claude Code uses a hybrid model — it delegates to the orchestrator when a different model has a genuine advantage, and handles everything else natively:
| Delegate to orchestrator | Handle natively in Claude Code |
|---|---|
| Cross-family code review (GPT-4.1) | File editing, refactoring, bug fixes |
| Large codebase scanning (Gemini) | Git operations, PRs, merges |
| Quick bounded coding (DeepSeek) | AWS/SAM/CDK deployments |
| External service actions (Composio) | Shell commands, system admin |
| | Interactive planning and conversation |
## Agents
| Agent | Model | Use Case |