The Engineering of Intent 第40章:De-Vibingプロトコル──本番に向けた安定化スプリント
本記事は、私の著書The Engineering of Intent(英語版)を1章ずつ読み解くシリーズの最終回です。前回の記事では、目を鍛えました。第40章は、4万行の週末に対する処方箋で本書を締めくくります──Vibeだけで速く作ったビルドが飛ばした仕様、テスト、アーキテクチャのドキュメントを、さかのぼって作り出す、範囲を区切ったエージェント支援型の安定化スプリントです。
処方箋は「書き直す」ことではない
オートコンプリートの罠(autocomplete trap)と4万行の週末は、もっともらしいけれど仕様の存在しないコードベースを生み出します。本能的には書き直したくなります。本書の最終章は、それに反対します──書き直せば、勢いも、学びも、すでに動いている形も手放すことになるからです。
処方箋は、2週間のDe-Vibingプロトコルです。範囲を区切り、エージェントを多用した安定化によって、機能開発を止めることなく、プロジェクトをVibe 90% / 厳密さ10%から50/50程度へと移行させます。シードラウンドのデューデリジェンスが始まる前に、すべてのソロ創業者に知っておいてほしかった手順です。
必要なときを見極める
次の7つの症状のうち、どれか3つが当てはまれば十分です。
- コードを読み直さずには、あるモジュールが何をするのかを説明できない。
- テストカバレッジが30%未満、またはテストがコードに合わせて自動生成されていて、リグレッションを捕まえられない。
- 今週、仕様や型チェックがあれば防げたはずのバグを2つ以上持ち込んだ。
- 新しい協力者が、最初の有用な変更をするまでに3日以上かかる。
- 何が壊れるかわからないので、何もリファクタリングする気になれない。
- 型注釈に
anyという語が、100行に1回以上の頻度で現れる。 - 書き直しを検討している。
スプリントの形:2週間、4つのトラック、60/40の配分
期間は2週間です。それより長くはしない(書き直しと区別がつかなくなる)、それより短くもしない(足りない)。通常の機能開発を止めるのではなく、それと並行して進めます──60%をDe-Vibingに、40%を緊急の顧客対応や機能開発に。機能開発を完全に止めるのは間違いです。ビジネスは止まってくれませんし、1週間もしないうちにチームが反旗を翻します。
4つのトラックを並行して進め、どれもエージェントを多用します。
- トラック1──考古学。 重要なモジュールそれぞれから、1ページの仕様をリバースエンジニアリングします。エージェントが抽出し、人間が修正します。
- トラック2──特性テスト。 現在の振る舞いに対してテストを後付けします。意図しない変更を捕まえるためのセーフティネットです。正しさは後回しです。
- トラック3──型の強化。
anyを意味のある型に置き換えます。エージェントが呼び出し箇所を読み、実際の形を推論し、具体的な型を提案します。 - トラック4──アーキテクチャの文書化。
architecture.md、AGENT.md、そして初日から存在しているべきだった意思決定ログを作ります。
「どのトラックもエージェントを多用します。この作業のうち、手でやるべきものはひとつもありません。人間が加える価値は、レビュー、優先順位付け、そしてときどき必要になる難しいアーキテクチャ上の判断です。タイピングはエージェントがやります。エンジニア1人あたり1日の目標アウトプットは、モジュール1つ分の仕様、またはファイル1つ分の特性テスト、またはモジュール1つ分の型の強化。このペースはエージェントがあれば現実的ですが、なければ笑ってしまうような話です。」
注意すべき失敗モード
スプリントそのものによくある失敗モードは次のとおりです。完璧主義(1モジュールに1日かかるほど詳細な仕様──それは間違いで、目標は2時間で1ページです)。スコープクリープ(後付けのたびに、誰かが直したくなるバグが見つかる──フォローアップとして記録し、スプリント中には直さない)。政治的な疲れ(負債を作った本人ではない人たちが、その後始末に不満を抱く──2週間後には、チーム全員がコードベースのオーナーであって、その歴史のオーナーではないのだと思い出してもらう)。
特性テストには、2つの特有の罠があります。ひとつ目は、外部の正解がないままエージェント生成コードに対して書かれたテストは閉じたループになり、システムが壊れていても通ってしまうことです──少なくとも1つのテストについて、期待値を実際のシステムと手作業で照合してください。ふたつ目は、関数を呼び出して、その結果がその結果と一致することをアサートするだけのテストは、実装を複製しただけの役に立たないものだということです──そのためのプロンプトテンプレートは本書に収録してあり、あなたにはそれが必要です。
スプリントのあと:3つの規律
スプリントが終わりました。そのあとは?
- モジュールに触れるすべてのプルリクエストは、その仕様を更新しなければならない。 例外はありません。古くなった仕様は、ないよりも悪い──嘘をつくからです。
- コードレビューでは、
anyを見つけ次第却下する。 型の強化は、維持するのは安く、やり直すのは高くつきます。 - アーキテクチャ上の変更には、必ず意思決定ログのエントリーを残す。 3文で十分です。背景、決定、根拠。
シリーズを締めくくるにあたって
これが、このブログシリーズの最後の記事です。40の章、40本のダイジェスト、そしてひとつの核となる考え──明確な意図という規律、プレッシャーの下での厳密さの価値、そしてクラフトマンシップの重要性は、どんなモデルやツールや波よりも長く残るということです。実践は変わります。姿勢は変わりません。その姿勢を持ち続けるエンジニアこそ、私がこの2年間、書き届けたいと思ってきたエンジニアです。
ここまで読んでくださった方へ。ありがとうございました。どれかの記事がきっかけで、何かを少しでもきれいに出荷できたなら、それこそが本書の存在理由です。システム全体をひとつの場所で手に入れたいなら──すべてのフレームワーク、すべてのケーススタディ、すべてのチェックリスト、すべての付録──そのすべてがひとつにまとまっているのが本書です。
📖 本書のすべてを読む
全40章、生成駆動開発(GenDD)の方法論の全容、失敗モードとデバッグのカタログの完全版、12のコンテキストパックのレシピ、100のヒント、De-Vibingプロトコルの完全な解説、そしてコンテキストスケーリング、マルチエージェントのガバナンス、印象主義的スキャニングを扱う上級トピックの章──そのすべてが、ひとつの場所にまとまっています。
下田 昌平
開発に関するインプットをアウトプットしています。カテゴリー
タグ
検索ログ
開発・技術相談
システム開発や技術検証、要件定義の作成、アーキテクチャ設計、 テスト設計、運用設計まで、一気通貫で支援しています。 企画段階の「まず相談したい」レベルから、実装・運用まで 幅広く対応できますので、お気軽にお問い合わせください。
お問い合わせ