AIエージェントは大幅に刷新され、ますます混沌としていきます。これはツールが悪いからではなく、タスクが大きすぎて受け入れが不明確で、改造の範囲が制御不能だからです。 解決策はモデルを変えることではなく、タスクを「理解、修正、検証」の3つのステップに分けることであり、それぞれのステップには検証可能な結果が必要です。
ステップ1:ただ理解させてあげる
まだエージェントにファイル変更を任せないでください。 関連するコードを検索し、通話チェーンを一覧にし、可能な原因を示し、どのファイルを変更したいかを説明させてください。 次のステップに進む前に、正しい場所に置かれていることを確認する必要があります。
関連文書すら言えないなら、実装させるだけで誤りが増幅されるだけです。
ステップ2:最小範囲のみ変更
一度に一つの問題だけを解決しましょう。 例えば、「ログイン失敗プロンプトの修正」では、フォームスタイル、インターフェースカプセル化、権限ロジック、ルートジャンプを同時に変更しないでください。 最大2〜4つのファイルを変更し、それぞれの変更目的を記載してください。
もしプロジェクトの半分をリファクタリングする提案をしているなら、なぜ小さな変更では不十分かを説明させましょう。 ほとんどのビジネス問題はアーキテクチャの書き直しを必要としません。
ステップ3:コマンドで受け入れる
変更後は検証を実行しなければなりません:ユニットテスト、タイプチェック、リント、ビルド、そしてタスクに関連する少なくとも1つのコマンドを選択します。 テストがない場合は、手動の受け入れ手順を書き出すように頼みましょう。
受け入れられなかったら需要を増やし続けるのではなく、失敗の理由に戻ってください。 AIエージェントは失敗後もパッチを塗り続け、プロジェクトを台無しにする可能性が高いです。
固定チップを渡せ
「まだ編集しないで」といった感じで言ってみてください。 最初のステップはコードだけを読み取り、計画を示すことです。 次のステップは、確認後に最小限の変更のみを行うことです。 ステップ3:検証を実行し、失敗結果に基づいて修正します。 ファイルと各ステップの理由をリストアップしましょう。 ”
この方法はCodex、Cursor、Claude Code、Windsurfで動作します。 AIエージェントは大きなタスクもこなせますが、大きなタスクは段階的に受け入れる必要があります。 そうでなければ、開発を助けるどころか、不確実性をより多くのファイルに広げてしまいます。
