失敗24件が書かせた、うちのCLAUDE.mdと検証Hookを公開する——AIの「できました」を物理で止める

筆者は、AIとの作業で積み上げた失敗記録24件から「検収の三層」という考え方を前回の記事で示し、今回はその実装を公開している。ポイントは、実際に動いているファイルをそのまま見せることだ。すべての起点は一枚のマークダウンファイルで、AIとの作業でまずいことが起きるたびに一件ずつ追記していく。見出しには日付と、何を見落としたかを一行で書く。例として挙がっているのは「静止画のチェックで1fps（毎秒1コマ）の紙芝居を見逃した」という失敗で、確認の甘さがそのまま記録されている。 ここが本音の核心だ。筆者は「ルールは読まれない瞬間が必ずある」と言い切る。AIに注意書きを渡しても、長い作業の途中でその一行は埋もれる。だから大事なルールは文章のまま置いておかず、hookという仕組みに昇格させて、違反したら物理的に止める。人間の職場で言えば、マニュアルに「確認せよ」と書くのをやめ、確認しないと次の工程に進めない仕組みに変えるということだ。「できました」と言うAIを信じるのではなく、「できました」の前に機械が検査する。AIの性格を変えようとするのではなく、出力を通す関所を作るという発想が、この記事で一番面白い部分だ。 中小企業の実務に置き換えると、今日からできることは二つある。一つは、AIにやらせた仕事で失敗したら、その場で一行だけメモを残すことだ。日付と何を見落としたかを書くだけでいい。もう一つは、同じ失敗が二度目に起きたら、それを文章のルールとしてではなく、チェック項目や確認手順として仕組みに組み込むことだ。ツール選びに悩むより、失敗の記録を残して仕組みに変える人のほうが、AIを安心して任せられるようになる。記録が溜まるほど、社内に「AIに任せてはいけない場面」の地図ができていく。