code-intelligencelisted

# Code Intelligence & Navigation Use the most efficient tool for each code navigation task. Structured code intelligence saves tokens compared to brute-force search. ## Tool Selection Guide ### Finding a Symbol Definition **Best:** `Grep` with a precise pattern like `^(export )?(function|class|const|type|interface) SymbolName` **Also good:** `Glob` to find likely files, then targeted `Read` with line ranges **Avoid:** Reading entire files hoping to stumble on the definition ### Finding All Usages of a Symbol **Best:** `Grep` with the symbol name, filtered by file type (e.g., `glob: "*.ts"`) **Avoid:** Reading every file in the project ### Understanding a File's Exports **Best:** `Grep` for `^export` in the specific file **Avoid:** Reading the entire file when only the API surface is needed ### Navigating Imports **Best:** `Grep` for `from ['"].*moduleName` to find who imports a module **Also good:** `Grep` for `import.*SymbolName` to find where a symbol is imported ### Finding Related Files **Best:** `Glob` with patterns like `**/auth*.ts` or `**/*Controller*` **Avoid:** `ls -R` or recursive directory reads ### Understanding Type Hierarchies **Best:** `Grep` for `extends ClassName` or `implements InterfaceName` **Also good:** `Grep` for the type name in `.d.ts` files ## Token Cost Comparison | Action | Approximate Token Cost | |--------|----------------------| | `Grep` single pattern | 50-200 tokens | | `Glob` file search | 50-150 tokens | | `Read` specific lines |