investigate

Investigate Skill

Version: 1.0.0 Purpose: Keyword-based routing to specialized detective skills Pattern: Smart delegation via Task tool

Overview

This skill analyzes your investigation query and routes to the appropriate detective specialist:

• debugger-detective (errors, bugs, crashes)
• tester-detective (tests, coverage, edge cases)
• architect-detective (architecture, design, patterns)
• developer-detective (implementation, data flow - default)

Routing Logic

Priority System (Highest First)

1. Error/Debug (Priority 1) - Time-critical bug fixes

   • Keywords: "debug", "error", "broken", "failing", "crash"
   • Route to: debugger-detective

2. Testing (Priority 2) - Specialized test analysis

   • Keywords: "test", "coverage", "edge case", "mock"
   • Route to: tester-detective

3. Architecture (Priority 3) - High-level understanding

   • Keywords: "architecture", "design", "structure", "layer"
   • Route to: architect-detective

4. Implementation (Default, Priority 4) - Most common

   • Keywords: "implementation", "how does", "code flow"
   • Route to: developer-detective

Conflict Resolution

When multiple keywords from different categories are detected:

• Highest priority wins (Priority 1 beats Priority 2, etc.)
• No matches: Default to developer-detective

Workflow

Phase 1: Extract Query

The investigation query should be available from the task description or user input.

# Query comes from the Task description or user request
INVESTIGATION_QUERY="${TASK_DESCRIPTION:-$USER_QUERY}"

# Normalize to lowercase for case-insensitive matching
QUERY_LOWER=$(echo "$INVESTIGATION_QUERY" | tr '[:upper:]' '[:lower:]')

Phase 2: Keyword Detection

# Priority 1: Error/Debug keywords
if echo "$QUERY_LOWER" | grep -qE "debug|error|broken|failing|crash"; then
  DETECTIVE="debugger-detective"
  KEYWORDS="debug/error keywords"
  PRIORITY=1
  RATIONALE="Bug fixes are time-critical and require call chain tracing"

# Priority 2: Testing keywords
elif echo "$QUERY_LOWER" | grep -qE "test|coverage|edge case|mock"; then
  DETECTIVE="tester-detective"
  KEYWORDS="test/coverage keywords"
  PRIORITY=2
  RATIONALE="Test analysis is specialized and requires callers analysis"

# Priority 3: Architecture keywords
elif echo "$QUERY_LOWER" | grep -qE "architecture|design|structure|layer"; then
  DETECTIVE="architect-detective"
  KEYWORDS="architecture/design keywords"
  PRIORITY=3
  RATIONALE="High-level understanding requires PageRank analysis"

# Priority 4: Implementation (default)
else
  DETECTIVE="developer-detective"
  KEYWORDS="implementation (default)"
  PRIORITY=4
  RATIONALE="Most common investigation type - data flow via callers/callees"
fi