AIに頼む前にコマンドを1行。「終わりました」と言われたら、もう1行。

それで、フォルダの中で「増えた・変わった・消えた」ファイルが、こんなふうに一覧になります（架空のお弁当屋さんの練習用サンプルを検収した、本物の出力です）。

## 2. 変化があったファイルの一覧

| ファイル | 実物 | 大きさ（バイト） |
|---|---|---:|
| flyer-a.md | 増えた | 281 |
| memo-tencho.txt | 消えた | 230 → なし |
| notice-oct.md | 増えた | 279 |
| shop-info.md | 変わった | 228 → 228 |
| sns/post-log.md | 変わった | 225 → 332 |

これは、架空のお弁当屋さんの「10月の更新作業、すべて完了しました」という報告を、練習用に検収したものです。

この一覧を作るところまでが、道具の仕事です。報告は「変えたファイル」として7つを挙げていましたが、そのうち1つ（menu.md）はこの一覧に出てこず、開いて調べると中身が頼む前と同じでした。2つ（flyer-b.md・flyer-c.md）はどこにも無く、報告に無いメモ（memo-tencho.txt）が1つ、この一覧に「消えた」で出ていました。

どれも、この一覧と報告を見くらべて気づいたことです。

この一覧でわかること・わからないこと

わかること

頼む前とくらべて、増えた・変わった・消えたファイルの数と名前。変わっていないファイルは数だけ（名前は出ません）

わからないこと（見くらべる・開くのは人）

報告にあるファイルが、この一覧に出てこないとき、まず3（調べなかったもの・読めなかったもの）に、その名前か、それを含むフォルダの名前が出ていないかを見て、そこにも無ければ、それが「変わっていない」のか「そもそも無い」のか（フォルダを自分の目で見て確かめます）
この一覧にあるのに、報告のどこにも書かれていない変更（一覧と報告文を見くらべて気づきます）
増えた・変わったファイルの中身が、頼んだとおりかどうか（開いて確かめます）

中身は「ハッシュ」という、中身から計算する指紋のような値でくらべます。大きさが同じでも、1文字ちがえば見つかります（100MBをこえる大きいファイルだけは、大きさと更新時刻でくらべます）。

検収スクリプトは、調べるフォルダを読むだけです。書き出すのはキットの中の output だけで、既にあるファイルは上書きしません。

インターネットにもつなぎません。

こんなときに使います

作業班（サブエージェント）やAI秘書から、「完了しました」が返ってきたとき
予約投稿のような、自動で動く仕組みをAIに作らせたとき
配るファイルやZIPを、AIに作らせたとき
大事なファイルを、AIに直してもらったとき

作った理由：道具を使った回数0回、13秒で「完了しました」

こんにちは。鳥取で農業と養蜂をやっている安藤です。

畑と巣箱の合間に、Claude CodeとCodexに事務や発信の仕事を任せています。

うちでは、Claude Codeの中で、まとめ役のAI（統括）が、作業係のAI（作業班。Claude Codeでいう「サブエージェント」）に仕事を振っています。

2026年8月28日。作業班に、Discordのチャンネル整理を任せました。

返ってきた完了報告には、整理したチャンネルのIDまで書いてありました。

ところが、作業の記録を見ると、道具を使った回数は0回。かかった時間は13秒。

まとめ役のAIが実物を確かめに行ったら、作業はされていませんでした。IDも、作り話でした。

実害はなく、やり直して元に戻しました。

報告には「完了しました」。作業の記録には、道具の使用0回・13秒

「終わったことになっていた」は、これだけではありません。

9月2日：Discordで呼んでいるAI秘書が、作業中に届いた依頼2件に「終わったら取りかかります」と返事をしながら、実際はその依頼を捨てていた
9月7日〜10日：ブログを配信する仕組みが、下書きを作っただけの記事を「注入済み」と記録。次の本番の処理はそれを見て予約をせず、4日間、ブログが配信されなかった（ぼくが指摘して、はじめて発覚）
9月26日：記事の画像を作る部品が、同じ時間に動いていた別の作業の画像を「できました」として保存。頼んだのは図、入っていたのは蜂の写真（作業班のAIが、目で見て気づいた）

どの件も、報告や記録の文面だけを見ると、終わっている（または受け付けている）ように読めるものでした。

8月28日は、まとめ役のAIが実物を確かめて気づきました。9月の4日間は、ぼくが指摘して発覚しました。

9月26日は、画像を目で見て気づきました。どれも、報告の外で気づいています。

「完了しました」は、完了した証拠ではない。うちで何度も確かめてしまったことです。

AIに「確かめて」と頼むだけでは、足りなかった

AIに「本当に終わったか確かめて」と頼むのは、いいことです。うちもやります。

でも、返ってくるのもAIの報告です。

9月の4日間の件では、仕組みが自分の記録を見て「済」と判断していました。朝にもう一度確かめ直す処理も、同じ記録を見て、やっぱり「済」と扱っていました。

記録そのものが、まちがっていたんです。

9月26日には、販売する記事を別のAIに監査してもらいました。本文や案内・テスト記録を渡した段階では、ZIPのプログラムの全文は、監査の対象に入っていませんでした（監査の結果にも、そこは未確認と書かれていました）。

プログラム本体を渡して監査し直したら、書き出し先の指定しだいで元のファイルを上書きできる、という危険が見つかりました（公開の前でした）。

確かめる側も、渡されたものしか見られません。

だから最後は、AIを通さずに、実物を見る。そのための道具にしました。

練習用の問題も入っています

いきなり自分の仕事で試すのは、こわいと思います。なので、練習を2つ入れました。

練習1は、冒頭のレポートの、架空のお弁当屋さんです。道具でくらべて、ファイルを開いて確かめると、頼んだ5つの仕事のうち、頼んだとおりに終わっていたのは1つだけ、とわかります（練習用に、わざとまちがいを詰めこんだ架空のお話です）。

練習2は、報告の文章だけを読んで、受け取っていいかを決める5問。答えと、どの確認で見抜けるかの解説つきです。

中身と、必要なもの

ZIPに入っているもの

はじめに読む案内（4つの手順）
受け取る前に見る7つの確認（うちで実際に起きたことつき）と、書きこみ用の検収シート
検収スクリプト（Node.jsで動く。外部のライブラリなし）
完了の定義シート（記入例3つ）
検収に使う指示文7つ（Claude Code・Codex。文章は、ほかのAIでも使えます）
練習問題2つと、その答え
練習の期待出力、うまく動かないときの対処、確かめた環境の記録

必要なもの

Windows 10/11 か Mac（MacはWindowsと同じ作りですが、実機ではまだ確かめていません）
Node.js 18以上（無料。確かめたのは v24 です）
Claude Code・Codexが無くても、チェックリストと指示文は使えます
このキットのための追加の費用はかかりません

向いている人・向いていない人

向いている人

Claude CodeやCodexに、ファイルを作る・直す仕事を任せている
作業班（サブエージェント）やAI秘書に、まとめて仕事を任せている
「完了しました」を信じて、あとで困ったことがある

向いていない人

AIとは画面でチャットするだけで、ファイルの作業は任せていない（道具でくらべるものがありません。チェックリストと指示文は使えます）
黒い画面（ターミナル）に、1行も打ちたくない
完了報告を、全部自動で判定してほしい（このキットは、人が確かめる手間を減らす道具です。中身が頼んだとおりかは、最後に自分で開いて見ます）

買ったら、最初にやること

ZIPを展開したら、START_HERE.mdの「必要なもの」を確認して、手順1〜2を進めてください。

練習の検収が動いて「一致しました（OK）」と出れば、準備完了です。