crafted by Mize ↗
Open Repository Intelligence Open Repository Intelligence
CodeLens ACTIVE
CodeLens Engine
StatusOnline
Versionv0.4
ModelClaude Sonnet
Latency—
← Articles
Essay · 03

Reading Code

コードレビューを「採点」ではなく「読書体験」に変えた設計

CodeLensAI · Engineering Journal

「良いレビューとは、たくさん指摘してくれるレビューだ」

——多くの人は、そう思っている。
指摘の数が、そのままレビューの価値だと。

指摘は、忘れられる

けれど、指摘された箇所を、人は全部は直さない。半分は忘れる。
「言われたから直す」は、理解ではないからだ。

コードが本当に良くなるのは、レビューを読んだあとに、コードの見え方そのものが変わったときだ。

指摘の前に、理解を置く

だから CodeLensAI は、「何を指摘するか」より先に、「何を理解させるか」を設計した。

Read → Understand → Remember
この順序は、指摘(出力)の前に、理解(読解)を必ず置くという宣言だ。

レビューが採点ではなく読書になるのは、
指摘の数ではなく、理解が残るからだ。

読ませることが、レビューだ

レビューの目的は、間違い探しではない。
書いた人に、自分のコードをもう一度「読ませる」ことだ。

良いレビュアーは、答えだけを渡さない。
読者を、もう一度コードの前に連れ戻す。

Reading Code.

良いレビューは、何を指摘したかではない。
何を理解させたかで決まる。

Next → Information Flow 情報を並べるのではなく、読む順番を設計する