Maxim Dolgolyov
f2b0db4d9a
- .claude/rules/search-tools.md — матрица: ast-index (символы/usages/callers/outline), vex (semantic/similar/pattern/duplicates/show) - usages/callers по JS — только ast-index (vex пропускает) - CLAUDE.md и ast-index.md ссылаются на новое правило Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
49 lines
1.9 KiB
Markdown
49 lines
1.9 KiB
Markdown
# ast-index Rules
|
|
|
|
> Семантический поиск / AST-паттерны / дубликаты — это **vex**, см. `search-tools.md`.
|
|
> Это правило — про ast-index (дефолт для символов, usages, callers, outline).
|
|
|
|
## Mandatory Search Rules
|
|
|
|
1. **ALWAYS use ast-index FIRST** for any code search task
|
|
2. **NEVER duplicate results** — if ast-index found usages/implementations, that IS the complete answer
|
|
3. **DO NOT run grep "for completeness"** after ast-index returns results
|
|
4. **Use grep/Search ONLY when:**
|
|
- ast-index returns empty results
|
|
- Searching for regex patterns (ast-index uses literal match)
|
|
- Searching for string literals inside code (`"some text"`)
|
|
- Searching in comments content
|
|
|
|
## Why ast-index
|
|
|
|
ast-index is 17-69x faster than grep (1-10ms vs 200ms-3s) and returns structured, accurate results.
|
|
|
|
## Command Reference
|
|
|
|
| Task | Command | Time |
|
|
|------|---------|------|
|
|
| Universal search | `ast-index search "query"` | ~10ms |
|
|
| Find class/component | `ast-index class "ComponentName"` | ~1ms |
|
|
| Find symbol | `ast-index symbol "SymbolName"` | ~1ms |
|
|
| Find usages | `ast-index usages "SymbolName"` | ~8ms |
|
|
| Find implementations | `ast-index implementations "Interface"` | ~5ms |
|
|
| Call hierarchy | `ast-index call-tree "function" --depth 3` | ~1s |
|
|
| Find callers | `ast-index callers "functionName"` | ~1s |
|
|
| Module deps | `ast-index deps "module-name"` | ~10ms |
|
|
| File outline | `ast-index outline "File.tsx"` | ~1ms |
|
|
|
|
## JavaScript-Specific Commands
|
|
|
|
| Task | Command |
|
|
|------|---------|
|
|
| Find classes | `ast-index class "ClassName"` |
|
|
| Find functions | `ast-index symbol "functionName"` |
|
|
| Find Express routes | `ast-index search "router.get"` |
|
|
| File structure | `ast-index outline "path/to/file.js"` |
|
|
|
|
## Index Management
|
|
|
|
- `ast-index rebuild` — Full reindex (run once after clone)
|
|
- `ast-index update` — After git pull/merge
|
|
- `ast-index stats` — Show index statistics
|