『リーダブルコード』再読、AIの過剰防御が可読性を損なう

この記事は技術レポートではなく読書日記として構成されている。経験の浅いエンジニアである著者は、何年も名前を聞いていた『リーダブルコード』をようやく手に取った。動機の一つは、AIがコードを書く割合が増えても、AIに読めやすいコードを書かせるには人間が読めやすいコードとは何かを知っておく必要があるという信念だ。

第1章の定義について著者は、コードは行数を最小化するのではなく、他者が理解するまでの時間を最小化すべきであり、この目標は性能や優れた設計、テスト容易性とほとんど衝突しないと指摘する。これを昨今のシンタックスシュガー流行と結びつけ、本当の試金石は構文が新しかったり短かったりするかではなく、読者が余分な「翻訳」の手順を踏まされるかどうかだと論じる。また、AIは防御的に書きがちだという未検証の印象と、可読性の敵が過剰に巧妙なコードから過剰に生成されたコードへ移り、読者は本当に必要なものと単に埋められたものを選り分けねばならないという仮説も記す。この仮説は後に検証するとして残し、学んだことをAIエージェント向け指示ファイルにしてGitHubで公開する目標も述べている。