AI以前、私は大きな変更に対してかなり長いコミット説明を書いていました。下書きして読み直すのに5分から10分かかりました。役立つ情報をすべて含め、何となぜを説明し、将来の自分が論理を理解できるようにするためでした。「私はこれをした、なぜなら…」のように一人称で書くことで、プロセスはより個人的で内省的になりました。メッセージだけの問題ではなく、書くことでコードの決定を再評価し、時には異なる、より良い変更につながりました。

現在、エージェント型コーディングでは、AIがコードとコミット説明を書きます。議論はAIが書いたコードを読むことに焦点がありますが、私はAIが書いたコミット説明の方が難しいと感じます。エージェントはツールに分散した完全な文脈を欠いており、「なぜ」を知らないと推論をでっち上げます。それは危険です。チャットやツールでエージェントにすべての文脈を与えると「なぜ」を明確に説明できますが、検証の問題は解決しません。コードが説明と一致するか確認できるのは私だけです。

だから、私は自分でコミットメッセージを書きます。これにより、AIが行った変更を振り返り、意図通りか確認せざるを得ません。「なぜ」を説明できなければ、理解していないものを出荷していることになります。コミット説明は思考ツールとして機能し、「私たちが…するまでこれをしている」のような文を、AIが推測できない出口基準とともに完成させるのを助けます。「なぜ」を書くことで、本当に理解しているかが明らかになります。