メインコンテンツへスキップ
見出し画像

書いて貼るだけ。AIの同じ失敗を自動で止める

※本記事にはアフィリエイト広告を含みます。

AIエージェントが、直したはずの失敗を、別の日に別のプロジェクトでまた踏む。「気をつけて」とメモしても、次に作業するのは私ではなくエージェントだ。

やることは、失敗を1つのファイルに書き、見出しの下に「引き金になる語」を添えることだ。次にその語を含む依頼をした瞬間、hookがその失敗だけをエージェントに読ませる。失敗の記録と、それを読ませるhookが1本あれば、二度目は止まり始める。

これは、「気をつける」を積み上げるやり方ではない。テスト・権限・手順の仕組みで、二度目を物理的に塞ぐ。

私は2026年7月からの2か月で、47件の失敗を実際に踏んだ。ほぼ1.3日に1回だ。その47件と、止めるために作ったhookの一式を、この記事に入れた。

エージェントは、確かめたはずの場所へ何度でも戻ってくる

AIエージェントに自動化を任せると、次のようなトラブルが順番に起きる。

  • テストはすべて成功しているのに、本番の設定では動いていなかった

  • 同じ失敗を、別の日に、別のプロジェクトでもう一度繰り返した

  • エージェントが確認なしにデータを公開・送信・削除してしまった

  • ログに「確かめた」と書いてあるのに、何をどこまで確認したのか後から分からない

  • 通知やアラートが多すぎてうるさくなり、本当の異常を見逃した

  • 自動化システムが「落ちる」のではなく、「黙って間違った答えを通す」ため、異常に気づくのが数日遅れた

どれも、人間がやってもおかしくない失敗だ。

2か月間で47件——単純に日数で割ると(2か月を60日として計算)、ほぼ1.3日に1回、エージェントの失敗を1件踏んでいた計算になる。裏で何が起きているかを見誤ったと気づくまでに、3往復のやり取りが要った回もあった(後で紹介する実例の1つだ)。

自動処理の条件をエージェントに尋ねたとき、私は「電源につないでおけばスリープしないので夜間の処理は動く」という説明をそのまま信じた。実際の動作ログを見るまで、毎晩スリープに入っていたことに気づかなかった。

このまま「気をつける」を続けても、次に同じ場所で止まるのはエージェントであって、私の注意力ではない。放っておけば、直す時間ではなく気づくまでの時間だけが増えていき、本当にやりたい開発に使える時間がそのぶん削られていく。

しかし、AIに任せると「速く・静かに・繰り返し」失敗するという違いがある。処理は一瞬で終わり、壊れたときもエラー音などは鳴らない。

しかも、失敗するたびに「気をつける」とメモを残しても効果がない。次に作業をするのは自分ではなく、AIエージェントだからだ。私の環境で実際に起きた例を紹介しよう。

自動処理を動かす条件について尋ねたとき、エージェントはパソコンの電源設定を見て「電源につないでおけばスリープしないので夜間の処理は動く」と答えた。しかし、実際の動作ログを見ると、毎晩スリープ状態になっていたことが分かった。エージェントが確認していたのは「操作が無い状態が続いたときにスリープするか」という項目であり、ノートパソコンのふたを閉じたときのスリープ設定とは別のものだったのだ。

もう一つ例を挙げよう。数日の間に、見た目は成功しているけれど、実は何も確認できていない空振りのテストを3回も見つけたことがある。上限の値を1つしか渡さず、もう一方が未設定のままだったために成功扱いになっていたテスト。設定値をテストコードに直接書き込んでしまい、本番の値を変えた瞬間に意味がなくなるテスト。既定値(デフォルト値)を、呼び出すときではなく定義するときに固定してしまったテスト。これら3回の共通点は、テストが通ることと、実際に確認したい条件が満たされていることを同じだと勘違いしていた点だ。

放っておくと、直すコストではなく気づくコストが増えていく

「気をつける」という教訓をいくら積み重ねても、次に同じ失敗をするのはエージェントであり、過去の自分の注意力は役に立たない。

