Essay · 03
Reading Code
コードレビューを「採点」ではなく「読書体験」に変えた設計
「良いレビューとは、たくさん指摘してくれるレビューだ」
——多くの人は、そう思っている。
指摘の数が、そのままレビューの価値だと。
指摘は、忘れられる
けれど、指摘された箇所を、人は全部は直さない。半分は忘れる。
「言われたから直す」は、理解ではないからだ。
コードが本当に良くなるのは、レビューを読んだあとに、コードの見え方そのものが変わったときだ。
指摘の前に、理解を置く
だから CodeLensAI は、「何を指摘するか」より先に、「何を理解させるか」を設計した。
Read → Understand → Remember
この順序は、指摘(出力)の前に、理解(読解)を必ず置くという宣言だ。
レビューが採点ではなく読書になるのは、
指摘の数ではなく、理解が残るからだ。
読ませることが、レビューだ
レビューの目的は、間違い探しではない。
書いた人に、自分のコードをもう一度「読ませる」ことだ。
良いレビュアーは、答えだけを渡さない。
読者を、もう一度コードの前に連れ戻す。
Reading Code.
良いレビューは、何を指摘したかではない。
何を理解させたかで決まる。