Egonex-AI/Understand-Anything

解決すること

大規模で不慣れなコードベースやナレッジベースに参入する際の「ブラインドなコードリーディング」の問題を解決します。何千行ものコードを手動でトレースする代わりに、ファイル、関数、クラス、ビジネスロジックがどのように組み合わさっているかを視覚的かつインタラクティブに理解する方法を提供します。

仕組み

本プロジェクトは、決定論的静的解析とセマンティック LLM 解析を組み合わせたハイブリッドアプローチを使用します：

• Tree-sitter は決定論的解析に使用され、インポート、エクスポート、定義などの構造的事実を抽出します。
• マルチエージェントパイプライン（スキャン、ファイル分析、アーキテクチャ、ツアー、レビュー用の専門エージェントで構成）は LLM を使用して平易な英語の要約を生成し、アーキテクチャレイヤーを特定し、ビジネスドメインをマッピングします。
• ナレッジグラフ：結果は JSON グラフとして保存され、インタラクティブな Web ダッシュボードを介して視覚化できます。
• 増分更新：ファイルの変更を追跡し、後続の実行で変更されたコードのみを再分析することでトークンを節約します。

対象者

• 新しいチームに参加したり、巨大な monorepo で作業したりして、迅速にオンボーディングする必要がある 開発者。
• ソースコードを読まずに、コードがビジネスプロセスにどのようにマッピングされるかを確認したい プロジェクトマネージャー。
• 差分影響分析を実行して、変更がシステム全体にどのような波及効果を持つかを確認する必要がある メンテナ。
• Wiki 形式のドキュメントをナビゲート可能なアイデアのグラフに変換したい ナレッジベースキュレーター。

ハイライト

• インタラクティブダッシュボード：ノードをクリックおよび検索して、要約と関係を確認できる視覚的グラフ。
• ドメインビュー：コードを現実世界のビジネスプロセス、フロー、ステップにマッピングします。
• ガイド付きツアー：依存関係順に並べられた自動生成のアーキテクチャチュートリアル。
• マルチプラットフォームサポート：Claude Code、Cursor、VS Code Copilot、Gemini CLI、およびその他のいくつかの AI コーディングツールのプラグインとして機能します。
• 差分影響分析：コミットする前に、現在の変更によってシステムのどの部分が影響を受けるかを視覚化します。