The Engineering of Intent 第22章:Vibe Coderの一日──実況セッション
本記事は、私の著書The Engineering of Intent(英語版)を1章ずつ読み解くシリーズの第22回です。前回の記事では、チームのプロトコルを取り上げました。第22章は本書の第VII部:Vibe Coderの日々の実践を締めくくる章で、中程度の複雑さの実際の一日を1時間ごとに実況します──実践が本当に試されるのは、ごく普通の一日だからです。
英雄的な一日ではなく、平均的な一日
第22章はまるごと、実際の一日の業務を実況形式で再現したものです。中程度の複雑さの一日を選んだのは意図的です。英雄的な一日は教材としては不向きです。実践が生きるか死ぬかは、ありふれた火曜日にかかっています。その一日を圧縮すると、次のような形になります。
その一日
- 9:02 ── 朝のリロード。目標を2つ書く(1つ多すぎるが、片方は30分で済むのでそのままにした)。
architecture.mdの古くなったセクションに気づく。メモリーバンクにある昨日の自分からの引き継ぎメモを読む。不安定な結合テストがあり、信用する前にきちんと調査が必要だ、とある。 - 9:12 ── 最初の小さな勝利。ちょっとしたlintの修正を、差分限定プロンプト(Targeted Diff Prompt)でエージェントに渡す。3分でマージ。次へ。
- 9:18 ── 不安定なテストの調査。バグ仮説プロンプト(Bug-Hypothesis Prompt)。3つの仮説を立て、診断を実行し、1つの仮説が裏付けられる。「不安定」に見えたのは、実はリファクタリングによって表面化した本物のバグだった。28分で根本原因に到達。
- 9:50 ── 出荷するかどうかを決める。プロダクトチームと15分のミーティング。新しい挙動は決定的で、古い挙動はたまたまそうなっていただけ。承認。テストを更新してマージ。
- 10:25 ── ランキングの調整を出荷。5層のゲートが10分でグリーン。カナリアを20分監視。10%ロールアウトを15分監視。全面ロールアウト。チームに1行のサマリーを送って完了。
- 11:30 ── レビュアーエージェントの評価。マージ済みのプルリクエストを20件取り出してレビュアーエージェントにかけ、その指摘を人間の指摘と比較。人間の指摘17件のうち14件を捕捉。新規の指摘11件のうち8件が本物。十分に元が取れている。
- 12:30 ── 昼食。ノートPCから離れる。仕事のことは考えない。これ自体が一つの実践である。
- 13:30 ── アーキテクチャドキュメントの更新。検索まわりの古くなったセクションを、第18章「プロンプトパターン・カタログ」のパターンを使ってエージェントに渡す。20分。エージェントがいなければ、きっと後回しにしていた。
- 14:00 ── ペアVibe Coding。同僚が決済連携のバグについてSlackで相談してきた。私がナビゲーター、彼女がドライバー。エージェントの2つ目の仮説は、決済プロバイダーに関するある細部のせいで、もっともらしいけれど間違っていた。私が割って入り、コンテキストを訂正し、修正を依頼。40分で解決。
- 14:45 ── レビューの連続。プルリクエスト5件。1件はブロック、1件は提案付きで承認、3件は問題なし。うち2件ではレビュアーエージェントも実行した。そのうち1件で、私が読むのが速すぎて見逃した規約違反をエージェントが捕まえた。金曜のためにメモ。
- 15:45 ── 小さいが難しい問題。1週間放置されていた、顧客向けのパフォーマンスのリグレッション。最初からスリーストライク・ルール(Three-Strike Rule)を適用。最初の2つのプロンプトは汎用的すぎて役に立たない。3つ目のプロンプト──自分で具体的に考え抜いたあとのもの──で、行ごとにキャッシュキーを再計算している箇所が見つかる。3行の修正。
- 16:30 ── 教訓の記録。キャッシュキーのパターンを
conventions.mdに追加。スリーストライク・ルールのおかげで30分節約できたことをメモ。 - 17:00 ── 一日の締めくくり。メモリーバンクを更新。明日の最初のタスクを決める。「スタンドアップでレビュアーエージェントの評価結果を発表する」。ノートPCを閉じ、歩いて帰る。
振り返り
出荷1件、小さな完了3件、記録した学び2つ、レビューしたプルリクエスト4件、調査した難しいバグ1件、更新したアーキテクチャドキュメント1つ、ペアセッション1回。
「エージェントは、あなたがすでに済ませた思考をてこのように増幅するものであって、まだしていない思考の代わりになるものではありません。パフォーマンスのバグで最初の2つのプロンプトが失敗したのは、エージェントに十分な具体性を与えていなかったからです。3つ目が成功したのは、具体的な問いを立てられるところまで、私自身が十分に考えていたからです。これがパターンです。」
次回 ── 第23章「コンテキストパックのレシピ」 本書の第VIII部:パターンカタログと実例では、物語からリファレンスへと切り替わります。第23章は、コンテキストパックのテンプレート集です──新しいサービス、既存サービスへの新機能、リファクタリング、バグ調査など、よくある状況のための、具体的でそのままコピーできるパックを紹介します。
📖 さらに詳しく知りたい方へ
本章では、この一日全体をプロンプトのトランスクリプト付きで追っています。レビュアーエージェントの評価データの全容、実際の条件下でのペアVibe Codingのプロトコル、実際のパフォーマンスのバグに適用したスリーストライク・ルール、そして一日分のデータを翌週の実践に変える、一日の終わりの振り返りの問いも収録しています。
下田 昌平
開発に関するインプットをアウトプットしています。カテゴリー
タグ
検索ログ
開発・技術相談
システム開発や技術検証、要件定義の作成、アーキテクチャ設計、 テスト設計、運用設計まで、一気通貫で支援しています。 企画段階の「まず相談したい」レベルから、実装・運用まで 幅広く対応できますので、お気軽にお問い合わせください。
お問い合わせ