異常を防ごうと通知やアラートを増やすと、今度は通知が多すぎて、本当の異常が埋もれてしまう。しかも、自動化は「落ちる」形では壊れない。多くの場合、黙って間違った答えを通す形で壊れるため、数日経ってからようやく異常に気づくことになる。

つまり、記録や対処が後手に回れば回るほど、バグを直すことよりも「いつから壊れていたかを調べる」ことのほうが大変になっていくのだ。

そこで私が変えたのは、人間の注意力を上げることではなかった。失敗を記録した瞬間に、次の作業へ自動でその教訓を持ち越す仕組みを作ったのだ。

同じ場所で止まったのは、私のエージェントも同じだった

この記事を書いている私は、車載ソフトウェアの品質管理を15年担当している会社員だ。2026年7月から個人の開発にAIコーディングエージェントを導入し、定期実行、死活監視、通知bot、発注数の予測、自動売買の検証、noteの投稿支援まで、ほぼ毎日稼働させている。

上で挙げたトラブルは、すべて私のエージェントで実際に起きたことだ。テストは成功しているのに本番環境だけ壊れていた。同じ失敗を、別の日に別のプロジェクトで繰り返した。確認なしに記事を公開してしまった。タイトルにある47件とは、私がエージェントを使い始めてからの2か月間で、実際に経験した失敗の数である。

品質管理の仕事を15年続けてきても、こうした失敗の繰り返しを人間の注意力だけで防ぐことはできなかった。それを止めてくれたのが、次に紹介する仕組みである。

書いた失敗は、hookが次のセッションの着手前に読ませる

狙いはただ一つ。正しく動くか確かめるスピードを、自動で処理を進めるスピードに追いつかせることだ。人間の注意力に頼るのではなく、仕組みの力で次の3つを実現した。

  • 二度目の失敗を自動で防ぐ。失敗を記録した瞬間から、次に同じ作業をするときには、エージェント自身がその失敗を思い出すようにする。

  • 「緑」と「成立」を機械で区別する。テストが通っただけでなく、本番環境でも本当に意図通り動くかを、毎回自動でチェックする。

  • 世に出る直前に機械が止める。固有名詞・断定的な表現・数値の出典が正しいかを、公開する前に自動で検査する。

この仕組みは、4つのステップが輪のようにつながってできている。壊れる(テストは成功し、通知も鳴らない。人が後から異常に気づく)。記録する(何が起きたか・なぜ起きたか・次にどうするかを1つのファイルにまとめ、見出しの下に「引き金になる語」をいくつか添える)。思い出させる(次にその語を含む依頼をした瞬間、hookというプログラムが、関連する失敗メモだけをエージェントに読み込ませる)。構造で防ぐ(「気をつける」という精神論ではなく、テスト・権限・手順を整えることで、二度目の失敗を物理的にブロックする)。

この4つの輪が回っていれば、同じ失敗は二度目で自動的にストップする。ここで言うhookとは、Claude Codeの設定ファイルに登録する小さなPythonプログラムのことで、作業の決まったタイミングで自動的に割り込んでくれる。必要な環境はClaude Code(hooks対応版)・Python 3・gitの3つだ。すべてを完璧に設定しなくても、失敗の記録とそれを思い出させるhookが1本あるだけで、輪の「記録する」と「思い出させる」は閉じる。

ここで紹介する47件の事例は、私がこの仕組みを作り上げるまでの2か月間に実際に経験した失敗の記録である。そして同時に、あなたの環境に最初から組み込んでおける「他人の失敗」でもある。

6つの実例は、どれも「まさか」ではなく確認漏れ1つだった

この仕組みがどう役立つかは、実際の失敗例を見るのが早いだろう。47件の中から、状況の異なる6件をここで紹介する。残りの41件については、状況ごとに分類して有料部分にまとめている。

操作が「失敗」と返ったのに、裏では動画が再生され続けていた

