第4章コードから仕様と依存関係を復元する

ファイルの所在から、機能の役割へ進む

プロジェクトの地図だけでは、各機能がどこに実装されているかは説明できない。そこで、主要なクラスやモジュールについて、役割、主なメソッド、他モジュールとの関係を整理した。

すべての行を同じ深さで読むのではなく、「何のために存在し、どの機能を担い、何と連携するか」を起点にした。データ取得、業務処理、UIとの連携といった役割を短く説明できるようにし、位置関係へ意味を加えた。

GPTへ対象コードを渡して日本語の説明を生成させ、その内容を実際のコードと実行結果で検証した。処理の意図やデータの流れを整理する支援には使えるが、生成された説明を正しい仕様とはみなさない。

コードを読む作業と並行し、ソフトウェアをデバッグ実行して処理を追った。UI操作から呼び出されるクラス・メソッド、条件分岐で選ばれる経路を確認し、静的に読んだ構造と実際に動く構造の差を確かめた。

この照合により、AIが示した役割の候補を、人間が確認した説明へ変えていった。

調査では、呼び出されないメソッド、到達しない処理、参照されないクラスも特定した。現行の構造理解を妨げていたデッドコードを明確に識別し、削除した。

ファイルの存在を、そのまま現行機能の存在と扱わないことが重要だった。プロジェクト構造、クラスの役割、実行フロー、不要コードの整理を合わせ、ソースコードと現在のシステム構造を対応させた。

ただし、要素の役割だけでは処理の順序や分岐を一目で追えない。次章では、確認した関係をフローとして表現する。