deepsearch

Deep Search — Multi-Strategy Code Search

Applies multiple search strategies to find code that simple text search misses.

Workflow

Step 1: Understand Search Intent

Use AskUserQuestion:

{
  "questions": [
    {
      "question": "What are you looking for?",
      "header": "Search Type",
      "options": [
        {"label": "Pattern/Usage", "description": "Find all places where a pattern is used (e.g., all async functions, all API calls)"},
        {"label": "Concept/Feature", "description": "Find code related to a concept (e.g., 'authentication', 'caching')"},
        {"label": "Changed code", "description": "Find code that was recently modified or relates to a specific change"},
        {"label": "Dead code", "description": "Find unused functions, imports, or variables"}
      ],
      "multiSelect": false
    }
  ]
}

Step 2: Apply Search Strategies

Dispatch explorer (Haiku) with instructions to apply multiple strategies in parallel:

Strategy 1: Textual Search

• Use Grep with regex patterns
• Search for exact names, patterns, and keywords

Strategy 2: Structural Search

• Use Glob for file pattern matching
• Trace import/export chains
• Follow function call hierarchies

Strategy 3: Semantic Search

• Search by concept (related terms, synonyms)
• Look in comments, docstrings, variable names
• Search for patterns that implement the concept

Strategy 4: Historical Search (if applicable)

• Use git log --all -S "term" for code that appeared/disappeared
• Use git log --follow for file history
• Use git blame for authorship and timing

Step 3: Rank and Present Results

## Search Results: [Query]

### Strategy Results Summary
| Strategy | Matches | Top Result |
|----------|---------|------------|
| Textual | [N] | [file:line] |
| Structural | [N] | [file:line] |
| Semantic | [N] | [file:line] |
| Historical | [N] | [commit] |

### Top Results (by relevance)
1. **[file:line]** — [context snippet]
   - Found by: [strategy]
   - Relevance: [why this matches]

2. **[file:line]** — [context snippet]
   ...

### Related Files
- [Files that are connected to the search results]