graphify: コードベースとドキュメントのための、grep をパス追跡とセマンティッククエリに置き換えるナレッジグラフ生成ツール

graphify: コードベースとドキュメントのための、grep をパス追跡とセマンティッククエリに置き換えるナレッジグラフ生成ツール

何を解決するか

Graphify は、コードベースとその関連ドキュメント(PDF、画像、動画)を構造化されたナレッジグラフに変換します。これにより、開発者は概念間の関係をクエリしたり、コードの異なる部分間のパスを追跡したり、ファイルを手動で grep したり、ベクトルベースの検索のみに頼ったりすることなく、アーキテクチャを理解できるようになります。

仕組み

Graphify は、ハイブリッドアプローチを使用してナレッジグラフを構築します:

  • 決定論的なコード解析: tree-sitter AST を使用して、約 40 言語のコードをローカルで解析します。これにより、呼び出し、インポート、継承などの接続が LLM を使用せずに決定論的にマッピングされ、コード解析がローカルファーストであることを保証します。
  • セマンティックパス: PDF、画像、動画などの非コード資産については、設定された AI モデルまたは API キーを使用してセマンティックパスを実行し、情報を抽出します。
  • グラフ構造: ベクトルインデックスの代わりに、すべてのエッジが EXTRACTED(ソース内で明示的に発見)または INFERRED(Graphify によって解決)のいずれかとしてタグ付けされた実際のグラフを作成します。
  • AI アシスタントの統合: さまざまな AI コーディングアシスタント(例:Claude Code、Cursor、GitHub Copilot)の「スキル」として統合され、/graphify のようなコマンドを通じてアシスタントがグラフをクエリできるようにします。

対象ユーザー

複雑なコードベースをナビゲートし、複数のファイルにわたるロジックのフローを理解し、主要なアーキテクチャ上の「god nodes」や予期せぬ接続を特定する必要があるソフトウェアエンジニアやアーキテクト。

ハイライト

  • ローカルファーストのコードマッピング: コードは tree-sitter AST を介してローカルで解析されるため、解析フェーズでコードがマシンから離れることはありません。
  • マルチモーダル対応: コード、ドキュメント、PDF、画像、および動画/オーディオを単一の統合されたグラフにマッピングします。
  • クエリ可能なインターフェース: 概念を説明し、2 つのノード間の最短パスを見つけ、自然言語クエリを実行するためのツールを提供します。
  • 幅広いアシスタント互換性: カスタムスキルのインストールを通じて、20 以上のアシスタントをサポートします。
  • 視覚的な出力: プロジェクト構造を視覚的に探索するためのインタラクティブな graph.html を生成します。

Sources