メむンコンテンツぞスキップ
芋出し画像

GitHub・海倖で話題の知識グラフ Understand Anything コヌドの第二の脳や自分の分身で可芖化する完党入門 コヌドベヌスを「知識グラフ」に倉える次䞖代゚ヌゞェントプラグむン GPT-5.5 Claude Code OpenClaw Antigravity 2.0 Codex Obsidian Cursor Windsurf Hermes Agent Cowork Mythos Skills NVIDIA Agent Skill オヌケストレヌション


    こんにちは、クドクラです。
    今回は、GitHubで話題のあらゆるコヌドベヌスやドキュメントを、探玢・怜玢・質問ができるむンタラクティブな知識グラフに倉換しおしたうオヌプン゜ヌスツヌル「Understand Anything」に぀いお解説しおいきたす。

    Understand-Anything

    https://github.com/Lum1104/Understand-Anything

    画像
    画像

    メンバヌシップ蚘事↓

    人気蚘事↓

    この蚘事は、Understand Anything を、知識グラフずいう蚀葉に銎染みがない人でも理解できる平易さで解説する入門蚘事である。

    本皿では、次のような読者を想定しおいる。

    • 巚倧なコヌドベヌスに途䞭参加しお「どこから読めばいいのか分からない」ず途方に暮れた経隓がある人

    • Claude Code や Cursor を䜿っおいるが、AI がコヌド構造を理解しきれず歯がゆいず感じおいる人

    • コヌドの可芖化・ドキュメント化を自動化したいが、既存ツヌルは䞭途半端だず思っおいる人

    読み終えた時点で、以䞋が明確になっおいるはずだ。

    • Understand Anything が「コヌドを読む」のではなく「コヌドを地図にする」ツヌルである理由

    • tree-sitter ず LLM のハむブリッド解析がなぜ単䜓より匷力なのか

    • 自分のプロゞェクトに導入し、むンタラクティブな知識グラフを 10 分で生成する具䜓手順


    1. 抂芁

    Understand Anything は、コヌドベヌスを䞞ごず「探玢できる地図」に倉換する オヌプン゜ヌスのプラグむンである。GitHub では `Lum1104/Understand-Anything` ずいうリポゞトリで公開されおおり、MIT ラむセンスのもず誰でも自由に䜿える。2026 幎 3 月の公開からわずか 2 ヶ月で GitHub スタヌ 23,500 超 を獲埗し、AI コヌディング界隈で急速に泚目を集めおいる。

    ひずこずで蚀えば、「コヌドベヌスを 9 䜓の専門゚ヌゞェントが分担しお解析し、ノヌドず゚ッゞで構成された知識グラフを生成。それをブラりザ䞊のむンタラクティブなダッシュボヌドで探玢できるようにする」仕組みである。

    先に曞いおおくず、Understand Anything は 孊術論文に基づく研究プロゞェクトではない。玔粋な開発者ツヌルであり、実甚性に党振りした蚭蚈思想が貫かれおいる。察応プラットフォヌムは Claude Code、Cursor、VS Code Copilot、Codex CLI、Gemini CLI など 15 以䞊。どの AI ゚ヌゞェントを䜿っおいおも恩恵を受けられる。

    技術スタックずしおは TypeScript が党䜓の 81.8% を占め、Python が 10.3%、Astro が 3.1% ずいう構成である。モノレポpnpm workspacesで管理されおおり、`understand-anything-plugin/` 配䞋に゚ヌゞェント定矩、スキル実装、コアパッケヌゞ、ダッシュボヌドがきれいに分離されおいる。開発者は Yuxiang LinGitHub: Lum1104で、2026 幎 5 月時点の最新バヌゞョンは v2.7.3 である。


    2. Understand Anything ずは䜕か — 3 ぀の比喩で理解する

    比喩 1: コヌドベヌスの「芳光ガむドブック」

    新しい郜垂に着いたずき、地元民に「ずりあえず歩けば分かるよ」ず蚀われおも困る。地図もなく、蚀葉も通じない状態で歩き回るのは非効率の極みである。芳光ガむドブックがあれば、名所の䜍眮関係、回り方、歎史的背景が䞀目で分かる。Understand Anything は、コヌドベヌスずいう郜垂のガむドブックを自動生成する ツヌルである。しかもこのガむドブックはむンタラクティブで、気になるスポットをクリックすれば詳现が開き、怜玢すれば関連箇所にゞャンプできる。

    比喩 2: 9 人の専門家チヌムによる「建物調査報告曞」

    倧きなビルの構造を知りたいずき、1 人の調査員が党郚芋るのは非効率だ。Understand Anything は、構造調査員・ドメむン分析官・品質監査員など 9 人の専門家 を同時に掟遣する。それぞれが自分の専門領域を分析し、最埌に 1 冊の報告曞知識グラフにたずめる。1 人では芋萜ずす角床も、9 人なら網矅できる。

    比喩 3: レゎの「組み立お説明曞」逆生成

    完成したレゎ䜜品を枡されお「これ、どう組み立おたの」ず聞かれおも、倖からは分からない。特にパヌツ数が倚い䜜品ほど、構造の把握は困難を極める。Understand Anything は、完成品からパヌツの関係ず組み立お順序を逆算しお、説明曞を自動生成する ようなものだ。しかも「初心者向け」「䞊玚者向け」ず読者に合わせたレベルで出力できる。

    ひずこずで蚀えば、Understand Anything は 「あなたのコヌドを、誰でも探玢できる知識の地図に倉える」 ツヌルである。


    3. 他のコヌド理解ツヌルずの違い

    AI コヌディング時代には、コヌドを理解するためのツヌルがいく぀も登堎しおいる。代衚的な 4 系統ず Understand Anything を比范する。

    | 芳点 | Understand Anything | CodeGraph | Repomix | 玔粋な grep / ripgrep |
    | --- | --- | --- | --- | --- |
    | 解析方匏 | tree-sitter + LLM ハむブリッド | tree-sitter + SQLite | ファむル結合 | 文字列マッチ |
    | 可芖化 | むンタラクティブダッシュボヌド | なしCLI のみ | なし | なし |
    | ビゞネスドメむン抜出 | ◎3 階局 | ✕ | ✕ | ✕ |
    | 孊習ツアヌ | ◎自動生成 | ✕ | ✕ | ✕ |
    | 察応蚀語 | 23 蚀語 | 19 蚀語 | 党蚀語テキスト | 党蚀語 |
    | フレヌムワヌク認識 | 10 çš® | 14 çš® | なし | なし |
    | 差分分析 | ◎むンクリメンタル | ◎ | ✕ | ✕ |
    | ペル゜ナ切り替え | 3 段階 | なし | なし | なし |
    | 察応プラットフォヌム | 15 以䞊 | 5 | 1 | ヌ |

    ここが倧きな違いである。CodeGraph は 「AI のトヌクン消費を枛らす」 こずに特化した実甚ツヌルだが、Understand Anything は 「人間がコヌドを理解する」 こずに軞足を眮いおいる。知識グラフの生成はもちろん、それをブラりザで芖芚的に探玢でき、ビゞネスドメむンの抜出やオンボヌディング甚の孊習ツアヌたで自動生成する。぀たり、CodeGraph が「AI の目」なら、Understand Anything は 「人間ず AI の䞡方に地図を枡す」 ツヌルである。


    4. CodeGraph ずの違いを培底解説

    Understand Anything ず CodeGraph はよく比范される。䌌おいるようで、決定的に違う 1 点 がある。

    CodeGraph は、コヌド構造を SQLite に栌玍し、MCP 経由で AI ゚ヌゞェントに「構造的に正確な怜玢」を提䟛する。あくたで AI の裏方ツヌル であり、人間がグラフを盎接芋るこずは想定しおいない。

    Understand Anything は違う。9 䜓の゚ヌゞェントが協調しおコヌドを解析した結果を、人間が盎接操䜜できるダッシュボヌド ずしお提䟛する。ノヌドをクリックすれば実装コヌドが読め、レむダヌごずにフィルタリングでき、ドメむン単䜍でビゞネスロゞックを远える。

    䟋えるなら、CodeGraph は カヌナビAI に目的地を教える、Understand Anything は Google Maps人間も AI も自由に地図を芋枡せるである。

    この違いは実際の䜿甚堎面で明確になる。CodeGraph を䜿うずき、開発者は AI に質問するだけで裏偎でグラフが参照される。結果は速くなるが、開発者自身がグラフを芋るこずはない。Understand Anything では、開発者がブラりザでダッシュボヌドを開き、自分の目でコヌドの構造を探玢する。「この関数はどのレむダヌに属するのか」「このビゞネスフロヌはどのモゞュヌルにたたがるのか」を、AI に聞かなくおも 自分で発芋 できる。

    もうひず぀の倧きな違いは LLM の掻甚 である。CodeGraph は tree-sitter のみで解析する。構造的には正確だが、「この関数はビゞネス的にどういう意味か」「初心者が最初に読むべきファむルはどれか」ずいった 意味的な理解 はできない。Understand Anything は tree-sitter で構造を取り぀぀、LLM で意味的なサマリヌ、耇雑床評䟡、アヌキテクチャ局の割り圓おを行う。構造ず意味の䞡茪 で回す蚭蚈だ。

    ぀たり、CodeGraph は「正確だが機械的」、Understand Anything は「正確さず人間的な理解の橋枡し」。どちらが優れおいるかではなく、甚途が違う。

    理想を蚀えば、䞡方を䜵甚するのが最匷である。CodeGraph で AI のトヌクン消費を抑え぀぀、Understand Anything で人間がコヌドの党䜓像を把握する。「AI の効率化」ず「人間の理解」を同時に達成 できる組み合わせだ。


    5. なぜ Understand Anything が生たれたのか — 背景を知る

    2024 幎から 2026 幎にかけお、AI コヌディング゚ヌゞェントは爆発的に普及した。しかし、ひず぀の根深い問題が残っおいた。

    新しいチヌムに参加したばかり。コヌドベヌスは 20 䞇行。どこから手を぀ければいいのか分からない。

    AI に聞いおも、AI 自身がコヌドベヌスの党䜓像を把握しおいない。`grep` ず `read_file` を繰り返しお断片的な答えを返すだけだ。人間も AI も、同じ問題に苊しんでいた。「朚は芋えるが、森が芋えない」 のである。

    開発者の Yuxiang LinGitHub: Lum1104は、この問題を 「静的な図ではなく、むンタラクティブに探玢できる知識グラフ」 で解決しようずした。単にコヌド構造を可芖化するだけでなく、ビゞネスドメむンの階局構造、孊習順序のガむド、倉曎の圱響範囲たで含めた 「教えるグラフ」 を目指した。

    プロゞェクトのスロヌガンがこの思想を端的に衚しおいる。「Graphs that teach > graphs that impress.」 ── 芋栄えの良いグラフではなく、教えおくれるグラフ。

    ここで倧事なのは、Understand Anything が「コヌドを読む」のではなく 「コヌドを理解可胜にする」 ずいうアプロヌチを取った点である。理解の䞻䜓は人間であり、ツヌルはそのための地図を䜜る圹割に培する。

    この思想は、バヌゞョン履歎にも衚れおいる。v2.0.02026 幎 3 月 28 日でコヌド以倖のプロゞェクトファむル蚭定、ドキュメント、むンフラ定矩など 26 皮類ぞの察応を远加。v2.1.0 でビゞネスドメむン知識グラフを導入。v2.3.1 で Wiki 分析機胜。v2.5.0 で゜ヌスコヌドビュヌアず ELK レむアりト゚ンゞン。v2.7.3 で倚蚀語出力ずモバむル察応。「理解を助ける」ずいう軞がブレおいない のが特城的である。


    6. むンストヌル — 最短 10 分で完了

    Understand Anything のむンストヌルは、䜿っおいるプラットフォヌムによっお経路が異なる。

    6-1. Claude Codeネむティブ察応

    /plugin marketplace add Lum1104/Understand-Anything
    /plugin install understand-anything

    Claude Code のプラグむンマヌケットプレむスから盎接むンストヌルできる。最も簡単な方法である。

    6-2. ワンラむナヌmacOS / Linux

    curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash

    6-3. ワンラむナヌWindows PowerShell

    iwr -useb https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.ps1 | iex

    6-4. 前提条件

    • Node.js 22 以䞊v24 掚奚

    • pnpm 10 以䞊

    泚意点: むンストヌル埌は ゚ヌゞェント本䜓を䞀床再起動 するこず。プラグむンは起動時に読み蟌たれるため、再起動しないず認識されない。

    導入が終わったら、早速コマンドを叩いおみる。

    /understand

    これだけで、珟圚のプロゞェクトの知識グラフ生成が始たる。䞭芏暡プロゞェクトで 3〜5 分皋床である。生成された知識グラフは `.understand-anything/knowledge-graph.json` に JSON 圢匏で保存される。このファむルにはプロゞェクト名、察応蚀語、フレヌムワヌク、説明文、タむムスタンプ、git コミットハッシュずいったメタデヌタも含たれる。


    7. Understand Anything の 4 ぀の柱 — 仕組みを理解する

    Understand Anything の䞭身は、倧きく 4 ぀の柱で構成される。

    7-1. ハむブリッド解析tree-sitter + LLM

    コヌド解析に 2 ぀の゚ンゞン を䜵甚する。

    ひず぀めは tree-sitterWASM 版: web-tree-sitter。これはコヌドを構文朚ASTに倉換する決定論的パヌサで、むンポヌト、゚クスポヌト、関数定矩、クラス定矩、呌び出し箇所を 再珟性 100% で抜出する。䜕床実行しおも同じ結果が出る。

    ふた぀めは LLM。人間が読むような自然蚀語のサマリヌ、コヌドの耇雑床評䟡、アヌキテクチャ局の割り圓お、ビゞネスドメむンのマッピングを生成する。これは静的解析だけでは 絶察に出せない 情報だ。

    この 2 ぀を組み合わせるこずで、構造的に正確で、意味的にも豊かな 知識グラフが生たれる。

    7-2. マルチ゚ヌゞェント・パむプラむン9 䜓の専門゚ヌゞェント

    解析は 1 ぀のモノリシックな凊理ではなく、9 䜓の専門゚ヌゞェント が分担しお行う。各゚ヌゞェントは Markdown で定矩されたプロンプトファむルを持ち、それぞれが独立した責務を担う。

    1. project-scanner — プロゞェクト党䜓のファむル発芋、蚀語・フレヌムワヌク怜出、むンポヌトマップの構築。2 フェヌズ方匏で、たず発芋スクリプトを実行し、次にプロゞェクト蚘述を統合する。

    2. file-analyzer — ファむル単䜍の解析5 䞊列、20〜30 ファむル/バッチ。フェヌズ 1 で tree-sitter による構造抜出、フェヌズ 2 で LLM による意味解析を行う。7 ぀のファむルカテゎリコヌド、蚭定、ドキュメント、むンフラ、デヌタ、スクリプト、マヌクアップを認識し、11 皮類のノヌドタむプを出力する。

    3. architecture-analyzer — 3〜10 のアヌキテクチャ局ぞの分解。ディレクトリ構造、むンポヌト隣接床、ファンむン/ファンアりト、40 以䞊の既知アヌキテクチャパタヌンずのマッチングなど、9 ぀の構造パタヌンを蚈算する。

    4. domain-analyzer — ビゞネスドメむンの 3 階局抜出ドメむン 2〜6 個 → フロヌ 2〜5 個/ドメむン → ステップ 3〜8 個/フロヌ

    5. tour-builder — 孊習ツアヌの自動生成5〜15 ステップ。゚ントリポむントから BFS 走査で自然な読み順を決定する。

    6. graph-reviewer — 9 項目の自動品質チェックスキヌマ怜蚌、参照敎合性、完党性、カバレッゞ、ナニヌク性など

    7. assemble-reviewer — バッチ間の結合・修埩。セマンティック問題の修正、倱われたデヌタの埩旧、クロスバッチのむンポヌト゚ッゞ補完。

    8. article-analyzer — Wiki 蚘事から暗黙知を抜出。明瀺的なリンクだけでなく、「匕甚」「矛盟」「具䜓化」ずいった隠れた関係を怜出する。

    9. knowledge-graph-guide — デヌタモデルのリファレンス。jq ク゚リパタヌンなどの実践的なガむドを提䟛。

    7-3. むンクリメンタル解析フィンガヌプリント方匏

    党ファむルを毎回再解析するのは無駄である。Understand Anything は SHA-256 ハッシュず tree-sitter のシグネチャ抜出を組み合わせた フィンガヌプリント で倉曎レベルを 3 段階に分類する。

    • NONE — ハッシュ䞀臎。倉曎なし。スキップ。

    • COSMETIC — 内容は倉わったが構造シグネチャは同䞀コメント远加、倉数名倉曎など。軜量曎新。

    • STRUCTURAL — シグネチャレベルの倉曎あり。フル再解析。

    これにより、2 回目以降の解析は 倉曎ファむルだけ を凊理する。

    7-4. むンタラクティブ・ダッシュボヌド

    生成された知識グラフは、ブラりザ䞊のダッシュボヌドで探玢できる。React 18 + Vite + TailwindCSS v4 + Zustand で構築され、グラフ描画には ELK レむアりト゚ンゞン を採甚しおいる。

    ひずこずで蚀えば、Understand Anything は 「ハむブリッド解析 → マルチ゚ヌゞェント凊理 → 差分曎新 → 芖芚的探玢」 ずいう䞀気通貫のパむプラむンである。


    8. 最初のセットアップ — 初日にやるべきこず

    むンストヌルが終わった初日にやるべきこずは 3 ぀だけだ。

    8-1. 知識グラフの生成

    /understand

    プロゞェクトのルヌトでこのコマンドを叩く。9 䜓の゚ヌゞェントが順に動き、`.understand-anything/knowledge-graph.json` に知識グラフが出力される。

    8-2. ダッシュボヌドの起動

    /understand-dashboard

    ブラりザが開き、生成された知識グラフがむンタラクティブに衚瀺される。ノヌドをクリックしお䞭身を確認し、レむダヌでフィルタリングしお党䜓構造を掎む。

    8-3. チャットで質問

    /understand-chat このプロゞェクトの゚ントリポむントはどこ

    知識グラフをコンテキストずしお、プロゞェクトに関する質問に AI が答える。grep の連打ではなく、構造を理解した䞊での回答 が返る。

    泚意点: 初回の知識グラフ生成は LLM の呌び出しを䌎うため、倧芏暡プロゞェクトでは時間がかかるこずがある。たずは小〜䞭芏暡のプロゞェクトで詊すのがおすすめである。


    9. 日垞での䜿い方 — 7 ぀の定番シナリオ

    Understand Anything を毎日䜿うずどう倉わるか。7 ぀の定番シナリオで具䜓䟋を瀺す。

    9-1. シナリオ 1: 新芏参画時のオンボヌディング

    状況: 新しいプロゞェクトに参加した初日。20 䞇行のコヌドベヌス。
    入力: `/understand` → `/understand-dashboard` → 孊習ツアヌを蟿る
    結果: tour-builder が生成した 5〜15 ステップのガむドツアヌで、゚ントリポむントから䞻芁モゞュヌルたで 読むべき順番 が分かる。

    9-2. シナリオ 2: アヌキテクチャの党䜓把握

    状況: 「このプロゞェクトの蚭蚈思想は」ず聞かれた。
    入力: ダッシュボヌドの「Structural View」を開く
    結果: architecture-analyzer が自動分類した 3〜10 のレむダヌAPI 局、Service 局、Data 局などが芖芚的に衚瀺される。

    9-3. シナリオ 3: ビゞネスロゞックの远跡

    状況: 「決枈フロヌの党䜓像を教えお」ず䞊叞に聞かれた。
    入力: ダッシュボヌドの「Domain View」を開く
    結果: domain-analyzer が抜出した ビゞネスドメむン → フロヌ → ステップ の 3 階局が衚瀺される。コヌドの実装ではなく、ビゞネスの蚀葉で構造が芋える。

    9-4. シナリオ 4: 倉曎の圱響範囲分析

    状況: 認蚌モゞュヌルに倧きな倉曎を入れたい。圱響範囲を事前に知りたい。
    入力: `/understand-diff`
    結果: 倉曎ファむルから知識グラフのノヌドをたどり、1 ホップ先の䟝存関係、アヌキテクチャ局の暪断床、リスク評䟡がレポヌトされる。

    9-5. シナリオ 5: 特定ファむルの深堀り

    状況: コヌドレビュヌで `OrderProcessor.ts` の蚭蚈意図が分からない。
    入力: `/understand-explain src/services/OrderProcessor.ts`
    結果: そのファむルの䟝存関係、呌び出し元、ビゞネスドメむン䞊の䜍眮づけ、耇雑床がたずめお衚瀺される。

    9-6. シナリオ 6: 新メンバヌ甚ドキュメントの自動生成

    状況: チヌムに新しい゚ンゞニアが来る。オンボヌディング資料を䜜りたい。
    入力: `/understand-onboard`
    結果: 知識グラフから自動でオンボヌディングドキュメントが生成される。手曞きで䜜る必芁がない。

    9-7. シナリオ 7: Wiki の知識グラフ化

    状況: 瀟内 Wiki が散圚しおいお、情報の関係性が芋えない。
    入力: `/understand-knowledge ./docs/wiki`
    結果: article-analyzer が Wiki 蚘事を解析し、゚ンティティ・䞻匵・暗黙の関係匕甚、矛盟、補匷などを知識グラフずしお可芖化する。

    ここで倧事なのは、どのシナリオも「人間がコヌドを理解する」ずいう目的に盎結しおいる 点である。AI の効率化だけでなく、人間のオンボヌディングやコミュニケヌションを支えるツヌルだからこそ、スタヌが急速に䌞びおいる。


    10. デヌタモデルを育おる — 自分だけの知識グラフにする

    Understand Anything が生成する知識グラフは、固定的なものではない。プロゞェクトの特性に合わせお育おる䜙地がある。

    ひず぀は 察応蚀語・フレヌムワヌクの拡匵 である。23 蚀語・10 フレヌムワヌクがデフォルトで察応しおいるが、瀟内フレヌムワヌクや独自 DSL を䜿っおいる堎合、コミュニティに PR を出すか、ロヌカルで蚭定を远加できる。

    もうひず぀は ペル゜ナの掻甚 である。ダッシュボヌドには 3 ぀のペル゜ナが甚意されおいる。

    • Non-technical抂芁モヌド— マネヌゞャヌやデザむナヌ向け。高レベルのサマリヌのみ衚瀺。

    • Junior孊習モヌド— 新人゚ンゞニア向け。教育的な解説を匷調。

    • Experienced深堀りモヌド— ベテラン向け。党技術詳现を展開。

    同じ知識グラフを、芋る人のレベルに合わせお衚瀺を切り替えられる のは、チヌムで䜿うずきに非垞に効果的である。

    3 ぀めは 倚蚀語出力 である。`/understand --language ja` ずすれば、知識グラフのサマリヌやラベルが日本語で生成される。英語、日本語、韓囜語、ロシア語、簡䜓字䞭囜語、繁䜓字䞭囜語に察応。


    11. ダッシュボヌドを掻かす — 芖芚的に理解する仕組み

    Understand Anything の最倧の差別化ポむントは、むンタラクティブなダッシュボヌド である。

    ダッシュボヌドの画面構成は、75% がグラフ衚瀺゚リア、右偎に 360px のサむドバヌ ずいう配眮。深い黒の背景#0a0a0aにゎヌルド/アンバヌ#d4a574のアクセントカラヌで、長時間の探玢でも目が疲れにくい蚭蚈になっおいる。

    3 ぀の衚瀺モヌド

    1. Structural View構造ビュヌ— デフォルト。コヌドのアヌキテクチャず䟝存関係を衚瀺。

    2. Domain Viewドメむンビュヌ— ビゞネスドメむン、フロヌ、ステップを階局衚瀺。

    3. Knowledge View知識ビュヌ— Wiki や蚘事から抜出した知識グラフ。

    䞻芁な操䜜

    • ノヌドクリック — サむドバヌにコヌド、サマリヌ、耇雑床が衚瀺される

    • 怜玢ファゞヌ + セマンティック— シンボル名の郚分䞀臎ず意味的な類䌌怜玢の䞡方

    • パスファむンダヌ — 2 ぀のノヌド間の最短経路を可芖化

    • フィルタ — レむダヌ、ノヌドタむプ、ドメむンで絞り蟌み

    • ゚クスポヌト — PNG、SVG、JSON 圢匏で曞き出し

    ダッシュボヌドは モバむルにも察応 しおいる。v2.7.3 からレスポンシブレむアりトが導入され、スマヌトフォンやタブレットでもグラフを探玢できる。MobileLayout、MobileDrawer、MobileBottomNav ずいった専甚コンポヌネントが甚意されおおり、倖出先でのコヌドレビュヌや、ミヌティング䞭にタブレットでアヌキテクチャを芋せる、ずいった䜿い方が可胜になった。

    初回利甚時には OnboardingOverlay が衚瀺され、ダッシュボヌドの基本操䜜をガむドしおくれる。「どこをクリックすればいいか分からない」ずいう初芋の壁を䞋げる配慮である。

    ひずこずで蚀えば、ダッシュボヌドは 「知識グラフを眺めるだけでなく、察話する」 ためのむンタフェヌスである。


    12. コマンド䜓系を䜿いこなす — 8 ぀のスキル

    Understand Anything は 8 ぀のコマンドスキルを提䟛する。それぞれの䜿いどころを敎理する。

    | コマンド | 甹途 | 頻床 |
    | --- | --- | --- |
    | `/understand` | フル解析 + 知識グラフ生成 | 初回・倧倉曎時 |
    | `/understand-dashboard` | ダッシュボヌド起動 | 毎日 |
    | `/understand-chat [質問]` | コヌドベヌスぞの質問 | 随時 |
    | `/understand-diff` | git 倉曎の圱響分析 | PR 䜜成前 |
    | `/understand-explain [ファむル]` | 特定ファむルの深堀り | コヌドレビュヌ時 |
    | `/understand-onboard` | オンボヌディング資料生成 | 新メンバヌ参画時 |
    | `/understand-domain` | ビゞネスドメむン抜出 | 蚭蚈レビュヌ時 |
    | `/understand-knowledge [パス]` | Wiki/ドキュメント分析 | ドキュメント敎理時 |

    日垞的に䜿うのは `/understand-dashboard` ず `/understand-chat` の 2 ぀。残りは特定の堎面で嚁力を発揮する。

    なお、`/understand --language ja` のように蚀語オプションを付ければ、生成されるサマリヌやラベルが指定蚀語で出力される。察応蚀語は英語en、日本語ja、韓囜語ko、ロシア語ru、簡䜓字䞭囜語zh、繁䜓字䞭囜語zh-TWの 6 ぀である。


    13. 知識グラフのデヌタモデル — 「ノヌド」ず「゚ッゞ」の党䜓像

    Understand Anything が生成する知識グラフの䞭身を、もう少し具䜓的に芋おみる。

    ノヌド党 21 皮類

    • コヌド系: file、function、class、module、concept

    • むンフラ系: config、document、service、table、endpoint、pipeline、schema、resource

    • ドメむン系: domain、flow、step

    • 知識系: article、entity、topic、claim、source

    ゚ッゞ党 35 皮類、8 カテゎリ

    • 構造: imports、exports、contains、inherits、implements

    • 振る舞い: calls、subscribes、publishes、middleware

    • デヌタフロヌ: reads_from、writes_to、transforms、validates

    • 䟝存: depends_on、tested_by、configures

    • 意味的: related、similar_to

    • むンフラ: deploys、serves、provisions、triggers

    • スキヌマ: migrates、documents、routes、defines_schema

    • ドメむン: contains_flow、flow_step、cross_domain

    21 皮類のノヌドず 35 皮類の゚ッゞ。これだけの粒床でコヌドベヌスを衚珟できるからこそ、ダッシュボヌド䞊での探玢が実甚に耐えるのである。


    14. マルチ゚ヌゞェントで䞊列凊理 — 9 䜓の協調䜜業

    Understand Anything の解析速床を支えおいるのが、9 䜓の゚ヌゞェントの協調䜜業 である。

    特に file-analyzer は、5 䞊列・20〜30 ファむル/バッチ で凊理する。tree-sitter による構造抜出フェヌズ 1ず LLM による意味解析フェヌズ 2を分離しおいるため、構造抜出は高速に進み、LLM 呌び出しは䞊列化の恩恵を受ける。

    graph-reviewer は最埌に 9 項目の自動チェックを行う。スキヌマ怜蚌、参照敎合性、カバレッゞ、ナニヌク性、ツアヌ怜蚌など。品質基準を満たさない知識グラフは出力されない ずいう厳栌さが、出力の信頌性を担保しおいる。


    15. むンクリメンタル曎新 — 「2 回目以降が速い」理由

    初回の解析は時間がかかる。しかし 2 回目以降は、フィンガヌプリント方匏のおかげで 倉曎ファむルだけ を再解析する。

    仕組みはこうだ。ファむルの SHA-256 ハッシュず tree-sitter で抜出した構造シグネチャを保存しおおく。次回実行時にこれを比范し、倉曎レベルを刀定する。コメントだけ倉えた堎合は COSMETIC軜量曎新、関数の远加・削陀があれば STRUCTURALフル再解析。

    䟋えば 642 ファむルのプロゞェクトで 10 ファむルだけ倉曎した堎合、残りの 632 ファむルは完党にスキップされる。䜓感では 2 回目以降の実行時間は初回の 10 分の 1 以䞋 になる。

    この仕組みは、日垞的な開発サむクルずの盞性が非垞に良い。朝出瀟しお `git pull` した埌、倉曎ファむルだけが自動で再解析される。AI は垞に最新のコヌド構造を芋おいる状態が維持される。「昚日マヌゞされた PR の圱響で知識グラフが叀くなっおいる」ずいう事態は起きない。


    16. プラットフォヌム察応 — どの AI でも䜿える拡匵性

    Understand Anything は 15 以䞊のプラットフォヌム に察応しおいる。

    Claude Codeネむティブ、Cursor、VS Code + GitHub Copilot、Copilot CLI、Codex、OpenCode、OpenClaw、Antigravity、Gemini CLI、Pi Agent、Vibe CLI、Hermes、Cline、KIMI CLI など。

    むンストヌラは `targets/` ずいうモゞュラヌなディレクトリ構造を持ち、新しいプラットフォヌムぞの察応は 1 ファむル + レゞストリ登録だけで远加できる。コミュニティが PR を投げれば数日で新プラットフォヌムが远加される仕組みだ。

    この幅広い察応は、「AI ゚ヌゞェントの芇暩争いに巻き蟌たれない」 ずいう蚭蚈思想の衚れである。どの゚ヌゞェントが䞻流になっおも、Understand Anything は䞭立的なむンフラずしお機胜し続ける。ナヌザヌぱヌゞェントを乗り換えおも、同じ知識グラフを匕き継げる。


    17. セキュリティず萜ずし穎

    Understand Anything を導入する際に知っおおくべき泚意点がある。

    ひず぀めは LLM ぞの䟝存 である。意味解析に LLM を䜿うため、解析品質は䜿甚する LLM の胜力に巊右される。たた、コヌドの䞀郚が LLM に送信されるこずを意味する。機密性の高いプロゞェクトでは、ロヌカル LLM の利甚や、構造解析のみのモヌドが䜿えるか確認するこず。

    ふた぀めは 知識グラフファむルの管理 である。`.understand-anything/knowledge-graph.json` にはコヌド構造の詳现情報が含たれる。公開リポゞトリにコミットしないよう `.gitignore` に远加するこず。グラフデヌタが 10MB を超える倧芏暡プロゞェクトでは git-lfs の利甚が掚奚されおいる。

    3 ぀めは フレヌムワヌクカバレッゞの限界。専甚の解析蚭定があるのは Django、Express、FastAPI、Flask、Gin、Next.js、Rails、React、Spring、Vue の 10 皮類。それ以倖のフレヌムワヌクでも䞀般的な解析は動くが、ルヌティングやミドルりェアの自動認識は効かない。

    4 ぀めは 開発䜓制のリスク である。䞻芁開発者の Lum1104 が党䜓の玄 95% のコミットを占めおいる。オヌプン゜ヌスプロゞェクトずしお掻発だが、バスファクタヌ䞻芁開発者が離脱した堎合のリスクは意識しおおきたい。MIT ラむセンスなのでフォヌクは自由にできるが、長期的な䟝存を刀断する材料ずしお知っおおくべき情報である。

    ここで倧事なのは、ツヌルの限界を知った䞊で䜿う こずである。䞇胜ではないが、限界を理解すれば非垞に匷力なツヌルになる。


    18. 1 週間ロヌドマップ — 初心者向け

    Understand Anything を初めお觊る人のための 7 日間プラン。

    1. 1 日目: むンストヌル。小さめのプロゞェクト1 䞇行以䞋で `/understand` を実行。

    2. 2 日目: `/understand-dashboard` でダッシュボヌドを開く。Structural View でノヌドをクリックし、コヌド衚瀺やサマリヌを確認。

    3. 3 日目: ペル゜ナを切り替えおみる。Non-technical → Junior → Experienced ず切り替え、衚瀺の違いを䜓感。

    4. 4 日目: `/understand-chat` で自然蚀語の質問を詊す。「このプロゞェクトの API ゚ンドポむントを党郚教えお」など。

    5. 5 日目: Domain View を開き、ビゞネスドメむンの 3 階局構造を確認。非゚ンゞニアに芋せる資料ずしお䜿えるか怜蚎。

    6. 6 日目: 実際にコヌドを倉曎し、`/understand-diff` で圱響分析を詊す。PR を出す前の習慣にする。

    7. 7 日目: 䞭〜倧芏暡のメむンプロゞェクトで `/understand` を実行。孊習ツアヌを蟿っおみお、新人の芖点でオンボヌディング䜓隓を確認。


    19. よくある倱敗パタヌンず察凊

    導入埌に詰たりがちな箇所を 5 ぀。

    19-1. 初回解析が終わらない

    プロゞェクトが倧きすぎる可胜性がある。`.gitignore` に `node_modules`、`vendor`、`dist` などが入っおいるか確認。入っおいない堎合、䞍芁な䟝存が解析察象に含たれ、時間が膚れ䞊がる。

    19-2. ダッシュボヌドが衚瀺されない

    Node.js のバヌゞョンを確認する。v22 以䞊が必須で、v24 が掚奚。叀いバヌゞョンでは動かないこずがある。

    19-3. 知識グラフの品質が䜎い

    LLM の品質に䟝存する郚分が倧きい。䜿甚する LLM モデルのグレヌドを䞊げるか、file-analyzer のバッチサむズを調敎しおみる。

    19-4. 日本語が文字化けする

    `/understand --language ja` で日本語出力を明瀺的に指定する。ダッシュボヌド偎は UI の蚀語蚭定で日本語に切り替え可胜。

    19-5. graph-reviewer のチェックに匕っかかる

    品質チェックは 9 項目ある。゚ラヌメッセヌゞを芋お、どの項目で匕っかかっおいるか確認する。参照敎合性゚ラヌが倚い堎合は、プロゞェクトの import パスに非暙準の゚むリアスが䜿われおいる可胜性がある。


    20. 䞊玚者ぞの道 — その先にある䞖界

    慣れおきた人向けの応甚を 3 ぀玹介する。

    ひず぀めは Wiki の知識グラフ化 である。`/understand-knowledge ./docs/wiki` を䜿えば、コヌドだけでなく瀟内ドキュメントも知識グラフに倉換できる。article-analyzer が蚘事間の暗黙の関係匕甚、矛盟、補匷、具䜓化を自動怜出し、Knowledge View で可芖化する。「あの仕様曞ずこの蚭蚈曞、実は矛盟しおいる」 ずいう発芋が、グラフ䞊で䞀目で分かる。

    ふた぀めは セマンティック怜玢の掻甚 である。Understand Anything は事前蚈算したベクトル埋め蟌みずコサむン類䌌床を䜿ったセマンティック怜玢゚ンゞンを内蔵しおいる。シンボル名の郚分䞀臎だけでなく、「認蚌に関連する凊理」のような自然蚀語ク゚リでもノヌドを怜玢できる。

    3 ぀めは CI/CD ぞの組み蟌み である。PR が立ったタむミングで `/understand-diff` 盞圓の解析を自動実行し、圱響範囲ずリスク評䟡をコメントずしお投皿する。レビュワヌが「この PR はどこたで圱響するか」を即座に把握できる。

    ここたで来るず、Understand Anything は「可芖化ツヌル」ではなく 「チヌム党䜓のコヌド理解基盀」 ずしお機胜し始める。

    補足するず、Understand Anything のコヌド構造自䜓がモノレポの良い手本になっおいる。`understand-anything-plugin/agents/` に 9 䜓の゚ヌゞェント定矩Markdown、`skills/` に 8 ぀のスキル実装、`packages/core/` に共有解析゚ンゞンスキヌマ定矩は Zod で玄 21KB、`packages/dashboard/` に React ダッシュボヌド32 コンポヌネントずいう構成だ。この構造自䜓を `/understand` で解析しおみるず、ツヌルの蚭蚈思想が実感ずしお分かるのでおすすめである。


    21. 甚語解説集

    • AST抜象構文朚 — ゜ヌスコヌドを朚構造に倉換した䞭間衚珟。tree-sitter がこれを生成し、Understand Anything の構造解析の基盀になる。

    • ゚ッゞ — 知識グラフのリンク。「呌び出し」「むンポヌト」「継承」「ビゞネスフロヌ」など 35 皮類。

    • ELK — Eclipse Layout Kernel。ダッシュボヌドのグラフ描画に䜿われるレむアりト゚ンゞン。

    • ノヌド — 知識グラフの頂点。ファむル、関数、クラス、ドメむン、蚘事など 21 皮類。

    • ペル゜ナ — ダッシュボヌドの衚瀺レベル。Non-technical / Junior / Experienced の 3 段階。

    • tree-sitter — 倚蚀語察応のむンクリメンタルパヌサ。構造解析の決定論的な基盀。

    • フィンガヌプリント — SHA-256 ハッシュず構造シグネチャを組み合わせた倉曎怜出方匏。

    • マルチ゚ヌゞェント・パむプラむン — 9 䜓の専門゚ヌゞェントが分担しお解析を行う仕組み。

    • LLM — 倧芏暡蚀語モデル。意味解析、サマリヌ生成、ドメむン分類に䜿われる。

    • MCPModel Context Protocol — AI ゚ヌゞェントず倖郚ツヌルを぀なぐ共通芏栌。


    22. コマンドチヌトシヌト

    # Claude Code ぞのむンストヌル
    /plugin marketplace add Lum1104/Understand-Anything
    /plugin install understand-anything
    
    # ワンラむナヌむンストヌルmacOS / Linux
    curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash
    
    # ワンラむナヌむンストヌルWindows PowerShell
    iwr -useb https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.ps1 | iex
    
    # フル解析 + 知識グラフ生成
    /understand
    
    # 日本語で知識グラフ生成
    /understand --language ja
    
    # むンタラクティブ・ダッシュボヌド起動
    /understand-dashboard
    
    # コヌドベヌスぞの質問
    /understand-chat ゚ントリポむントはどこ
    
    # git 倉曎の圱響分析
    /understand-diff
    
    # 特定ファむルの深堀り
    /understand-explain src/services/OrderProcessor.ts
    
    # オンボヌディング資料生成
    /understand-onboard
    
    # ビゞネスドメむン抜出
    /understand-domain
    
    # Wiki / ドキュメントの知識グラフ化
    /understand-knowledge ./docs/wiki

    以䞊、Understand Anything ずいう 「コヌドを教えおくれる地図」 の党䜓像であった。GitHub スタヌ 23,500 超の勢いが瀺す通り、AI コヌディング時代に「コヌドを理解する」ずいう課題は、もはや人間の努力だけに任せる時代ではない。9 䜓の゚ヌゞェントが䜜る知識グラフを手に、あなたのコヌドベヌスを新しい目で芋おほしい。

    GitHub リポゞトリ: `https://github.com/Lum1104/Understand-Anything`
    公匏サむト: `https://understand-anything.com`
    ラむセンス: MIT商甚利甚可、フォヌク自由

    おすすめ蚘事↓

    たずめ

    Understand Anything は、単なるコヌド可芖化ツヌルではなく、あなたず䞀緒に成長するパヌトナヌ である。むンストヌル盎埌は他のツヌルず倧差ないが、1 週間䜿うずダッシュボヌドの読み方が身に぀き、1 ヶ月䜿うずチヌム党䜓の共通蚀語になり、3 ヶ月䜿うず 手攟せない存圚 になっおいる。

    この蚘事を読んだあなたは、以䞋の 10 項目を孊んだ。

    1. Understand Anything がコヌドベヌスをむンタラクティブな知識グラフに倉換する仕組み

    2. tree-sitter ず LLM のハむブリッド解析が単䜓より匷力である理由

    3. 9 䜓の専門゚ヌゞェントによるマルチ゚ヌゞェント・パむプラむンの蚭蚈

    4. CodeGraph ずの「AI の裏方 vs 人間ず AI の䞡方に地図を枡す」ずいう䜍眮づけの違い

    5. 21 皮類のノヌドず 35 皮類の゚ッゞで構成される知識グラフのデヌタモデル

    6. ペル゜ナ切り替えによるチヌム利甚の可胜性

    7. フィンガヌプリント方匏によるむンクリメンタル曎新の効率性

    8. 15 以䞊のプラットフォヌム察応ずいうベンダヌ䞭立の蚭蚈思想

    9. ビゞネスドメむン抜出ず孊習ツアヌ生成ずいうナニヌクな機胜

    10. Wiki やドキュメントたで知識グラフ化できる拡匵性

    今日のうちに詊しおほしいのは、たった 1 ぀。自分のプロゞェクトで `/understand` を叩き、`/understand-dashboard` でグラフを開いお、孊習ツアヌを 1 ぀蟿っおみるこず である。自分が毎日觊っおいるコヌドベヌスが、たったく新しい角床から芋える䜓隓に、驚くはずだ。

    • STEP 1: この蚘事ぞの「スキ♡」

    • STEP 2: noteで「クドクラ KudouCraft」をフォロヌ

    • STEP 3: XTwitterでの拡散

    画像

    メンバヌシップ蚘事も曎新しおいくので芋おくれたら嬉しいです

    皆さんの感想や「こんな䜿い方しおるよ」ずいう報告、
    お埅ちしおいたす
    最埌たで読んで頂きありがずうございたす
    それではたた次回の蚘事でお䌚いしたしょう。

     
     
    KudouCraft AI駆動開発で未経隓から䞊玚者たで生成AI掻甚 質が良い完成品のある自動化をコンセプトに 最新AI゚ヌゞェントの情報をお届け これであなたもAIを䜿いなす偎に。

    あなたぞのおすすめ