---
name: context-finder
description: Auto-spawn context-finder agent for search tasks. Use when user says "find", "search", "where is", "look for", "trace", "what file", "which commit", "grep", "locate". Triggers search in git history, files, issues, retrospectives.
---

# Context Finder Skill

> Auto-trigger search when user needs to find something

## Proactive Triggers

### MUST Spawn context-finder Agent When:
- User says: "find", "search", "where is", "look for"
- User says: "what file", "which commit", "locate"
- User asks: "did we work on X", "when did we", "where did"
- User needs to trace: code, history, issues, docs

### How to Invoke

Spawn the context-finder agent:

```
Task tool:
  subagent_type: context-finder
  model: haiku
  prompt: |
    Search for [USER'S QUERY] in:
    1. Git history: git log --all --oneline --grep="[QUERY]"
    2. Files: find/grep for [QUERY]
    3. GitHub issues: gh issue list --search "[QUERY]"
    4. Retrospectives: grep in ψ/memory/retrospectives/

    Return: compact list of matches with paths/commits
```

## What context-finder Searches

| Source | Command | Finds |
|--------|---------|-------|
| Git history | `git log --grep` | Commits mentioning topic |
| Files | `find`, `grep` | Current files |
| Issues | `gh issue list` | Planning, discussions |
| Retrospectives | `grep ψ/memory/` | Past session context |

## When NOT to Use

- User already knows the exact file path
- Simple questions about current code (just read it)
- User explicitly says "don't search"

## Quick Patterns

| User Says | Action |
|-----------|--------|
| "find the auth code" | Spawn agent → search "auth" |
| "where did we put X" | Spawn agent → search files + git |
| "when did we work on Y" | Spawn agent → search retrospectives |
| "trace Z" | Spawn agent → comprehensive search |