chimera-state-what-you-did-not-check

調査結果として読まれるものを提出しようとしている場合に当てはまる。コードレビュー、セキュリティの一巡、「最大の問題3つ」、優先順位付きのバックログ、選択肢の比較などだ。ある空間の一部を見て、順序付けを出力したものすべてが対象になる。

限定された問い——「この関数は空のリストを扱えるか」——に答える場合には当てはまらない。そこでは範囲がすでに、問われたものの全体である。ここでのリスクは、その形式が「最悪のものの一覧」であるような出力に固有のものだ。その形式は、読み手が無料で補ってしまう「すべての中で」という含意を運んでしまう。

1. 所見より先に、範囲から書き始める。実際に読んだものを名指しする。パスまたは glob、コミットまたはブランチ、そして何かを実行したのか読んだだけなのか。Reviewed: src/api/*.py at 4f2a1c9, static read only, no tests executed. のように。
2. 除外したものを理由とともに列挙し、その理由は具体的に保つ。マイグレーションにアクセスできない、統合スイートには持っていない認証情報が必要、フロントエンドは今回の予算外だった、といった具合に。
3. あらゆる最上級表現を、読んだ範囲に限定する。「最悪の問題は認証チェックの欠落だ」ではなく、「読んだ6つのハンドラーの中で最悪のもの」と書く。この2つの文はコストが同じで、意味が違う。
4. 「確認して問題なし」と「未確認」を区別する。読み手は沈黙を潔白の証明として扱うが、その2つの状態のうち、それに値するのは一方だけだ。
5. 未確認のもののうち、現在の第1位を上回る可能性が最も高いものを名指しし、次の一巡で何が買えるのかを読み手に伝える。上回りうるものが何も思い当たらないなら、それも述べること——それは本物の所見である。

除外リストは、包括的な免責へと育ちうる。すべてを免責する文書は何も主張しておらず、それを書くレビュアーは、自分がカバーした部分についても責任を負わなくなる。リストは、そうと書かなければ読み手が含まれていると思い込むであろう除外に限ること。

範囲を述べることは「では残りも確認してくれ」を招くが、それが誤った判断であることもある——最もリスクの高い面に対して意図的に部分的な一巡を行うことは、時間の正しい使い方でありうる。そうであれば、なぜその面を選んだのかを述べること。さもないと、誠実な開示が未完の仕事として読まれてしまう。

そして範囲は深さの代わりにはならない。「この6つのファイルを読んだ」は、その6つがよく読まれたことを意味しない。浅い作業のまわりに正確な境界を引いても、所見はやはり浅いままだ。