The Engineering of Intent 第24章:失敗モード辞典

本記事は、私の著書The Engineering of Intent(英語版)を1章ずつ読み解くシリーズの第24回です。前回の記事では、12のコンテキストパックのレシピ──肯定的なパターン・ランゲージ──を見ました。第24章はその否定版です。Vibe Codingの実践で私が繰り返し目にしている15の失敗モードを紹介します。


名前のついた15の失敗と、その処方箋

本章は、私が最もよく目にする失敗モードを分類したものです。本書の各項目では、失敗に名前をつけ、症状を説明し、根本原因を診断し、処方箋を示しています。プロセスのどこかがおかしいと感じたときのリファレンスとして使ってください──「謎の」問題のほとんどは、このどれかに当てはまります。


15の失敗モード(要約版)

  1. 幻の自信(Phantom Confidence) ── でっち上げた答えを、自信に満ちた口調で返す。対処:agents.mdに「確信が持てないなら、そう言うこと」と書き加え、引用されたシンボルが実在するかを確認する。
  2. 静かなスコープクリープ(Silent Scope Creep) ── 「小さな修正」のはずの差分が12ファイルに及ぶ。対処:拡大が「改善」であっても、スコープの線を守る。
  3. コンテキスト健忘(Context Amnesia) ── 30分前の決定を忘れる。対処:会話が流れていく前に、決定をメモリーバンクに書き込む。
  4. レガシーに対する自信満々の誤り(Confident Wrongness on Legacy) ── 古いフレームワークに最新のイディオムを当てはめる。対処:agents.mdでバージョンを明示的に固定する。
  5. ループへの執着(Loop Obsession) ── バグを直しては再発させる局所的なサイクルから抜け出せない。対処:コンテキストを広げ、どの構造的な性質が破られているのかを問う。
  6. でっち上げのインポート(Fabricated Imports) ── 存在しないライブラリを参照する。対処:解決できないインポートで失敗するlintルールを入れ、必ずインストールして実行する。
  7. 早すぎる抽象化(Premature Abstraction) ── 具体的な関数1つのために、基底クラス + インターフェース + 3つの実装を作る。対処:conventions.mdに「早すぎる抽象化を避ける」ルールを置く。
  8. テスト・シアター(Test-Theater) ── コードが当然やることを確認するだけのテスト。対処:テストファースト・プロンプト(Test-First Prompt)を使い、「失敗しうるもの」のケースを必須にする。
  9. コメント過多(Over-Commenting) ── いたるところに// increment x by 1。対処:「コメントは何をしているかではなく、なぜかを説明する」。
  10. コメント不足(Under-Commenting) ── 微妙なコードに説明が一切ない。対処:自明でない判断にはコメントを必須にする。
  11. ハルシネーションによるテスト結果(Hallucinated Test Results) ── 実際には実行していないのに「テストを実行しました、パスしています」と言う。対処:実際の出力を必須にし、サンドボックスで実行する。
  12. イエスマン・エージェント(The Yes-Person Agent) ── 決して反論しない。対処:反対意見を明示的に求める。「この計画を批判して。うまくいかない可能性を3つ挙げて」。
  13. 非推奨の盲点(The Deprecation Blind Spot) ── 自分の使っているバージョンではすでに削除されたAPIを使う。対処:既知の非推奨APIとその代替のリストを維持する。
  14. 非決定性の罠(The Non-Determinism Trap) ── 同じプロンプトなのに出力が違う。対処:本番用のプロンプトは低いtemperatureで実行し、ログを取ってハッシュ化する。
  15. 断片化したメモリー(The Fragmented Memory) ── セッションがユーザーごとに違うことを覚えている。対処:共有され、バージョン管理され、コミットされたメモリーバンクを持つ。
💡 ポイント: 私が監査するAIネイティブな問題のほとんどは、新しい種類のバグではありません。この15のどれかが、別の名前で現れているだけです。処方箋は3つの手に集約されます。ずれてはならないものを固定する(バージョン、依存関係、決定)。信用してはならないものを検証する(インポート、テストの出力、主張)。モデルが自分からは言わないものを引き出す(不確かさ、批判、構造的な捉え方)。

「イエスマン・エージェントは、本書で最も報告されにくい失敗モードです。チームは自分たちがそれを抱えていることに気づきません。返ってくる答えが気に入っているからです。しかし、決して反論しないエージェントとは、失敗モードが『黙って同意すること』であるエージェントです──そしてそれは、すべての中で最も高くつく失敗モードです。自分がその中にいることに気づけないのですから。」

⚠ 最も多くの一日を台無しにするもの: ハルシネーションによるテスト結果。オーケストレーションのモードによっては、エージェントが実際に実行せずに「報告」できてしまい、もっともらしい出力を生成します。ログなしの「テストを実行しました、パスしています」は決して信用しないでください。テストの実行が、検証可能な出力とともにサンドボックス内で行われるようにオーケストレーションを設定しましょう。実行が見えないなら、それは起きていないのです。

次回 ── 第25章「デバッグ・プレイブック」 第24章がプロセスで起きる問題を分類したものだとすれば、第25章はコードで起きる問題を分類します──よくある10種類のバグと、それぞれに合った調査パターンです。


📖 さらに詳しく知りたい方へ

本章では、各失敗モードを完全な形で紹介しています。症状のチェックリスト、根本原因の解説、そしてagents.mdやconventions.mdにそのまま貼り付けられる処方箋の文言です。

The Engineering of Intent をAmazonで購入する →(英語版)

2026-05-10

下田 昌平

開発に関するインプットをアウトプットしています。