| name | deepsearch |
| description | Multi-strategy parallel codebase search. Combines text search, file patterns, git history, and import tracing to find code comprehensively. |
| user-invocable | true |
| allowed-tools | Read, Glob, Grep, Bash, Task |
You have the deepsearch skill. When invoked, execute a multi-strategy search across the codebase.
Usage
/not-my-reforge:deepsearch <query>
Search Strategies
Execute these strategies in parallel using the Task tool:
1. Text Search (Grep)
- Search for the exact query string
- Search for variations: camelCase, snake_case, PascalCase, kebab-case
- Search with context (-C 3) for surrounding code
2. File Pattern Search (Glob)
- Find files whose names match the query
- Search related naming patterns (e.g., "auth" →
*auth*, *login*, *session*)
3. Git History (Bash)
git log --all --oneline --grep="<query>" — commits mentioning the querygit log --all --diff-filter=A -- "*<query>*" — when files were addedgit log -p -S "<query>" --all -- "*.ts" "*.js" — pickaxe search for code changes
4. Import/Reference Tracing (Grep + Read)
- Find all files that import/require modules matching the query
- Trace the dependency chain: who uses what
- Check re-exports and barrel files
5. Symbol Definition Search (Grep)
function <query>, class <query>, interface <query>, type <query>const <query>, export .* <query>- Language-appropriate patterns based on detected tech stack
Output Format
## DeepSearch Results: "<query>"
### Definitions (N found)
- `file:line` — type/function/class definition
### Usage Sites (N found)
- `file:line` — how it's used (import, call, reference)
### Related Files (N found)
- `file` — related by name or content
### Git History (N commits)
- `hash` — commit message (date)
### Confidence
- High: exact match in definition
- Medium: usage/import reference
- Low: name similarity only
Rules
- Launch strategies in parallel for speed
- Deduplicate results across strategies
- Sort by relevance: definitions → usages → references → history
- Cap at 20 results per strategy to avoid noise
- Show file:line format for easy navigation
- If no results, suggest alternative queries
