本文へスキップ
hdknr blog

Understand-Anything

コードベース・ナレッジベースを対話的なナレッジグラフに変える OSS の Claude Code プラグイン。Tree-sitter の構造解析と LLM エージェントの意味付けを分業し、結果を JSON として残してチームで共有する

概要

Understand-Anything(Egonex-AI/Understand-Anything)は、コードベース・ナレッジベース・ドキュメントを、探索・検索・質問できる対話的なナレッジグラフに変えるオープンソースのプラグイン。MIT ライセンス、TypeScript 実装で、2026 年 11 月時点の GitHub スターは約 9 万。作者はジョージア工科大学の大学院生 Yuxiang Lin 氏(Lum1104)で、現在は Egonex-AI の Organization に移管されている。

スローガンは「Graphs that teach > graphs that impress」。複雑さを誇示するのではなく、部品の組み合わさり方を教えるグラフを目指す。考え方は全体の理解を事前計算して残し、必要なときに検索して使い回すこと。

詳細

主な機能

Claude Code ではプラグインとしてネイティブに動き、Codex・Cursor・VS Code + GitHub Copilot・Gemini CLI・OpenCode・Cline・Kiro などにもインストーラーで対応する(Codex では呼び出しが $understand)。

仕組み:Tree-sitter と LLM の分業

/understand は project-scanner → file-analyzer(最大 5 並列、1 バッチ 20〜30 ファイル)→ architecture-analyzer → tour-builder → graph-reviewer の 5 エージェントで動く。/understand-domain では domain-analyzer、/understand-knowledge では article-analyzer が加わる。

グラフの中身

成果物は .ua/knowledge-graph.json 1 ファイル。project(解析時の git コミットハッシュを含む)、nodes(27 種類。コードに加え endpoint・table・domain・flow など)、edges(38 種類。imports・calls・reads_from・tested_by など)、layers、tour を持つ。各ノードには場所、LLM が書いた要約、タグ、複雑度が入る。

/understand-chat と /understand-diff は「グラフをまるごと読まず Grep で必要な部分だけ引く」手順書で、要約も検索対象になるため識別子に現れない言葉でも手がかりになる。どちらも最初に、記録されたコミットと HEAD の差分でグラフの古さを検知して警告する。

普段のエージェント作業との違いと限界

エージェントとの対話Understand-Anything
解析の範囲依頼に要る箇所だけその都度リポジトリ全体を一度に
寿命セッション限りJSON として残り差分更新
共有本人の会話の中だけコミットすればチーム全員、閲覧に LLM 不要

チームでの共有と更新運用

.ua/ をコミットすれば、他のメンバーはパイプラインを回さずに済む(.ua/intermediate/ と .ua/diff-overlay.json は .gitignore、10MB 超は git-lfs 推奨)。コミット済みグラフは Node.js 18 以上だけで、トークン付きのローカル URL から読み取り専用で閲覧できる。

--auto-update の実体は git フックではなく Claude Code のプラグインフック。PostToolUse(Claude Code が git commit などを実行したとき)と SessionStart(記録コミットと HEAD のずれ検知)で差分更新を指示する。人がターミナルで打ったコミットや GitHub 上のマージでは発火せず、並行 PR がそれぞれ大きな JSON を更新すると衝突しやすい。

ソース記事の筆者の見解は、機能 PR にはグラフ更新を含めず、マージ後の main で定期的またはリリース前に作り直してグラフだけの PR にする運用。古い間は鮮度チェックの警告に頼り、--auto-update は個人作業向き。

関連ページ

ソース記事