Agents Router
Routes tasks to appropriate Task tool subagent types for parallel or specialized execution.
Available Agent Types
| Agent | Purpose | Best For |
|---|---|---|
| general-purpose | Multi-step research | Complex questions, code search |
| Explore | Codebase exploration | Find files, understand patterns |
| Plan | Implementation planning | Architecture, strategy |
| claude-code-guide | Claude Code help | Feature questions, how-to |
| orchestrator | Multi-domain coordination | Complex multi-agent workflows |
| strategy-analyzer | Deep strategic analysis | Refactoring, optimization |
| architect | Recursive decomposition | Complex system design |
| gemini | Long context analysis | Large codebases, multi-file bugs |
| researcher | Web research | Finding answers, investigating |
| engineer | Professional implementation | PRD execution, debugging |
Trigger Conditions
Activate when task involves:
- Complex multi-step operations
- Research requiring web/documentation search
- Code review or analysis
- Codebase exploration (files > 20)
- Multi-domain tasks (domains > 2)
- Long-running background operations
Routing Logic
# Complexity scoring
complexity_factors:
files_affected: weight 0.3
domains_involved: weight 0.25
steps_required: weight 0.25
research_needed: weight 0.2
# Thresholds
spawn_agent_if:
complexity >= 0.7 OR
files > 20 OR
domains > 2 OR
explicit_request
Decision Tree
Task Complexity Assessment
│
├── Exploration needed?
│ ├── Quick search? → Explore (quick)
│ ├── Pattern finding? → Explore (medium)
│ └── Deep analysis? → Explore (very thorough)
│
├── Implementation?
│ ├── From PRD? → engineer
│ ├── Architecture? → architect
│ └── Strategy? → strategy-analyzer
│
├── Research?
│ ├── Web search? → researcher
│ ├── Claude Code docs? → claude-code-guide
│ └── Codebase context? → gemini
│
├── Multi-domain?
│ └── orchestrator
│
└── Code review?
└── superpowers:code-reviewer (via skill)
Agent Selection Matrix
| Task Type | Primary Agent | Alternatives |
|---|---|---|
| Find files by pattern | Explore | general-purpose |
| Search code for keyword | Explore | gemini |
| Plan implementation | Plan | architect |
| Deep strategic analysis | strategy-analyzer | architect |
| Large codebase analysis | gemini | Explore |
| Web research | researcher | general-purpose |
| Multi-agent coordination | orchestrator | general-purpose |
| PRD implementation | engineer | general-purpose |
| Claude Code help | claude-code-guide | - |
Usage Patterns
Parallel Agents
When tasks are independent:
Task tool (agent1) + Task tool (agent2) in parallel
Sequential Agents
When tasks depend on each other:
Task tool (research) → Task tool (implement)
Background Agents
For long-running tasks:
Task tool with run_in_background=true
→ TaskOutput to retrieve results
Integration
- Task tool: Primary agent spawning
- TaskOutput: Result retrieval
- orchestrator agent: Multi-agent coordination
- meta-router: Parent routing
Quick Reference
# Quick codebase search
agent: Explore
thoroughness: quick
# Deep implementation planning
agent: Plan
complexity: high
# Large codebase bug
agent: gemini
context: 2M tokens
# Professional implementation
agent: engineer
from: PRD
# Multi-domain coordination
agent: orchestrator
domains: [frontend, backend, database]