From acfeb543d9be6a22675224626218eac14e249357 Mon Sep 17 00:00:00 2001 From: Adam Moussa <166072409+amoussa1229@users.noreply.github.com> Date: Fri, 8 May 2026 16:41:46 -0400 Subject: [PATCH] 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. --- README.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) 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 |