graphify: AIコーディングアシスタントと統合し、アーキテクチャのクエリを実現するコードベースからナレッジグラフへのマッパー

何を解決するか

Graphifyは、コード、ドキュメント、PDF、画像、ビデオを含む複雑なプロジェクトディレクトリを、クエリ可能なナレッジグラフに変換します。これにより、ファイルを手動でgrepしたり、コードベースのアーキテクチャや接続関係を理解するためにすべてのドキュメントを読み込んだりする必要がなくなります。

仕組み

Graphifyは、ローカルのAST抽出（コードにはtree-sitterを使用）と、その他のメディアタイプにはAIモデルAPIを組み合わせて、プロジェクトファイルを分析します。概念、ファイル、およびアセット間の関係をマッピングし、主に3つの出力を生成します：インタラクティブなHTMLビジュアライゼーション、詳細なMarkdownレポート（GRAPH_REPORT.md）、およびプログラムによるクエリ用のgraph.jsonファイルです。さまざまなAIコーディングアシスタント（Claude Code、Cursor、GitHub Copilotなど）に「スキル」として統合でき、アシスタントが生のファイルを読み込む代わりに、グラフを直接クエリすることを可能にします。

対象者

不慣れなコードベースを迅速にマッピングし、異なるファイル形式にわたる依存関係を追跡し、AIコーディングアシスタントにプロジェクトの高レベルなアーキテクチャに関する構造化された理解を提供する必要がある開発者やアーキテクト。

ハイライト

• 幅広いファイルサポート: 36以上のプログラミング言語、Salesforce Apex、Terraform、PDF、Officeドキュメント、さらにはビデオ/オーディオの文字起こしにも対応しています。
• AIアシスタント統合: Claude Code、Cursor、Aiderなどの数十のプラットフォームにネイティブなスキルとしてインストールでき、フックや設定ファイルを通じて「常時オン」のガイダンスを提供します。
• アーキテクチャの洞察: 「God nodes」（中心的な概念）、「驚くべきモジュール間接続」、および # WHY: や # NOTE: といったコメントから設計上の根拠を抽出します。
• 自動ドキュメント化: Mermaidのコールフロー図をエクスポートしたり、グラフからMarkdownのWikiを生成したりできます。