# Step04: コメント挿入とソース理解（課題B 前半）

初見のSpring Bootプロジェクトを、AIにコメントを入れさせながら読み解くステップです。kadaiB フォルダを VSCode で開いて進めます。

## 参考プロンプト

まず全体像です。

```
このプロジェクトの構成を説明してください。
どの画面があり、処理がどのファイルをどう流れるかを日本語で教えてください。
```

次に、中心のファイルへ日本語コメントを入れさせます。

```
@kadaiB/src/main/java/com/example/equipment/service/EquipmentServiceImpl.java
このファイルの各メソッドに、処理の意図がわかる日本語コメントを追加してください。
ロジック自体は変更しないでください。
```

コメントが入ったら、動かして確かめます。

```
このアプリを起動する手順を教えてください。起動したら確認すべき画面も教えてください。
```

## 比較観点

- コメントを入れる前と後で、自分がコードを読む速さがどれだけ変わるか
- 「ロジックは変更しない」と縛った場合の差分の綺麗さ（縛らないと勝手に直されることがある）
- AIの説明と実際のコードにズレがないか（説明を鵜呑みにせず1箇所は自分で確かめる）

## 詰まったら

- 起動に失敗する: エラーメッセージ全文をClaude Codeに貼り付けます。ポート8080が使用中の場合は前の課題のアプリを止めます
- 説明が長すぎる: 「3行で要約してください」と依頼します
- どのファイルから読むか迷う: EquipmentController → EquipmentServiceImpl → list.html の順が読みやすい流れです
