diff --git a/README.md b/README.md index bc1cbe5..146483d 100644 --- a/README.md +++ b/README.md @@ -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 "" + +# Check routing without executing +python3 ~/Documents/repositories/orchestrator/run.py --route-only "" ``` +### 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 |