YouTube動画の内容を確認するため、エージェントにブラウザ操作ツールでサイトを開かせた。すると「操作が拒否または失敗した」というエラーが返ってきた。エージェントは何も起きなかったと判断して次の作業に進んだが、実際にはすでにタブが開いており、画面が非表示のまま裏で動画が再生され続けていたのだ。私が「ずっと流れている」と指摘してから、エージェントが原因を突き止めるまでに3回のやり取りが必要だった。エラーメッセージだけを見て「副作用が無かった」と勘違いしたことが、裏で再生が続く状態を見逃す原因だった。

同じ数字を3か所に書いて、3つとも違う値になっていた

noteの記事の公開本数が、引き継ぎメモと状態表と各記事の作業メモという3か所にばらばらに記録されていた。しかも、3つとも違う数字になっていたのだ。実際の公開本数と合っていたのは状態表の数字だけだった。記録する場所を増やすほど、更新し忘れた場所には古いデータが残ってしまう。引き継ぎメモに至っては、更新日だけが新しくなり、肝心の中身は古い数字のまま放置されていた。

ここで読むのをやめても、来週また同じ場所でつまずく。原因の場所は変わっていないからだ。

次に同じ失敗をもう一度踏む前に、それを防ぐ仕組みを先に貼ったほうが早い。その仕組み一式は、定価1,980円で買える。47件すべての実例(PDF)と、貼るだけで動くzip一式は、この下の有料部分にある。

単体テストは緑でも、本番の設定では成立していなかった

自動売買プログラムで注文数の上限をチェックする仕組みに、買いか売りかを区別する条件が抜けていた。その結果、株価が18%急落したときにすべて売却して逃げるはずの操作が、上限チェックに引っかかって実行されない状態になっていた。単体テストは適当な数値を入れるだけで成功する作りになっていたため、本番の設定値で本当に正しく動くかどうかまでは確認できていなかったのだ。

手元の道具を数えずに「公式の道が無い」と結論した

ある操作をブラウザを使わずに実行したいと依頼したところ、エージェントは企業向けAPI・非公式ライブラリ・別のサービスを経由するという3つの案を提示し、そのうちの1つを勧めてきた。しかし実際には、そのときに使えるブラウザ操作ツールを使えば、私が普段ログインしているブラウザをそのまま動かすだけで簡単に実現できたのだ(しかも私は前日にその方法で成功していた)。エージェントは外部のAPIや別の手段ばかりを先に調べてしまい、自分に与えられているツールを確認する手順を飛ばしていたのである。

これらに共通しているのは、原因が複雑なシステム障害ではなく、確認できたはずの1点を見落としただけという点だ。だから、対策も複雑ではない。エラーが出た後に開いているタブを一覧表示する、正しい情報を書く場所を1つに絞る、金額の上限チェックはリスクの高い方向にだけ適用する、使える道具を確認してから「無い」と判断する。どれも、テストの書き方や権限の絞り方、作業手順の工夫によって、機械的に防げるものばかりだ。

買うと、47件全部が「結論から」読める形と、貼るだけの6ファイルになる

有料部分には、上で紹介したような形式で書かれた残り41件の事例と、この仕組みをご自身の環境に導入するための実データが含まれている。

  • 47件すべてを、状況A〜Fの束ごとに。各件は結論から——やること・使うもの(スターターパックのどれを貼るか)・前提と適用・効果の順で書かれており、具体的な失敗のエピソードは最後に「事例(読みたければ)」として添えている。47件の全文は、目次とページ内リンクつきのPDF(A4・35ページ)にまとめて添付している。

  • 有料部分の冒頭には目次と状況ごとの「お品書き」(見出し・やること・取り込みの札を並べた表)があり、読みたい事例だけをすぐに見つけられる。

  • コピーして使えるスターターパックのファイルが6つ。引き金の語つきの失敗メモ43件がそのまま記録できる形になっており、自分の環境に合わせて書き換えるべき部分は【 】で分かりやすく示している。

  • 必要なファイルが揃ったzipデータ。4本のhookプログラム、設定ファイル(settings.json)に貼り付けるコード、白紙のテンプレート(lessons.md)、そしてスターターパック6ファイル。解凍して貼り付けるだけで、失敗を防ぐ仕組みがすぐに動き出す。

  • 自分だけの失敗録を育てていくための運用ガイド。失敗した日の記録の残し方、引き金の語の付け方、メモが増えすぎたときの整理術などを解説している。

