- 課題: CLIや自律型AIエージェントに軽い修正を頼んだだけなのに、関係ない過去ログや無関係なファイルまで勝手に調べ始め、時間やトークンを浪費して迷走する現象。
- 原因: ツールの性能不足ではなく、AIの自律的な探索特性に対し「どこまで作業してよいかの境界線」が具体的に定義されていないこと。
- 解決策: 設定ファイルに「指示された最小限から始める」「範囲外へ出る前に許可を求める」という行動前の事前確認ルールを置き、必要に応じてツールの実行承認機能を併用する。
- 結論: 100点の完全自動化を無理に目指さず、現場で発生した探索の無駄を「1つのシンプルなルール」から整えていくのが現実的なアプローチ。
1. 「ちょっと直して」と頼んだだけなのに
CLIの自律型AIエージェントやコーディング支援AIを使っていて、思わず画面の前で頭を抱えたことはないでしょうか。
「この関数の引数をひとつ増やして」
「このCSSの余白を少しだけ広げて」
ほんの数行、手元で見えているコードを直してほしいだけなのに、AIが動き出した瞬間、ターミナルにこんなログが流れ始めます。
- ワークスペース全体のファイルを片っ端から全文検索し始める
- 数ヶ月前のコミットログや関係のない仕様書を深掘りし始める
- 頼んでもいない依存関係の更新やリファクタリングの検討に入ってしまう
「いや、そこまで調べなくていいから……！」
思わず中断コマンド（Ctrl+Cなど）を連打して止めるものの、すでに多くのトークンが消費され、何分もの時間が溶け、何より「作業のリズム」と「こちらの集中力」が途切れてしまう。
自律型のAIエージェントを日々の開発で動かしている方なら、一度は似たような徒労感を味わったことがあるはずです。
2. なぜAIは頼んでいないことまで調べるのか
こうした問題に直面したとき、多くの開発者が最初に考えるのが次の2つです。
- 「もっと賢い別のツールに乗り換えようか？」
- Claude Code、Cursor、Windsurf、Antigravity、Codexなど、次々に登場するツールの乗り換えを検討する。
- 「もっと細かく指示を書いた神プロンプトを用意しよう」
- 「余計なことはしないでください」「関係ないファイルは見ないでください」と、禁止事項をびっしり書き連ねる。
私自身、まったく同じ道を通り、両方を試しました。ですが、このアプローチだけでは安定した解決にはなりませんでした。
自律型エージェントの仕組みと探索の性質
自律型AIエージェントは、与えられた目標を達成するために、必要だと判断した情報を集め、ツールを実行し、その結果を見て次の行動を決めます。
技術的な観点で見ると、多くの自律型AIは ReAct（Reasoning + Acting）など、推論とツール実行を繰り返す構成 を基盤に動いています。この仕組みは複雑な調査や大規模なリファクタリングでは非常に強力ですが、変更範囲が小さく明確な作業では、かえって余計な探索を招くことがあります。
例えば、CSSの余白を数ピクセル変更するだけなのに、AIが関連コンポーネントや過去の実装まで調べ始めるケースです。AIにとっては「影響範囲を漏れなく確認しよう」という慎重な判断のつもりでも、作業者にとっては時間とトークンの浪費になりかねません。
どれだけツールを変えても、モデルが賢くなればなるほど、この「気の利いた深掘り」の傾向は強くなります。そして「余計なことはするな」という抽象的な禁止プロンプトは、AIの自律的な推論の波にかき消されやすいのです。
ここで重要なのは、AIに「余計なことをするな」と繰り返すだけではなく、どの範囲まで自律的に作業してよいかを、具体的に定義することでした。
3. まずは「行動前の事前申告」をルールにする
試行錯誤を繰り返す中で、もっとも手軽で、不要な探索を減らすのに効果的だったのが、「作業範囲と行動前の事前申告ルール」を設けることでした。
具体的には、お使いのツールの設定ファイル（Claude Codeなら CLAUDE.md、Cursorなら .cursor/rules/*.mdc や AGENTS.md、Antigravityなら AGENTS.md や GEMINI.md など）に、以下のようなルールを追記します。
### 作業範囲と事前確認
- 指示された作業に必要な最小限のファイルから調査を始める。
- 編集前に、対象ファイルと変更内容を簡潔に提示する。
- 指定範囲外の調査・編集・依存関係の変更が必要になった場合は、理由を説明し、人間の許可を求める。
- 明示的に許可されていない範囲へ、独断で作業を拡張しない。
- 実行承認機能が利用できる環境では、必要に応じて併用する。このルールを取り入れることで、運用の流れを以下のように整理できます。
| これまでの運用 | 事前申告ルールの導入後 |
|---|---|
| 指示を出す ➔ AIが勝手に調査・実行・試行錯誤を一気にやり切る（ブラックボックス） | 指示を出す ➔ AIが「まず対象のファイルから確認します」とスコープを意識して動く |
| 途中で関係ない場所を掘り始めても、止めるタイミングが見えない | 範囲外に出る前に「〇〇も確認してよいか」と提示が入るため、人間が早い段階で軌道修正できる |
| 多くの時間とトークンが消費された後に、見当違いのコードが出てくる | 最初の段階で作業範囲が絞られるため、不要な探索や手戻りを減らしやすくなる |
注意点：プロンプトによる指示と「ツールの権限制御」は別物
ここで理解しておくべき重要な事実があります。
設定ファイルにルールを書くことは、あくまでAIに対する「プロンプトベースの行動指針」であり、物理的にツールの実行を強制停止させる仕組みではありません。モデルが状況によって指示を軽視したり、探索を広げてしまったりする可能性は依然として残ります。
そのため、もし本当に確実な制御を行いたい場合は、
– CLIツールの実行承認モード（コマンド実行やファイル書き込み時にEnterキーの承認を必須にする）
– 許可するツールやコマンドのホワイトリスト設定（パーミッション管理）
といった、ツール側が提供しているハードウェア的な権限制御機能と組み合わせて運用することが大切です。
「毎回止めたら、作業のテンポが落ちないか？」について
すべての探索や読み取りを毎回ガチガチの許可制にすると、かえって人間側の確認コストが増えて作業効率が落ちてしまいます。
だからこそ、上記の推奨ルールでは「調査自体は最小限のファイルから自律的に始めてよい」「編集前や、指定範囲の外に出る場合のみ許可を求める」というバランスにしています。
例えば、不要な探索に3分以上かかってしまうケースであれば、作業の着手前や範囲外に出る瞬間に数秒の確認を挟むことで、方向違いの探索に費やす時間を大きく削減しやすくなります。
「全自動」を完全に諦めるのではなく、「作業前に『この範囲で手を動かしますね』と一声かけてくれる助手」として扱うような距離感が、日々の開発ではもっともストレスが少なくなります。
4. 100点の仕組みを目指さず、現場の違和感から「1つのルール」を足す
世の中の技術記事を見ていると、「何百行にも及ぶ完璧なルール設計」や「緻密なエージェントワークフロー」が紹介されていて、気後れしてしまうことがあります。
ですが、最初から完璧な仕組みを作る必要はありません。
実際に役立つルールは、いつだって「自分が作業中にイラッとした瞬間」「無駄骨を折らされた失敗」から生まれる泥臭い1行です。
- 「関係ないテストファイルまで勝手に書き直して壊された」 ➔ 『テストの変更は必ず事前に確認を取ること』
- 「巨大なログファイルを直接開いて固まった」 ➔ 『ログは全体を開かず、必要なキーワードをgrepして確認すること』
- 「頼んでいないのに長文のポエムを出してきた」 ➔ 『指示されたことに対して簡潔に事実のみを答えること』
一度にすべてを自動化・制御しようとせず、AIが「頼んでもいないこと」を始めて頭を抱えたその瞬間に、設定ファイルへ1行だけ「境界線」を書き足していく。
その泥臭い運用の積み重ねこそが、どの最新ツールに乗り換えるよりも、自分にとって快適な開発環境を作ってくれます。
まとめ：道具の手綱を握るのは、人間側のシンプルな境界線
AIエージェントの進化スピードは凄まじく、毎月のように新しいツールや機能が登場します。
ですが、どんなに高性能なツールを使っても、道具との付き合い方の本質は変わりません。
AIに振り回されないために必要なのは、最新のプロンプトテクニックを探し回ることではなく、「ここから先は勝手に踏み込むな」という境界線を、人間側が具体的に定義してあげることでした。
もし今、手元のAIエージェントが「頼んでもいない調査」を始めて困っているなら、まずは設定ファイルに、
「指示された作業に必要な最小限のファイルから調査を始めること」
という1行を書き足してみてください。
明日からの開発の景色が、少しだけ静かで、ずっと快適なものになるはずです。