The Engineering of Intent 第27章:アンチパターン──やってはいけないこと
本記事は、私の著書The Engineering of Intent(英語版)を1章ずつ読み解くシリーズの第27回です。前回の記事では、私が実際に使っているチェックリストを紹介しました。第27章はその鏡像です。名前のついた25のアンチパターン──スピードに見えて、四半期を丸ごと犠牲にする魅力的な近道の数々──を取り上げます。
まず一度、最後まで通して読む。そして何かがおかしいと感じたら戻ってくる。
本章の各項目では、アンチパターンに名前をつけ、なぜそれが魅力的なのかを説明し、それを防ぐための規律を示しています。ここでは25のうち10を紹介します。処方箋つきの完全なカタログは本書にあります。
25のうちの10
- 「エージェントに決めさせる」(Let the Agent Decide)効率的に感じるので魅力的です。しかし致命的です。意図が宿るのは決定であり、あなた抜きで決めるエージェントが表現するのは、あなたの前提ではなくエージェント自身の前提だからです。エージェントは提案し、あなたが決める。常にです。
- 「コンパイルが通ったら出荷」(It Compiled, Ship It)コンパイルが通ることは必要条件であって、十分条件ではありません。型、テスト、レビューを加えましょう。
- 「ワンプロンプトですべて解決」(One-Prompt-Solves-Everything)一度に多くを求めすぎると、エージェントのアウトプットは悪くなります。インクリメントに分割しましょう。
- 「書くのはエージェント、読むのは人間」(Agent as Writer, Human as Reader)良いソフトウェアには、読む判断力だけでなく、書く判断力が必要です。自分自身が書く練習を減らしてはいけません。
- 「深夜の出荷」(Late-Night Ship)微妙な判断が宿るのは最後の5%であり、夜11時のあなたの判断力は、朝9時よりも劣ります。
- 「コードではなくモデルを信じる」(Trust the Model, Not the Code)「モデルがそう言った」はマージの根拠になりません。必ず読み、必ず実行しましょう。
- 「ゼロから書き直す」(Rewrite From Scratch)既存のコードには、あなたには見えない何年分ものバグ修正が刻み込まれています。リファクタリングは段階的に行いましょう。
- 「孤高の天才」(Solo Genius)一人で作業していると、悪い決定が誰にも監査されずに通ってしまいます。難しい決定は、少なくとももう一人の人間のレビューにかけましょう。
- 「賢すぎて失敗しない」(Too Clever to Fail)エージェントが生み出すばらつきに耐えられない洗練は、堅牢とは言えません。シンプルなほうを選びましょう。
- 「永遠のパイロット」(Forever Pilot)終わらないパイロットは、企業が変革を実行せずに変革について語り続けるための手段です。卒業の期限を設けましょう。
最も危険なもの
「実践を伴わない理論は、腐ってイデオロギーになります。Vibe Codingについて読むのは、実際にやるより簡単です。本書のような本は地図であり、現地はあなたのエディタです。手を動かしましょう。出荷しましょう。失敗しましょう。調整しましょう。」
本章のアンチパターンはどれも、ある意味では局所最適です──その瞬間には、スピードのように感じられます。規律とは、その局所最適が大域最適ではないことに気づくことです。Vibe Codingを長期的に機能させている人たちは、毎日、もっともらしい近道を5つも6つも退けてきた人たちです。
次回 ── 第28章「ヒント集──日々の実践から生まれた100のメモ」 第23章〜第27章が名前のついたパターンとアンチパターンを示したのだとすれば、第28章はロングテールのアーカイブです──私が書き留めてきた、より小さな100のメモ、ヒューリスティック、ちょっとした教訓です。好きなものを選んでください。
📖 さらに詳しく知りたい方へ
本章では、25のアンチパターンすべてを、「なぜ魅力的なのか」の説明と「処方箋」となる規律とともに紹介しています。一度は最初から最後まで通して読み、プロセスがおかしいと感じたらいつでも読み返してください。
下田 昌平
開発に関するインプットをアウトプットしています。カテゴリー
タグ
検索ログ
開発・技術相談
システム開発や技術検証、要件定義の作成、アーキテクチャ設計、 テスト設計、運用設計まで、一気通貫で支援しています。 企画段階の「まず相談したい」レベルから、実装・運用まで 幅広く対応できますので、お気軽にお問い合わせください。
お問い合わせ