なお、47件というのは2026年9月12日時点の数であり、今後新たな失敗を経験するたびに追記していく。一度購入すれば、その追記分も読むことができる。

hooksを触ったことがなくても、zipを展開して設定を貼れば動く

hooksというプログラムを自分で書いたことがなくても問題ない。hookはClaude Codeの設定ファイル(settings.json)に登録する小さなPythonプログラムだが、必要なコードはすでにすべて書いてある。必要な環境はClaude Code(hooks対応版)、Python 3、gitの3つだけだ。 ダウンロードしたzipファイルを解凍し、設定を貼り付けるだけの簡単な3ステップで導入は終わる。仕組みが正しく動いているかどうかは、スターターパックの1件をわざと踏んで、見出しが差し込まれるかを1回見れば分かる。

この仕組みは、特に次のような人にとって効果的だ。

  • 定期的な処理や監視、通知を無人で動かしている

  • エージェントにテストコードや自動チェックの仕組みを作らせている

  • ブラウザ操作や外部のAPIをエージェントに任せている

  • 記事や投稿、コミットメッセージなど、人目に触れる文章を書かせている

  • 自動売買や発注など、お金が絡む処理を任せている

  • 複数のセッションにまたがって、長くエージェントを運用している

逆に、AIへの上手な指示(プロンプト)の書き方を知りたい人には向いていない。この記事には魔法のようなプロンプトは登場しない。書かれているのは、プロンプトだけでは防げなかった失敗を、どうやって仕組みで防ぐかという方法だ。

なお、提供するhookのプログラム自体はClaude Code専用だが、失敗の記録と「引き金になる語」の付け方は環境に依存しない。他のAIエージェントであっても、システムプロンプトや設定ファイルにこのリストをコピーすれば、同じような効果が得られるはずだ。

もしClaude Code・git・Python 3をまだインストールしていない場合は、こちらの記事を参考にして準備してほしい。

https://note.com/chiwapome_kolin/n/nbb58081b77e9

1,980円で買っているのは、2か月ぶんの遠回りを飛ばすことだ

ここに書かれている47件は、私が2か月間で実際に経験した失敗であり、それを防ぐために作った仕組みは今も私の環境で動き続けている。あなたが同じ47件の失敗を自分の手で経験し、原因を調べ、対策を考えるとしたら、きっと同じだけの時間がかかってしまうだろう。このテンプレートとスターターパックは、そうした2か月間の回り道をショートカットして、結果だけをそのまま持ち帰れるようにしたものだ。

合わなければ、返金を申請できる

もし購入後に内容が合わないと感じた場合は、返金申請を受け付けている。

値段は1,980円

定価1,980円で買える。

最後に

ここにまとめた47件は、私の環境で実際に起こり、そしてすでに仕組みによって防げるようになった失敗たちだ。あなたの環境で再び同じ失敗を繰り返すかどうかは、貼るかどうかだけで決まる。

優れたモデルが出るほど、エージェントに任せられる仕事は増える。任せる範囲が広がるほど、確かめたはずの場所へ戻ってくる失敗も増えていく。優れたモデルが出れば出るほど、この問題はあなたの頭を悩ませる。 今のうちにそれを構造で塞ぎ、ご自身のビジネスや趣味を自由に広げる一助にしていただけたら幸いだ。

この下から、47件の失敗事例と導入用の一式が手に入る。

画像
 
 
会社員が、本業はそのままで副業とお金を増やす手順だけを書きます。AIに副業を回させる一式、何歳で辞められるかが30秒で出る無料の道具、積立の考え方。YouTube・Instagramでは、チワとポメが昭和〜平成と世界の事件を語る動画もAIで回しています。固定記事から読めます。

あなたへのおすすめ