---

name: agents-router description: Routes tasks to appropriate Task tool agents (subagents). Triggers on complex multi-step tasks, research, code review, exploration, or any task benefiting from specialized agent execution. Matches intent to agent types.

Agents Router

Routes tasks to appropriate Task tool subagent types for parallel or specialized execution.

Available Agent Types

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

Copy# 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

CopyTask 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

Usage Patterns

Parallel Agents

When tasks are independent:

CopyTask tool (agent1) + Task tool (agent2) in parallel

Sequential Agents

When tasks depend on each other:

CopyTask tool (research) → Task tool (implement)

Background Agents

For long-running tasks:

CopyTask 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

Copy# 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]