tomevault-io Explore codebase via INDEX.md
When to use
Apply this skill when exploring this repository and the user (or task) needs a structural picture: files, functions, types, classes, and imports across the project.
Instructions
Start with the index — Read
.cursor/INDEX.mdearly. It aggregates what would otherwise require many file opens: tree layout, per-file summaries, declarations, and import relationships (generated from the project indexer).Use it to route next steps — Pick files and symbols from the index, then open only those regions (e.g. via
read_source, symbol search, or the Read tool for edits). Avoid reading large unrelated areas when the index already answers “what lives where.”If the index looks stale — Timestamps and counts appear at the top of
INDEX.md. After substantial code changes, the maintainer may regenerate it (see project guidance such asregenerate_index/ indexer docs in-repo). If sections clearly mismatch the tree on disk, say so briefly and fall back to directory listing plus targeted reads.
Relationship to other tooling
Project rules may require indxr MCP tools for surgical queries. INDEX.md is the offline, whole-repo structural digest; MCP tools are ideal for precise symbol lookup and line-scoped reads. Use both: index for orientation and breadth, MCP (or direct reads) for depth on chosen symbols.
Examples
User: “Where is Rust query logic for TypeScript?”
- Open
.cursor/INDEX.md, find the directory tree and declaration sections forsrc/parser/queries/. - Note
typescript.rs(and related modules), then read only those files or the relevant symbols.
User: “What does the MCP server expose?”
- Scan
INDEX.mdformcp,src/mcp.rs, and linked declarations. - Drill into the named functions/types from there.
Source: bahdotsh/indxr — distributed by TomeVault.