はじめに

コードレビューはエンジニアにとって日常的な行為ですが、つい「なんとなく」で済ませてしまっていないでしょうか？

私自身、レビューを受けたり書いたりする中で、「もっと良いやり方があるのでは？」と感じることが増えてきました。
そんなとき、ネットで見かけたのが『伝わるコードレビュー』という一冊です。

実際に読んでみると、自分のレビューの質を見直すきっかけになり、「伝える力」を伸ばすためのヒントがたくさん詰まっていました。
今回はその学びと感想をまとめます。

なぜこの本を読んだか？

最近はAIがコードを書く機会も増え、PRの数も自然と増加しています。
その結果、レビューが開発フローのボトルネックになりつつあるのを実感し、レビュー力を高めたいと思うようになりました。

さまざまな企業出身のメンバーがPRを出す中で、ある同僚のPRが非常に丁寧で分かりやすく、レビューの負担を大きく下げてくれていました。
自分もそんなPRを書けるようになりたいと強く思ったのがきっかけの一つです。

前職ではチーム開発やGitの文化があまり根付いておらず、レビューも雰囲気頼り。
今こそ体系的に学び直すタイミングだと感じました。

本書では、ベテランとジュニアをモチーフにしたキャラクターのやりとりを通じて、現場でありがちなすれ違いや勘違いが丁寧に描かれています。

PRの「よくあるパターン」がケース別に扱われており、「これ、自分にもあったな……」と思わされる場面が多く、思い込みや思考のクセをリセットするのに役立ちます。

変数名や処理の流れに意図があっても、それが相手に伝わらなければ意味がありません。
レビューは「コードを書くこと」ではなく、「意図を共有すること」。
この視点を持つことの大切さを再認識しました。

| 変更前 | 変更後 |
| ----- | ----- |
| <img alt="スクショ１"/> | <img alt="スクショ２"/> |

改めて振り返ってみると、コードレビューは単なる技術行為ではなく、テキストベースのコミュニケーション能力が問われる場面だと強く感じました。

レビューは、チームでプロダクトを良くするための大切な「対話」です。
この本を通して、「どう伝えるか」の視点を持ちながら、より良いPR・レビューを実践していきたいと思います。