The Engineering of Intent 第29章:バックエンドのVibe Coding

本記事は、私の著書The Engineering of Intent(英語版)を1章ずつ読み解くシリーズの第29回です。前回の記事では、100のヒントのアーカイブを一通り見ました。本書の第IX部:深掘りと拡張ケーススタディは、特定の領域を深く掘り下げるセクションです。その幕開けとなる第29章では、Vibe Codingがおそらく最も即効性のある効果を発揮するバックエンドの仕事を取り上げます。


バックエンドは、エージェント型開発にことのほか向いている

インターフェースはテキストです(HTTP、SQL、protobuf)。正しさの基準は確認可能です(スキーマ、コントラクト、テスト)。反復の対象も目に見えます。しかし、バックエンドのサブドメインにはそれぞれ特有の失敗モードがあります──本章ではそれを一つずつ見ていきます。


6つの領域、6つの規律

  1. API設計のセッション。最初の提案は下書きです。5〜6回は反復しましょう。役に立つプロンプトは、「この設計がうまく扱えない、最もよくあるケースは何か?」と「このAPIが5年かけて悪い方向に進化しうる3つの道筋」です。
  2. データベースのマイグレーション。必ず逆方向のマイグレーションも書く。必ず本番規模のクローンでドライランする。必ず、そのマイグレーションに特に責任を持つ人間のレビュアーを1人置く。そしてこう問います。「このマイグレーションによって、既存のどのデータが壊れたり、誤って扱われたりするか?」
  3. キュー、ジョブ、冪等性。すべてのジョブは冪等であること(あるいは明示的な重複排除を持つこと)、タイムアウトを持つこと、最大リトライ回数を持つこと、再実行できるだけのログを残すこと。これをconventions.mdの恒久的なルールにしましょう。
  4. キャッシュ。TTLはゼロに近い値から始めます。効果を計測でき、無効化の仕組みが整ったら引き上げます。エージェントは、願望まじりのTTLを持つ、もっともらしいキャッシュ層を作りがちです。現実はもっと保守的です。
  5. 認証・認可。forbidden-patterns.mdを維持し、安全でないJWTのパース、情報が漏れる権限チェック、アカウントの存在有無がわかってしまうエラーメッセージを、一つ残らずリストアップします。セキュリティ専門のレビュアーエージェントを別に用意しておきましょう。
  6. レート制限とオブザーバビリティ。すべての公開エンドポイントは、プルリクエストの説明でレート制限のポリシーを宣言します。「制限なしは意図的」という場合でもです。すべてのエンドポイントは、開始・終了のログ + メトリクス + トレースを出力します。この要求を恒久的なポリシーにしましょう。
💡 マイグレーションのケーススタディ: 私はこれまでに、エージェントが生成したマイグレーションが、既存データのある列からNOT NULL制約を黙って外したり、監視を壊すような形でインデックス名を変更したり、同時書き込みの下では安全でない列名の変更を持ち込んだりするのを見てきました。どれもレビューで見つけるのは難しくありませんでした。そして、どれもレビューがなければそのまま出荷されていたはずです。マイグレーションは、レビュアーの役割が最も重要になるバックエンドの領域です。

請求システムの再構築から得たメタな教訓

「私が助言していたある企業には、3万行、7年もののRubyで書かれた請求サービスがありました。新しい経営陣はGoでの書き直しを望みました。直感的な発想は、エージェントで書き直して素早く出荷する、というものです。私の助言は、やめておけ、でした。既存のコードは、実装の姿をした仕様書です。それを捨てれば、何年もかけて苦労して積み上げたバグ修正を捨てることになります。」

代わりにうまくいったのは、次のやり方です。エージェントが古いコードを読み、エンドポイントごとに高レベルの挙動の説明を抽出する。人間がそれを整えて仕様にする。400件の結合テストを、仕様レベルのテストに翻訳する。Goの実装は、その共通のテストスイートに対して構築する。トラフィックは2か月間シャドウミラーリングする。

結果、18か月かかるはずだったものが4か月で出荷されました。顧客から見えるリグレッションはゼロ。抽出の過程で、それまで知られていなかった17の挙動が文書化されました──そのうち3つは実際のバグで、新しいコードでは意図的に引き継ぎませんでした。仕様はそれ自体が長く残る資産となり、移行そのものよりも長生きしました。

⚠ メタな教訓: エージェントは、ゼロからの書き直しよりも、抽出と翻訳においてこそ価値を発揮します。抽出された仕様にもとづく書き直しは、古いコードの「Vibe」にもとづく書き直しとは根本的に別物です。前者は大切なものを守り、後者はその半分を失います。

次回 ── 第30章「フロントエンドのVibe Coding」 フロントエンドは形が違います──視覚的なアウトプット、速い反復、即座のフィードバック。第30章では、デザインシステムへの準拠、アクセシビリティ、状態管理、そして11日で出荷されたダッシュボードの再構築を取り上げます。


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

本章では、6つの領域それぞれを、具体的なプロンプトとケーススタディ(4万通の重複したウェルカムメールが送られたインシデントや、レビューで見つかったタイミング攻撃につながる404の件を含む)とともに解説しています。請求サービスの抽出の方法論も、最初から最後まで完全な形で収録しています。

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

2026-05-15

下田 昌平

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