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