Show HN: Arcaide – マルチレベルコールグラフでコードを探索
Show HN: Arcaide – Explore code with multi-level call graphs (arcaide.foo)
要約
Arcaideは、関数レベルだけでなくクラスやパッケージといった高レベルの単位までコードの構造を可視化する「マルチレベルコールグラフ」を提案するツールです。LLMによる意味解析を取り入れ、構造と振る舞いの両方を統合した単一のグラフを生成することで、大規模なコードベースの理解を支援します。このツールは、コードの全体像を把握し、複雑なソフトウェア開発におけるナビゲーションを容易にすることを目指しています。
全文翻訳
新しいコードベースに取り組む際に私がよく行うのは、エントリーポイントを見つけ、呼び出しパスをたどって探索することです。これにより、コード内のさまざまなコンポーネントとその接続方法の全体像を把握できます。これを視覚的な体験に落とし込みたいと考えました。これはコールグラフの使用方法に似ていますが、従来のコールグラフにはいくつか問題があります。1つは、コールグラフは関数レベルでフローを表すため、アーキテクチャのコンテキストが失われることです。また、コールグラフは非常に大きくなる傾向があり、プログラムのサイズとともに指数関数的に増加する可能性があります。
私が探求しているアプローチは、「マルチレベル」コールグラフを構築することです。これらは、関数レベルだけでなく、クラスやパッケージといったより高レベルの単位にまでロールアップされたプログラム構造の形式で表されるコールグラフです。これにより、C4ダイアグラムのように、ズームイン・ズームアウトしてさまざまな抽象度でコードを表示し、関心のある領域を展開し、残りを折りたたむことで大規模なグラフをナビゲートできます。
その後、グラフはLLMに供給され、意味解析が行われます。これにより、2つのことが行われます。テレメトリを検出し、それをグラフから剥ぎ取ってさらに凝縮する単純なユーティリティを削除し、外部インターフェースと依存関係を特定してグラフをリッチ化します。結果として、構造的側面と行動的側面の С4両方を取り込んだ単一のグラフが得られます。パッケージレベルの依存関係、クラスの構成と関係、さらには外部サービス、データベース、ユーザーインタラクションを見ることができます。パッケージ図 + クラス図 + ユースケース図を1つの複合図に組み合わせたものと考えてください。
もちろん、最終的にはソースコードが王様です。コードを読んで、それが何をしているかの詳細を理解することに代わるものはありません。しかし、地図は地形の代わりにはなりませんが、どこを歩くべきかを示してくれます。手作業で1行ずつコーディングする時代から、コード全体を生成するエージェントをオーケストレーションする時代へと移行するにつれて、「全体像」を維持することがますます重要になっています。私たちは、地形をナビゲートするのに役立つ、より良い地図を必要としています。
しかし、皆さんの意見をぜひ聞きたいです。リンク[1]にあるサンプルダイアグラムをいくつかチェックして、フィードバックを共有してください。プログラム理解全般についての皆さんの考えにも興味があります。
[1] リンク: https://arcaide.foo/