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]