AIが書いたコードを読まない選択肢はあるか 詰まりは理解に移った

3行まとめ

• 差分を1行ずつ読む以外にも、AIが書いたコードを理解する道はある
• 解説文書・理解度テスト・小さな実験場という3つの手法が示された
• AIが賢くなっても人間の理解は要る、と筆者は論じる

何が起きたか

2026年7月のAI Engineerカンファレンスでの講演が、本人の手で文章として公開されました。問いは1つです。エージェントが書いたコードを、人間はまだ理解すべきなのか。

筆者の答えは「すべき」でした。そのうえで、差分を1行ずつ読むやり方だけが理解の道ではないと続けます。示された手段は、コードの解説文書、理解度を確かめる小テスト、システムを触って感触をつかむ小さな実験場の3つです。

チームで理解を共有する場にも触れています。筆者はNotionに勤めており、その点は本人が断り書きを入れています。

大事だったのはいつも、自動化するだけでなく拡張することでした。

と講演を締めています。

なぜ難しい・何がすごいか

理解する理由のほうが、先に組み替えられています。

これまでの答えは検証でした。仕様どおりか、設計は妥当か。突き詰めれば、親指を上下どちらに向けるかの判断です。

ところがエージェントは、自分の仕事を自分で点検する精度を上げています。検証だけが目的なら、人間の持ち場は削れていきます。

筆者が置く別の理由は「参加するため」です。プロジェクトはエージェントとの1回のループで終わりません。次の一手を思いつけるかは、そのシステムの概念が頭に入っているかに左右される、という主張です。

概念が薄いと、関われる範囲が実際に狭まる。筆者はこれを認知的負債認知的負債中身を理解しないまま進めることで溜まる負債。技術的負債と同じで、短期は速く、あとで効いてきます。という言葉に結びつけます。理解しないまま進める借金は、いずれ返済を迫られるという見方です。

たとえ話

ナビの案内だけで知らない街を走ると、目的地には着きます。地図は開いていません。案内が正確であるほど、開く理由もなくなります。

つまずくのは道を外れたときです。どちらへ戻ればいいのか、手がかりがない。

寄り道の行き先を思いつけるのも、街の形が頭に入っている人です。

用語ミニ辞典

• 認知的負債: 中身を理解しないまま進めることで溜まる負債。技術的負債と同じで、短期は速く、あとで効いてきます。
• マイクロワールド: 仕組みを触りながらつかむための小さな環境。教育の考え方から借りた呼び方です。
• 文芸的差分: アルファベット順に並んだ差分を、読む順の文章として組み直した見せ方。筆者の呼び名です。
• 間隔反復: 時間を空けて思い出す作業を繰り返し、記憶に定着させる学習法。

技術者向けの深掘り

1つ目の手法は解説文書です。筆者は /explain-diff というスキルを毎日使っています。出力先はHTMLやMarkdown、Notionページ。

原則は2つあります。変更点より先に前提を教えること、コードより先に狙いと直感を置くことです。

ゲームの視点を変える例では、最初にゲームエンジンの説明が来ます。続いて「2Dの描画で庭を立体的に見せる」という目的、それからアイソメトリック投影の解説。

岩をドラッグして座標の動きを追う対話的な図も埋め込まれています。差分そのものも、アルファベット順の羅列から読む順の文章に組み直されます。

文書の末尾には5問の小テストが付きます。通せるまで他人にコードを渡さない、というルールを筆者は自分に課しています。AIとの作業ではループが人間の理解速度を追い越すため、テストが速度調整弁になるという説明です。

2つ目はマイクロワールドマイクロワールド仕組みを触りながらつかむための小さな環境。教育の考え方から借りた呼び方です。。Prologインタプリタを書いていたとき、実行を1ステップずつ辿るデバッガをエージェントに作らせました。個人サイトの移行では、作業を1手ずつ自分のクリックで進める司令室UIを作らせ、旧サイトと新サイトを並べて動かしています。

これは自分に関係ある？

• エンジニア: レビューが「たぶん合っている」で終わっているなら、読み方を足す余地があります。理解を助ける道具そのものをエージェントに作らせる発想が使えます。
• 非エンジニアの人: AIに作らせた資料や集計でも事情は同じです。中身を説明できないまま持っていると、直したくなった瞬間に手が止まります。
• チームで動く人: 各自がAIと1対1で作ると、頭の中の地図が揃いません。計画や解説を共有の場に置く運用が要ります。