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>
2.1 KiB
2.1 KiB
BQ-System — правила для Claude
Поиск по коду
ast-index — дефолт. ВСЕГДА первым для «найти символ по имени / usages / callers / outline». Grep/Read — только если ast-index вернул пустой результат.
vex — для поиска по смыслу, AST-паттернов, дубликатов, компактного тела символа:
vex search "..." --semantic, vex similar, vex pattern, vex duplicates, vex show.
Что и когда — подробно в .claude/rules/search-tools.md. (usages/callers по JS — только ast-index.)
# Найти класс/функцию/символ
ast-index class "ClassName"
ast-index symbol "functionName"
# Найти использования
ast-index usages "symbolName"
# Поиск по содержимому файла
ast-index search "keyword" --in-file "filename"
# Структура файла
ast-index outline "path/to/file.js"
# Универсальный поиск
ast-index search "query"
Grep использовать только для:
- Поиска строковых литералов (
"some text") - Regex-паттернов
- Если ast-index вернул пустой результат
Git — обновление репо
После любых изменений — коммит и push:
git add <изменённые файлы>
git commit -m "тип: описание"
git push origin master
- Коммитить только изменённые файлы (не
git add -A) - Сообщение коммита:
feat:/fix:/refactor:/style:+ краткое описание на русском или английском - Push выполнять сразу после коммита
Стек
- Node.js/Express backend, SQLite (better-sqlite3, sync)
- Frontend: vanilla JS, без бандлера
- ast-index проиндексирован:
ast-index rebuildпри добавлении новых файлов