Files
Learn_System/.claude/rules/ast-index.md
T
Maxim Dolgolyov be4d43105e LearnSpace: full-stack educational whiteboard platform
Node.js/Express backend + vanilla JS frontend.
Features: real-time collaborative whiteboard (SSE), multi-page support,
LaTeX formulas, shapes/connectors, coordinate systems, number lines,
compass, zoom/pan, Catmull-Rom pencil smoothing, ruler/protractor with
rotation & resize controls, minimap navigation overlay, auto-measurements,
multi-page thumbnails sidebar, PNG export, page templates.
Student/teacher workflows: classes, assignments, library, dashboard.
Mobile responsive. SQLite (better-sqlite3).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-12 10:10:37 +03:00

1.7 KiB

ast-index Rules

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