Graphify:AIコーディングアシスタントを本当に賢くする知識グラフ層

June 7, 202611 min read

Graphifyとは何か?

Claude Code、Cursor、GitHub Copilotに自分のコードベースについて質問して、がっかりするほど浅い答えが返ってきた経験があるなら、あなたはすでにGraphifyが解決しようとしている問題を実感している。

Graphifyは、Y Combinator(S26)が支援するオープンソースのPythonベースのツールで、プロジェクト全体を永続的で照会可能な知識グラフに変換する。単純なファイルインデックスや基本的な検索の話ではない。Graphifyはコード、ドキュメント、PDF、画像、さらには動画の文字起こしまで取り込み、プロジェクト内のあらゆる要素が互いにどう関連しているかを捉える、構造化されたノードとエッジのウェブを構築する。

コマンドは意外にもシンプルだ:

/graphify .

これをサポートされているAIコーディングアシスタント内で入力すれば、数分でコードベース全体がマッピングされる。3つの出力ファイルがgraphify-out/に生成される:

  • graph.html — クリック、フィルタ、検索が可能なブラウザベースの対話型可視化
  • GRAPH_REPORT.md — 人間が読めるハイライトレポート:主要な概念、意外な関連性、提案される質問
  • graph.json — いつでも照会可能な完全なグラフ、ファイルを再読み込みする必要はない

Graphifyが解決する核心的な問題

AIコーディングアシスタントは強力だが、フラットファイルのコンテキストで動作している。ファイルを読む——時には一度に多くのファイルを読む——が、コードベース全体で概念がどう関連しているかを示す事前構築済みの地図を持っていない。「ログインフォームはusersテーブルにどうつながっているのか?」と質問するたびに、アシスタントはそのコンテキストをゼロから再構築しなければならず、ファイルをgrepし、生のテキストだけでは明らかでない関係性を見逃すことが多い。

Graphifyはその地図をあらかじめ計算する。tree-sitterを介して33のプログラミング言語——Python、TypeScript、Go、Rust、Java、C/C++、Swift、Kotlinなど——にわたってAST(抽象構文木)レベルの抽出を、完全にデバイス上で、コード解析ステップにAPI呼び出しを一切使わずに実行する。関数、クラス、呼び出しグラフ、データベーススキーマ、アーキテクチャ文書はすべて同じグラフのノードになる。1つのクエリで、データベーステーブルからAPIハンドラを経てフロントエンドコンポーネントまでの経路を追跡できる。


Graphifyの仕組み:内部の仕掛け

Graphifyの知性は、協調して働くいくつもの層から生まれる。

マルチモーダル取り込み

.py.tsファイルだけを読むわけではない。Graphifyは、Markdown、PDF、HTML、MDX、画像(視覚抽出経由)、そして会議の文字起こしを処理する。あなたの仕事のすべての形式が、1つの統合されたコーパスの一部になる。

Leidenクラスタリングと「ゴッドノード」

グラフを構築した後、Graphifyは関連する概念の隠れたグループを浮き上がらせるために、コミュニティ検出アルゴリズムであるLeidenクラスタリングを適用する。また、ゴッドノード(god-nodes)——グラフの中で最も高い媒介中心性を持つノード——も特定する。これらは最も多くのコミュニティを接続するファイルや関数だ。一つが壊れれば、Graphifyは即座に影響範囲(blast radius)を示すことができる。

増分的知性(完全な再構築なし)

これがGraphifyが従来のRAGパイプラインを真に超える点だ。ファイルが変更されると、Graphifyはそれを検知し、影響を受けたサブグラフだけを再抽出し、1秒未満で既存のグラフに反映する。従来のRAGの設定では、数十万件の文書を再埋め込みし、ベクトルインデックス全体を再構築する必要があり——数時間かかる。Graphifyは変更された3つのファイルを約0.8秒でパッチし、他の498,752個のノードは完全に無傷のままだ。

信頼度タグ付け

グラフ内のすべての関係は、EXTRACTED(抽出済み)、INFERRED(推論済み)、またはAMBIGUOUS(曖昧)のいずれかとしてタグ付けされる。これにより、開発者はどの接続が確実なコード解析から来たもので、どれがモデルの推論から来たものかを正確に把握できる——どの回答をどの程度信頼すべきかを知るための重要な信号だ。


