第3章調査の起点を作るため、ファイルとクラスの役割を整理する

読み始める場所を決める

プロジェクトを開いても、多数のファイルやフォルダが並ぶだけでは、重要な処理や未使用コードを区別できない。いきなりすべての実装を読むのではなく、まず所在と役割を俯瞰できる情報を作った。

フォルダ構成、ファイル一覧、クラスの役割、機能単位の分類をMarkdownへ整理した。軽量なテキストで構造を表せるため、後の調査で分かったことも更新しやすい。

構造情報をGPTへ渡し、ディレクトリ名や命名規則から役割の仮説を出させた。例えば、次のような構成なら、層ごとの分担を調べる起点になる。

src/
api/
service/
repository/
config/

これは構成例であり、名前だけで実際の設計を確定できるわけではない。controller、service、repositoryという名称があっても、その責務は実コードで確認する必要がある。

AIは探索の候補を整理し、人間はコードで検証する。この順序により、仮説を完成した仕様と取り違えずに、どこから調べるかを絞れた。

この段階で得られるのは、プロジェクト全体の位置関係と、調査の起点である。各クラスの実際の処理、呼出し関係、未使用かどうかは、次のコード調査で確かめる。

位置と確認済みの役割を一つずつ対応させることで、調査結果が次の探索にも使える。次章では、作成した地図へ実装の意味を加える。