AIエージェントの出力が、ある時期から少しずつ雑になった。
指摘が的外れになる。前に決めたはずのルールを守らない。同じ依頼でも日によって返ってくるものが違う。最初はモデルのせいだと思っていた。
違った。原因はたぶん僕の側にある。指示書を足し続けていた。
数えてみたら、機械に読ませている定義ファイルは全部で126,291字あった。文庫本1冊半だ。毎回これを踏まえて動け、と言っていたことになる。
「情報が多すぎたり矛盾すると、AIは混乱する」
きっかけは、米マイクロソフトのエンジニアである牛尾剛さんが動画で話していたことだった。
AIの精度を決めるのはプロンプトそのものではなく、コンテキスト管理のほうだという話だ。プロンプトを工夫する話ではない。LLMにはユーザーの指示だけでなく、システムプロンプト、過去の会話、ツールの定義、エージェントの定義が同時に渡る。そして情報が多すぎたり、矛盾したりすると混乱する。だから必要な情報だけを渡す設計が要る、と。
(出典: 牛尾剛さん出演回『AIを「部下」にして1週間の仕事が1日に』ビジネス+ITチャンネル・2026年7月29日公開)
聞いた瞬間に、自分の環境が浮かんだ。
僕は1年かけて、投資の監視・ブログ・物販・SNS・健康をAIエージェントに任せてきた。運用していると、細かい失敗が出る。そのたびに定義ファイルに一行足してきた。「今後はこうする」「これは禁止」と。
足した記憶はある。消した記憶がほとんどない。
測ってみたら、同じルールが8ファイルに散っていた
ちゃんと数えた。結果はこうだ。
- 毎回必ず読ませる司令塔ファイル: 13,053字
- エージェント定義 22本: 約77,900字
- 作業手順(Skill)10本: 32,419字
- 合計 126,291字

量そのものより、中身のほうがまずかった。同じルールが、あちこちに書かれていた。
- 「免責を入れる」…… 12ファイルに登場
- 「公開は本人の指示があったときだけ」…… 8ファイル
- 「計測用リンクを機械が開かない」…… 8ファイル
- 「一人称は僕」…… 8ファイル
- 「ハッシュタグは3〜5個」…… 8ファイル

なぜこうなるかは、書いた本人だからよく分かる。大事なルールほど「ここにも書いておかないと守られないかも」と不安になる。だから各所に複製する。悪気はない。むしろ丁寧にやっているつもりだった。
でも機械から見れば、同じことが8回書いてあるだけだ。しかも8箇所のうち1箇所を直したら、残り7箇所は古いまま残る。
もっと悪いのは、重複より矛盾だった
棚卸しで一番こたえたのはここだ。
矛盾① 「AIの実践記録はnoteに書く、ブログには書かない」と決めてあるのに、直前に書いたAI実践の記事をブログに公開していた。しかも自分で指示して。
矛盾② ある監視機能を「参考・休止中」と書いてあるのに、平日は毎日2回、実際に動き続けている。
矛盾③ 外部に登録されたままの古いバッチ処理について、「方針と矛盾するため停止を推奨」と自分で書いたまま1ヶ月以上放置していた。
人間なら「まあ実態はこうだから」と読み替える。機械は読み替えない。矛盾した指示を両方とも真面目に受け取る。
そのうえで何か出してくる。だから出力が日によってブレる。僕が「AIが馬鹿になった」と思っていたものの正体は、たぶんこれだった。
足すのはタダで、消すのは怖い
なぜ膨らむのか。答えは単純で、足すコストはゼロに見えるのに、消すのは怖いからだ。
一行足すのに5秒もかからない。効果があるかも分からないが、書いておけば安心できる。一方で消すときは「これを消したせいで、あの失敗がまた起きたら」と考える。だから残す。
気づいたのは、この非対称が人間の側の設計ミスだということだった。機械は足された分だけ律儀に抱え込む。文句も言わない。パンクしたことも教えてくれない。ただ、少しずつ精度が落ちる。
正直に書くと、ここは今も途中だ。126,291字を半分にする、みたいな派手なことはまだできていない。
棚卸しのときに自分に聞いた4つ
減らす作業で使っている問いを置いておく。地味だけど、これで判断できた。
- ①このルールの正本はどこか。 1箇所だけ本物を決めて、残りは「そっちを見ろ」に置き換える。同じ文章を2回書かない
- ②今の実態と合っているか。 「休止中」と書いたものが動いているなら、書き換えるか止めるかのどちらかをやる。放置が一番悪い
- ③このルールは、いつの失敗から生まれたか。 思い出せないものは、たいてい要らない
- ④消して困ったら戻せるか。 戻せるなら、先に消して様子を見ていい
数え方も書いておく。難しいことはしていない。
定義ファイルを置いているフォルダで grep -rl "そのルールの言い回し" . を流すだけだ。ヒットしたファイル数が、そのルールの複製数になる。これを守らせたいルール5〜10個ぶんやると、自分がどれだけ同じことを書いていたかが一発で出る。文字数は wc -m でいい。僕はこれを30分ほどでやった。
③がいちばん効いた。出どころを思い出せないルールが、けっこうあった。当時は切実だったはずなのに、今の自分には意味が分からない。そういうものが静かに場所を取っていた。
増やす前に、読む側の容量を考える
これはAIエージェントに限った話でもないと思っている。
チームの運用ルール、業務マニュアル、引き継ぎ資料。どれも同じ形で膨らむ。失敗のたびに一行足され、誰も消さず、最後は誰も全部を読んでいない。読んでいないから守られず、守られないからまた一行足される。
ひとつ断っておくと、僕の環境の話であって、量が多いこと自体が悪いという話ではない。必要な情報を与えればAIは自律的に動くというのも、同じ人が言っていることだ。問題は量ではなく、重複と矛盾のほうだった。
それでも、もし今あなたがAIに「なんか最近、指示どおりに動かないな」と感じているなら。プロンプトの書き方を工夫する前に、一度今そいつに何を読ませているのか、全部数えてみるほうが早いかもしれない。僕は数えて、やっと原因の見当がついた。
AIをどこまで任せるかという線引きについてはどこまでAIに任せるか、決められなかったに書きました。僕がここに行き着くまでの全体の経緯は種銭づくりから投資までの全記録【宣言編】にまとめています。
本記事は筆者個人の運用記録であり、特定のツールやサービスの利用を推奨するものではありません。また、AIの出力の正確性を保証するものではありません。
この指示書を作っていく過程を、1冊に書きました(自著です)。
AIの技術解説を期待している人には向きません。動かして壊して直した記録です。
執筆時点でエージェント15体に投資の監視・ブログ・物販を任せるまでに、何を書き、何を消したか。効かなかったことも同じ精度で書いています。
AIエージェントに投資と副業を任せた全記録(Kindle・750円 / Kindle Unlimited対象)(自著の販売ページです)
実際の定義ファイルの中身は、noteに置いています
どんなルールを書いて、どこで矛盾したのか。設定レベルで見たい人はこちらです。
→ 兼業エンジニアが、投資と副業ブログをAIエージェント15体に任せた全記録(note・執筆時点の構成)
日々の実験と失敗は、Xでもぼそっと呟いてます。よかったらフォローどうぞ → @E_mc2_japan
書いた人:会社員をしながら、物販×アフィリで種銭を作り、AIエージェントのチームに投資の監視・ブログ・物販を任せています。全自動にしようとして失敗した側の人間です。数字は盛らず、効かなかったことも正直に書きます。
👉 詳しくは 運営者情報(プロフィール)/種銭 宣言編(軸記事)


コメント