Task Router

Smart routing layer that analyzes tasks and recommends the optimal agent to minimize Opus usage while maintaining quality.

When to Use

Always call analyze_task_routing before spawning a sub-agent. This prevents defaulting to Opus for tasks that Sonnet or Haiku can handle.

Tool: analyze_task_routing

Analyzes a task and returns the recommended agent with reasoning.

Usage:

// Before spawning
const routing = await analyze_task_routing({
  task: "Polish the analytics dashboard UI",
  context: "React + Tailwind, needs to match Command Center aesthetics"
});

// Then spawn with the recommendation
sessions_spawn({
  agentId: routing.agent,
  task: task_description,
  // ... other params
});

Routing Criteria

Haiku (DEFAULT for Simple Tasks — Feb 2, 2026 Update)

Use for:

• Simple file edits (formatting, renaming, basic refactoring)
• Quick Q&A or fact lookups
• Basic data transformations
• Status checks, summaries under 1000 words
• Repetitive tasks with clear instructions
• Single-file research summaries
• Web scraping with clear targets
• File organization/moving
• Basic API calls with known patterns
• Generating lists or enumerations
• Simple templating tasks

Try Haiku FIRST if the task:

• Has clear, specific instructions
• Doesn't require creative judgment
• Can be validated objectively
• Follows a known pattern

Escalate to Sonnet only if:

• Task requires reasoning or judgment
• Multi-step workflows with dependencies
• Output quality needs to be nuanced

Sonnet (Default Workhorse)

Use for:

• General coding tasks (features, bug fixes, testing)
• Research and analysis
• Content generation (blog posts, docs, reports)
• Data processing and transformation
• Most API integrations
• File reorganization with logic
• Standard debugging

This should handle 70-80% of tasks.

Codex (Reasoning for Code)

Use for:

• Complex UI/UX implementation
• Architecture decisions and refactoring
• Debugging subtle/tricky bugs
• Performance optimization
• Code reviews requiring deep analysis
• Building entire features from scratch
• Complex algorithm implementation

Codex uses o1 reasoning - great for "thinking through" code problems.

Opus (Strategic Oversight)

Reserve for:

• Multi-agent coordination
• Complex strategic decisions spanning multiple domains
• Sensitive business logic requiring judgment
• Tasks requiring McKinzie's context/preferences
• Novel problems without clear solutions
• High-stakes decisions

Opus should be rare - most work should delegate down.

Implementation Notes

• Routing uses Sonnet to analyze tasks (cheap, fast, smart enough)
• Default to Sonnet if uncertain - safer than Haiku, cheaper than Opus
• I can override the recommendation if context requires it
• Track routing decisions in session notes for improvement

Examples

// Simple edit → Haiku
analyze_task_routing({ task: "Fix indentation in config.json" })
// → { agent: "haiku", reasoning: "Simple formatting task" }

// Feature work → Sonnet
analyze_task_routing({ task: "Add email validation to signup form" })
// → { agent: "sonnet", reasoning: "Standard feature implementation" }

// Complex UI → Codex
analyze_task_routing({ task: "Build interactive data visualization with D3" })
// → { agent: "codex", reasoning: "Complex UI requiring architectural decisions" }

// Strategic → Opus
analyze_task_routing({ task: "Design routing strategy for multi-agent system" })
// → { agent: "opus", reasoning: "Meta-level strategic decision" }

Cost Impact

Typical session costs (rough estimates):

• Haiku: $0.01 - $0.10
• Sonnet: $0.10 - $1.00
• Codex: $0.50 - $5.00 (reasoning tokens)
• Opus: $2.00 - $20.00

Using this routing can save 60-80% on agent costs by preventing Opus from handling Sonnet-tier work.