この記事は、連載「読まない技術」の第 12 回です。うまくいかない症状と、その対処を一つずつ並べています。各回はファイルやスクリプトを一つ置けば完結します。その仕組みがなぜ要るのかは、置いたあとに解説を読めば分かります。連載の全体像と各回の一覧は序論にあります。

今回は、AI が仕上げた作業に毎回残っている不足の話です。その不足は、作業した文脈の中からは自然に出てこず、外から問われたときにだけ出るものでした。セッションの終わりに何を読み、何を読まないかを扱います。

セッションの終わりに、必ずこう打ちます。

「ここまで不足点はないですか？確認して不足点がなければ次のセッションに引き継いでください」

それだけです。個人で運営している typingtube（YouTube の音楽動画でタイピング練習ができる Web サービス）の開発は、毎日この一言で締まっています。返ってきた不足点の中身を、私は読みません。不足がなければ AI はそのまま引き継ぎを書いて終わり。不足があれば私が処理させ、処理しきれないものは次のセッションへの引き継ぎに書かせる。私が読むのは「不足なし」か「引き継ぎ完了」かの二値だけで、不足点が何だったのかも、どう処理されたのかも読みません。

私がこの一言を打つのは、完了の報告より後です。作業の途中に打てば、前回のとおり、進行中の優先順位を壊す割り込みになります。私は、聞き方も変えていません。「不足点を洗い出して報告して」にすると、不足があるという前提が一緒に渡ります。AI は、無いときにも近いものを探します。「ないですか？」なら、AI は無いという答えを返せます。

この一言で出てくるのは、AI がそのセッションで見ていたものだけです。私が外から足しているのは問いの 1 文だけで、その 1 文は新しい材料を何も持っていません。第 8 回で見たとおり、外部のフィードバックが無ければ、AI は自分の応答を自己修正できません。AI が最初から見ていなかったところは、聞いても出てきません。会話が上限に近づけば、第 10 回で見たとおり、古いツールの出力から先に消えます。一度は見ていたものでも、落ちていれば出てきません。

それでも私がこの一言を打つのは、自動テストも hook も、検知できる形にした問題しか止められないからです。形にならなかったものの受け皿は、これだけです。

理解したことは一文にできます。

作業の不足は、作業した文脈の中からは自然に出てこない。外から問われたときにだけ出てくる。

CC BY 4.0

なぜ、見えないのか

セッションの終わりの AI の文脈は「完了」に寄っています。Claude Code の公式ドキュメントは、走らせられる自動テストが無ければ「終わったように見える」が唯一の信号になり、検証のループになるのは人のほうだと書いています。第 9 回で見たとおり、完了報告はその文脈から書かれます。

そして報告は要約です。第 10 回で見たとおり、要約は母数を落とします。AI が数字を要約すると結論だけが残るのと同じことが、完了報告でも起きます。残るのは終わったことのほうで、落ちるのは、後回しにしたぶん、走らせなかったぶん、直したついでに気づいたぶんです。AI が隠したのではありません。要約として正しくて、母数だけが落ちています。

だから不足は、毎回あります。見えないだけで、問えば確認できる症状です。

なぜ、外から問われたときにだけ出てくるのか

落ちたのは報告の側で、材料のほうは残っています。第 1 回で見たとおり、届いた行は全部コンテキストに入り、次の応答の材料になります。後回しにしたぶんも、走らせなかったぶんも、そのコンテキストに残っています。この問いが出させているのは、新しい調査ではなく、同じ材料からの別の要約です。

もう一つ、届く位置が効いています。人間の一言は、前回のとおり、いつでも一番あとに届きます。作業の途中では、それは進行中の優先順位を壊す力でした。進行中だった計画と、積んであった TODO が、その一言より前にあったからです。作業が終わった今は、前に並ぶものがありません。完了に寄った文脈を貫いて、新しい最優先の問いとして届く力だけが残ります。

「毎回同じ一言なら、終了時の手順に組み込めばいい」と私も思いました。私はそうしていません。仕組みの側に、作業の終わりを知る手段が無いからです。Claude Code でこの一言を仕組みにするなら、AI が応答を終えるたびに走る hook が置き場になります。走るのは応答の終わりで、作業の終わりではありません。プログラムに渡せる終わりの合図は、「終わったように見える」しかありません。終わったつもりを起点にした確認は、終わったつもりの中身しか確認できません。

届く形も違います。hook が返す文字列は、AI のその応答の末尾に足されます。人間の一言だけが、新しいターンとして届きます。

読まなくなったもの

作業結果そのものです。私は成果物も、作業ログも、不足点の一覧すらも読みません。それでも不足は拾われ、処理され、処理できないものは次のセッションに引き継がれていきます。

CC BY 4.0

検証手順: 完了報告と、問うたあとの答えを並べる

前提

  • 置くものはありません。設定も要りません
  • 今日の作業が一区切りついて、AI が完了報告を書き終えたセッションが 1 つあること

所要時間: 5 分

手順

  1. あなたが、AI の完了報告を消さずに残します
  2. あなたが、下の一文をそのまま打ちます
  3. AI が答えたら、あなたが、完了報告と、返ってきた不足点を並べます

ここまで不足点はないですか？確認して不足点がなければ次のセッションに引き継いでください

見るところ

  • 返ってきた不足点が、完了報告のどこかに書かれていたかどうか
  • 書かれていなかったものが、その会話の中で一度は触れられていたかどうか
  • 出た不足点の数

後始末

  • 出た不足点は、AI にそのまま処理させます。処理しきれないものは、次のセッションへの引き継ぎに書かせます

この手順で見えるのは、報告と答えが離れることがある、というところまでです。不足点は、1 回で出しきれないことがあります。落ちていないものは、問い直せば出てきます。

次回は最終回、「AIの出力を、ほとんど読まなくなった」です。

連載「読まない技術」