agentleFS
suntiancsuntianc/paseo-matt-workloop/skills/codegraph/SKILL.md

codegraph

Skill11 starsChanged 10 days agoMITView on GitHub

Pre-indexed code knowledge graph for codebase exploration, symbol navigation, call chains, and change-impact analysis. Use when exploring an unfamiliar repo, tracing callers/callees, or assessing blast radius before a change — replaces grep+Read loops with one query.

16 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 13 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Never use grep to verify codegraph results — AST edges are stronger evidence than text matches.

    line 36
  2. Distinctive:

    After edits, watch the staleness banner (⚠️ names a pending file) — Read that file directly for live content.

    line 38

“Common” is measured: kept by at least 6 in 10 of the 13 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

CodeGraph

SQLite knowledge graph of a codebase's symbols, edges, and files (30+ languages), served over MCP. One codegraph_explore call returns the verbatim, line-numbered source of the relevant symbols plus the call paths between them and a blast-radius summary.

Setup (per project)

codegraph init     # builds .codegraph/ index in cwd (needed before MCP tools work there)
codegraph status   # index health; pending-sync files are listed

Auto-sync keeps the index fresh: the OS-native file watcher + 2s debounce, per-file staleness banners, and catch-up reconciliation on MCP reconnect. Manual codegraph sync is only needed with CODEGRAPH_NO_DAEMON=1 or CI pre-flight.

MCP tools

IntentTool
Almost any question — architecture, flow, bug, investigationcodegraph_explore ⭐ (primary; usually the only call needed)
Locate symbol by namecodegraph_search
Call chaincodegraph_callers / codegraph_callees
Change impactcodegraph_impact
Single symbol full source / overload disambiguationcodegraph_node
File structurecodegraph_files
Index healthcodegraph_status

Principles

  • codegraph_explore first — it groups source by file with line numbers and links the call paths.
  • Answer directly from the graph; do NOT delegate exploration to file-reading subagents — that defeats the index.
  • One explore beats search + node chained calls.
  • Never use grep to verify codegraph results — AST edges are stronger evidence than text matches.
  • Graph edges are proven, not complete: a missing edge does not prove a reference is absent.
  • After edits, watch the staleness banner (⚠️ names a pending file) — Read that file directly for live content.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.