コーディングエージェントが実際どう動くか

みんなコーディングエージェントは魔法だと思ってる。プロンプト打って、コード出てくる。オートコンプリートの賢い版。

5分見てたら分かる：サブシステムのカオスが次に何するかで常に揉めてる。

知性の幻想

お前が聞く：「NextAuthで認証追加して。」

想像すること：AIが理解して、コード書く。

実際に起きること：

1. ルーターがプロンプト見て、どのモデルが処理するか決める
2. コンテキスト取得がコードベーススキャン、「関連」ファイル選ぶ
3. LLMが部分的コンテキストで計画生成
4. ツール実行がコマンド実行、ファイル編集
5. オーケストレーターが動いたかチェック
6. 動いてないからステップ3に戻る

これは知性じゃない。より良い記憶力を持った試行錯誤だ。

コンテキスト問題

ほとんどのエージェントタスクを殺すのがこれ：

エージェントがどの4%を見るか選ぶ。間違える？お前のパターンに合わないコード書く。持ってないライブラリ使う。規約無視。

エージェントがハマる理由

先週エージェントが機能追加しようとするの見てた。ループ回数：7。

各試行がトークンかかる。時間かかる。エラーが複合する、エージェントは自分の失敗パターンが見えないから。

エージェントが実際に役立つとき

退屈で、よく定義されたタスク：

• 「このモデルのCRUDエンドポイント追加」— 動く
• 「この関数のテスト書いて」— 動く
• 「XをYにコードベース全体でリネーム」— 動く
• 「これをきれいにリファクタして」— 災害

パターン：解決策が明らかでスコープが狭いときエージェントは優秀。判断が必要なとき失敗する。

本当のワークフロー

動くもの：

エージェントは速いインターン、シニアエンジニアじゃない。そう扱え。

---

エージェントは賢くない。正しくなるまで間違うのが速いだけだ。

— blanho