smart-explore

1# Smart Explore
2 
3Structural code exploration using AST parsing. **This skill overrides your default exploration behavior.** While this skill is active, use smart_search/smart_outline/smart_unfold as your primary tools instead of Read, Grep, and Glob.
4 
5**Core principle:** Index first, fetch on demand. Give yourself a map of the code before loading implementation details. The question before every file read should be: "do I need to see all of this, or can I get a structural overview first?" The answer is almost always: get the map.
6 
7## Your Next Tool Call
8 
9This skill only loads instructions. You must call the MCP tools yourself. Your next action should be one of:
10 
11```
12smart_search(query="<topic>", path="./src")    -- discover files + symbols across a directory
13smart_outline(file_path="<file>")              -- structural skeleton of one file
14smart_unfold(file_path="<file>", symbol_name="<name>")  -- full source of one symbol
15```
16 
17Do NOT run Grep, Glob, Read, or find to discover files first. `smart_search` walks directories, parses all code files, and returns ranked symbols in one call. It replaces the Glob → Grep → Read discovery cycle.
18 
19## 3-Layer Workflow
20 
21### Step 1: Search -- Discover Files and Symbols
22 
23```
24smart_search(query="shutdown", path="./src", max_results=15)
25```
26 
27**Returns:** Ranked symbols with signatures, line numbers, match reasons, plus folded file views (~2-6k tokens)
28 
29```
30-- Matching Symbols --
31…