2026年前半、GitHubには「リポジトリを地図にする」OSSが続々登場しています。Understand Anything は数か月で 3万6千Star超（最新値はリポジトリで確認）——「大規模プロジェクトをAIが読める」期待とセットで語られがちです。MCP系 Codebase-Memory、トークン圧縮の Graphify なども並走。共通の痛み：monorepoが巨大化しCursorが局所 @ に頼るとき、構造はどこから来るか。
本稿は特定ツールを「最終回答」とせず、コード知識グラフが埋める空白、AIコーディングの持続記憶 との役割分担、Macチームの導入注意を整理します。
1. 大型リポジトリでAIがつまずく場所
IDEインデックスと @ は強力ですが、次の場面では「暗闇パッチ」になりがちです：
- ディレクトリを跨ぐ呼び出し： APIを1箇所直すと、3階層先のモジュールが壊れる——callerがコンテキストに無ければPRは正しく見える。
- 暗黙のアーキテクチャ： import禁止の理由、互換レイヤ——ADRや口頭にあり、開いているファイルには無い。
- トークン経済：
grepループ、巨大ファイル、半repo注入——コストとノイズが増える。 - 新人・オンコール： 「決済モジュールの入口は？」——ファイル一覧ではなく地図が要る。
ベクトルRAGは「似た断片」は拾えても 関係の正しさ は保証しません。知識グラフは先に 構造 を固め、LLMが意味を載せる——Star急増の中身はここにあります。
AGENTS.md と実行可能チェックの方が安い。2. Understand Anything の中身
任意のコードベースを探索・検索・質問可能な知識グラフ に——Claude Codeプラグイン、MCP、Cursor/Copilot/Gemini CLI。MIT、TS/JS/Python中心。
2.1 ハイブリッドパイプライン
- Tree-sitter等： ファイル・関数・クラス・依存エッジを決定論的に。
- マルチAgent： スキャン→ファイル分析→アーキテクチャ→ツアー→レビュー——再実行・増分可能。
- LLMで意味層： 要約、コミュニティ、ビジネスドメインビュー。
増分更新（ファイルhash）——常時開発の大仓で全量は現実的でない。
2.2 人向けダッシュボード + Agent API
MCP/Skills で部分グラフをAgentへ——「PaymentServiceに依存するのは誰？」を先に聞いてからファイルを開く。
3. よくある手法との違い
| 軸 | IDE + @ | ベクトルRAG | コード知識グラフ | 記憶 / AGENTS.md |
|---|---|---|---|---|
| 得意 | 今のファイル、diff | 類似断片、ドキュメント | 呼び出し、境界、ツアー | チーム規約、履歴 |
| 弱点 | 全体構造 | 関係ミス、レガシーの誤再ヒット | 索引保守、初回コスト | 構造理解は自動化しない |
| コスト | 開ファイル数 | embedding | 前処理+増分 | 低いが手作業 |
| 典型質問 | 「このファイルで足りる？」 | 「関連ある？」 | 「エントリポイントと影響範囲？」 | 「なぜそう決めた？」 |
現場は 組み合わせ：グラフで構造、持続記憶と規約 で次回も同じルールで改修。
4. 類似ツール早見表
| プロジェクト | 要点 | 向くチーム |
|---|---|---|
| Understand Anything | マルチAgent、可視化、MCP、増分 | 大規模リポジトリの引き継ぎ、地図式 onboarding |
| Codebase-Memory | 永続グラフ、影響分析、トークン削減 | MCP中心のAgent運用 |
| Graphify | 多種資料→グラフ、低トークンクエリ | ドキュ+コード、コスト敏感 |
AGENTS.md + CI | 自動建図なし、監査可能 | 中小規模、規約がコード化済み |
5. 導入ワークフロー
- 试点： 中程度のサービス1つ——API trace等をグラフ有無で比較（手数・トークン）。
- 索引環境： 全量分析はCPU/ディスク/IO——常駐macOS（Mac miniまたは専用リモートMac）に載せ、MCPで開発機から参照。
- AGENTS.md整合： 「決済域はグラフのPaymentコミュニティを先に見る」等。
- mainマージ後に増分； 古いグラフは無いより危険。
- セキュリティ： パス・内部名・コメント——外部索引前にコンプラ確認。
OpenClaw + リモートMac で建図をCI/定期タスクに——プライベートAIクラスタ と同様、重い分析はサーバールーム、軽い操作はIDE。
6. 「持続記憶」記事との接続
グラフ：今のrepoの形と依存。 記憶：どう直したいか、過去の轍。 グラフだけ→構造的には正しいが望まないリファクタ。規約だけ→新人は手trace。
Appleチーム：Xcode、SPM、署名、マルチtargetでファイルグラフが肥大。企業Mac CIのworktree/キャッシュ と一緒に計画し、分析とビルドでNVMeを奪い合わない。
OpenHuman のような長期Agent——グラフが地図、記憶が交通規則。
7. おわりに：地図があっても迷子にはなれる
コード知識グラフブームは、「ファイルを運任せで読ませる」疲れの表れ。決定論的解析 + 増分構造 + 意味層 + Agent I/F は大規模理解の核心——全局関係——に触れている。
記憶層・レビュー・ADRの代替ではない。実務的には：onboarding/impactにグラフ、境界に AGENTS.md+CI、索引に信頼できるMac。
分析用macOSノードが足りなければ専用M4 Mac miniを——「地図の生成・更新」を先に固め、より長いコンテキストは第二段階で。