AIコーディングエージェントとツールにとって重要な理由

GraphifyはあなたのAIコーディングアシスタントを置き換えるものではない。それを強化する。これがエコシステム全体でこれほど重要な理由だ:

以上のプラットフォームで動作

Graphifyはアシスタント内で自身をスキルとして登録する。Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot CLI、VS Code Copilot Chat、Aider、Devin CLI、Kiroなど、多数のプラットフォームで動作する。1人の開発者がグラフを構築し、graphify-out/をリポジトリにコミットすれば、チームメイト全員のアシスタントが——どのプラットフォームを使っていても——追加設定なしで同じグラフを照会できる。

オンボーディング問題を解決

Graphifyがなければ、大規模なコードベースに新しく参加する開発者は、文書を読み、同僚に質問し、コードをgrepするのにおよそ3週間を費やす——それでもまだコンテキストを見逃す。GraphifyとClaude Codeの/graphifyがあれば、同じ開発者はわずか4分で完全なコードベースグラフを手に入れ、決定事項を(単なるコードだけでなく)照会し、ゴッドノードを見て影響範囲を即座に理解できる。

PR影響分析

Graphifyはグラフへの影響度でレビューキューを並べ替えたり(graphify prs --triage)、グラフコミュニティを共有するPRにフラグを立てたりできる——これはマージ順序リスクの代理指標になる(graphify prs --conflicts)。これにより、あなたのAIアシスタントはコード補完ツールから、真のアーキテクチャアドバイザーへと進化する。

複数のLLMバックエンドに対応

非コードコンテンツのセマンティック抽出のために、GraphifyはGemini、Claude、OpenAI、DeepSeek、Ollama(完全ローカル)、AWS Bedrock、Kimiをサポートする。利用可能なAPIキーを自動検出する。これにより、異なるクラウドへの依存関係やエアギャップ環境を持つチームにとって柔軟性が生まれる。


実際の使用例

PostgreSQLデータベース、FastAPIバックエンド、Next.jsフロントエンドを持つPython/TypeScriptのモノレポを管理するチームを想像してほしい。新しい開発者が認証フローを理解する必要がある。

彼らは次を実行する:

graphify query "what connects the login form to the users table?"

グラフはこう返す:

LoginForm → /api/auth/login → AuthService.authenticate() → UserRepository.find_by_email() → users table

各エッジには信頼度タグが付いている。次に彼らはgraphify export callflow-htmlを実行し、あらゆるブラウザで確認できる完全なMermaidコールフロー図を得る。プロセス全体は数日ではなく数分で完了する。


トラクションとコミュニティ

数字がすべてを物語っている:

  • 61,300以上のGitHubスター、6,300以上のフォーク
  • 110万以上のPyPIダウンロード
  • 71人のコントリビューターによる668以上のコミット、ほぼ2日に1回のペースでリリース
  • Y Combinator S26の支援
  • 21社のFortune 500企業がエンタープライズ待機キューに

結語

Graphifyは、AI支援開発における欠落していたコンテキスト層だ。AIコーディングアシスタントの性能が、与えられるコンテキストの質に完全に依存する世界において、Graphifyはそのコンテキストが構造化され、永続的で、走査可能で、常に最新であることを保証する。新しいエンジニアをオンボーディングしているとき、リスクの高いPRをレビューしているとき、あるいは単にあるコードがなぜそのように書かれたのかを理解しようとしているとき——Graphifyは、あなたのAIアシスタントが本来持っていなかった地図を与えてくれる。

1つのコマンドでインストール。データベースのようにコードベースを照会する。もう二度と当てもなくgrepする必要はない。


参考資料

  1. safishamsi/graphify — GitHub Repository
  2. Graphify Labs Official Website
  3. Graphify.net — Open-Source Knowledge Graph Skill for AI Coding Assistants
  4. Augment Code Learn: Graphify hits 58.3K stars — knowledge graphs for AI coding assistants

最新情報をお届け

ニュースとアップデートをいち早くキャッチ