Agent Detection

Assign the right agent to structured tasks during the Build phase.

Scope: Task-to-agent assignment in /cwe:start Build phase and parallel orchestration. Not for: Free-text user requests in chat (→ use auto-delegation).

Detection Logic

Task from tasks.md
    ↓
1. metadata.agent set? → Use explicit agent
    ↓ no
2. metadata.skill set? → Infer agent from skill
    ↓ no
3. Keyword scan (subject + description) → First match wins
    ↓ no match
4. Fallback → builder

Keyword → Agent Mapping

Keyword table: see skills/auto-delegation/SKILL.md and hooks/scripts/intent-router.py (source of truth).

Detection order: first match wins, starting with builder (highest priority) and falling through to specialized agents. Fallback: builder (if no keywords match).

Metadata Override

Tasks in tasks.md can specify agent and skill explicitly:

metadata:
  agent: security      # Skip keyword detection
  skill: systematic-debugging  # Specific skill to invoke
  priority: 1          # Execution order (lower = first)

metadata.agent always takes precedence over keyword detection.

"test" Routing in Tasks

Tasks with "test" keywords are assigned to quality. Quality agent decides execution:

• Coverage gaps, metrics, validation → handles directly
• Writing implementation tests → delegates to builder via subagent
• CI/pipeline test config → delegates to devops via subagent

Integration with Parallel Execution

During wave execution in /cwe:start:

1. Pending tasks filtered by blockedBy status
2. Up to 3 unblocked tasks selected per wave (sorted by metadata.priority)
3. Each task assigned an agent via this detection logic
4. Agents spawned in parallel via Task tool

Examples

# Explicit agent (metadata override)
- subject: "Audit auth endpoints"
  metadata:
    agent: security
  → security (explicit)

# Keyword detection
- subject: "Implement user profile API"
  → builder (keyword: implement)

# Test task
- subject: "Write integration tests for payments"
  → quality (keyword: test)

# No match
- subject: "Update the README"
  → builder (fallback)