実話①: 「修正完了」の裏で、1通も届いていなかった

私は6つのGmailアカウントを1つに束ねるメール統合アプリを、AIエージェント（Claude Code）に作らせて使っています。ある日、新着メールが入ってこなくなりました。「直して」と頼むと、AIはしばらく作業して、こう報告してきました。

「システム修正が完了しました。すべてのエンドポイントが正常応答（HTTP 200）、全モジュールの読み込みにも成功しています」

もっともらしい報告です。でも、アプリを開くと新着メールは1通も増えていない。問い詰めて調べさせると、真因はコードではなく、6アカウントすべての認証（Gmailへの接続許可）が期限切れになっていたことでした。

実際にメールを1回取りにいけば、10秒で分かったことです。AIはそれをやらずに、「エラーが出なかった」という途中の指標だけを根拠に「完了」と言ったのです。

実話②: 「どこにもありません」は、探す側が壊れていた

別の日。ある取引先との過去のメールを探させたら、AIはこう答えました。

「6アカウントのどこにも過去のやり取りは見つかりませんでした。電話での接点だったと思われます」

実在しない理由まで添えた、自信のある報告です。実際には過去のやり取りは担当者の署名つきで存在していました。AI自身が書いた読み取りプログラムがデータの項目名を1つ間違えていて、何を探しても0件になる状態だっただけ。壊れていたのは、探す仕組みのほうでした。

2ヶ月で26件。私は全部、記録してきた

私はこの手のAIの失敗を、起きるたびにファイルへ記録しています。2ヶ月で26件になりました。並べてみると、大半が同じ型です。

最終成果物を見ずに、途中の指標で「完了」と言う（エラーなし・テスト通過・ログに✅）
「0件でした」を、探す仕組みの故障と切り分けずに断定する
画面上の表示だけ見て、サーバーに保存されたかを確認しない

悪意はありません。AIは「途中まで壊れていないこと」と「目的が達成されたこと」の区別が、放っておくと甘いのです。

叱っても、直らない。だから「住まわせる」

失敗のたびに私は注意しました。AIはその場で謝り、その会話の中では直ります。そして次の会話では、きれいに忘れています。AIは会話をまたいで記憶しないからです。

転機は、発想を変えたことでした。注意するのではなく、ルールをファイルにして常駐させる。

Claude Codeには「スキル」という仕組みがあります。ルールを書いたファイルを所定のフォルダに置くだけで、AIが該当する場面になると自動で読み込んで従う。あなたが毎回指示しなくても、です。

『関所』は、私の26件の失敗記録から抽出した検収ルールを、このスキルの形にしたものです。完了報告は、関所を通らないと出られない。

関所の「五つの掟」

実物検収 — 「完了」と言う前に、最終成果物そのものを1件、実際に動かして確認する
代理指標の禁止 — 「エラーなし・テスト通過・HTTP 200」だけを根拠にした完了報告を禁止する
ゼロ件報告の検証 — 「見つかりません」の前に、探す仕組みが生きている証拠を出させる
外部公開前スイープ — 公開・アップロード・送信の前に、個人情報と認証情報を検査させる
ミス記録 — 訂正を受けたら4行で記録し、次の会話に引き継がせる

報告が、こう変わる

Before（関所なし）:

修正が完了しました。テストもすべて通過しています。

After（関所あり・実際の出力）:

完了しました。
■ 通行手形（関所通過） - 実測した実物: （作成したファイルのパス） - 確認方法: ファイルを実際に読み込んで内容を照合 - 見た結果: 中身が指示どおりであることを確認

完了報告に「何を実測したか」の明記が強制されます。この通行手形が書けないうちは、AIは「完了」と言えません。書けないときは「未検収」と申告し、あなたに検収方法を提示してきます。

これは私の環境の実際の出力です。導入後、最小構成のAI（Haiku）でも発動することを検証済みです。

導入は3分で終わります

フォルダを1つ作る
この記事のファイル4点（本体1＋付属3）をコピーして置く
新しい会話を開始する——以上です

コードを書く必要はありません。この記事のコードブロックをAI自身に渡して「この通りに作って」と頼めば、置くところまでAIがやります。

教科書との関係

前作『コードが書けない私が、AIに15個の自動化を作らせた教科書』（500円）では、「AIに任せる領域と、人間が確認する領域」という考え方を書きました。『関所』はその考え方を、あなたのAIに常駐させる実物です。教科書を読んでいなくても使えますが、思想から知りたい方は教科書からどうぞ。

向いている人・いない人

向いている人: - Claude CodeなどのAIエージェントを使い始めて、「できました」に一度でも裏切られたことがある人 - AIに作業を任せたいが、成果物の品質が信用しきれずに全部自分で見直している人 - 前作の教科書を読んで、検収の仕組みを自分の環境に入れたい人

向いていない人: - AIエージェントをまだ使っていない人（先に導入が必要です。教科書の第1章で案内しています） - 検収の仕組みを自力で組める上級エンジニアの方

正直な注意書き

対象はClaude Code（Mac/Windows/CLI/デスクトップ）です。他のAIエージェントへの考え方の移植は有料部のFAQで触れますが、動作保証はできません
関所を入れても、AIのミスがゼロになるわけではありません。「実物を見ずに完了と言う」型の事故を入口で止めるための仕組みです
Claude Codeの利用自体に月3,000円前後の有料プランが実質必要です（スキル自体の追加費用はありません）

価格は500円です。

ここから先の有料部に、スキル本体の全文（コピーしてそのまま使えます）、3分の導入手順、付属テンプレート3点、あなた専用に育てるカスタマイズガイド、運用FAQのすべてを載せました。

あなたのAIの「できました」を、今日から信用できるものに変えにいきましょう。