広く構築し、狭くリリースする
Build Wide, Ship Narrow (adapt.com)
要約
この記事では、AIの進化により、ソフトウェア開発における「広く構築し、狭くリリースする」という新しいワークフローを提案しています。従来、設計段階でコードの境界を細かく区切っていましたが、AIによるコード生成や設計変更の容易化により、まず機能をエンドツーエンドで構築し、その後でレビュー可能な小さなプルリクエスト(PR)に分割するアプローチが効率的であると論じています。この方法により、開発初期段階での製品検証が可能になり、手戻りを減らし、レビューの質を向上させることができます。
全文翻訳
広く構築し、狭くリリースする
優れたエンジニアは、構築する前に計画を立てます。私が育ったワークフローはこうでした:機能の説明をRFC(Request for Comments)として書き、それを小さな課題に分割し、それらを構築します。各課題はしばしば次の課題のブロッカーとなります。コードが一行も書かれる前に、作業の構造は固定されていました。
これは理にかなっています。コードレビューを管理しやすくし、ビッグバンマージを回避できます。しかし、それは問題について最も知識が少ない瞬間に、最も重要な構造上の決定を下すことを要求します。
何も構築する前に、あなたは推測しています:どの部分が分離可能か、それぞれがどれほど複雑になるか、ステップ3がステップ1を再考させるかどうか。時にはあなたは正しいでしょう。しばしばそうではなく、ステップ1は捨てられます。あなたはそれを構築することで何かを学びましたが、全体を先に構築することでより速く学べたでしょう。
私たちはそのコストを払っていましたが、それには良い理由がありました:代替案はすべてを構築し、手作業で整理することでしたが、1週間の作業を整理するのは事前に計画するよりも困難です。境界線を事前に決定することは、ビルドを容易にするためではありませんでした。それはレビューを可能にするためであり、そこに到達するための唯一の手頃な方法でした。それが変わった部分です。
何が変わったか
3つのことが劇的に安くなりました。
構築:AIアシスタントは、明確な問題を数時間、時には数分で動作するコードに変えます。
設計:会話の速度で計画を問い詰め、再形成できます。
そして、ここで最も重要なのは、完成したブランチの分解:1週間の絡み合った作業を小さなPRのシーケンスに分割することは、かつては仕事の最も退屈な部分でしたが、まさに私たちがそれを避けていた理由です。それは今やプロンプトになりました。
2つのことは安くなっていません。
第一に、コードレビューの判断の半分です。エージェントは機械的な部分(一貫性、些細なミス、明らかなバグ)をほぼ無料にしましたが、微妙な正しさやそれに関する質問を解決しません:この変更は適切な場所にあるのか、このエンドポイントの形状は6ヶ月後に問題にならないか。ボットがあなたのPRを承認することは、あなたがコードを理解することと同じではありません。そして、あなたがコードを書かなかったなら、それを所有するようになるにはそれを読むことが方法です。狭いPRはそれを可能にします。
第二に、プロダクト検証です。それを実行し、それが構築すべき正しいものであると決定することは、依然として遅いです。新しいのは、誰かが一行も読む前に、誰かに見せられるほど早く機能全体が動作することです。
したがって、もはや存在しないコストを回避するために、事前に境界線を決定することをやめてください。
私の現在のワークフローは次のようになります:
- 計画を徹底的に検討する:真の決定が下されるまで
- 仕様をコミットする:コードを書く前に、設計が斬新な時に
- 広く構築する:進捗を保存しながら
- デモして反復する:誰かがコードを読む前に
- PRに分割する:コードが明らかにした境界線に沿って
- マージ、最後にクリーンアップ:純粋な削除を独自の最終PRで
設計は依然として最初
はっきりさせておきます:これは「計画をスキップしてコーディングを開始する」ということではありません。エディタに触れる前に、計画があり、すべての機能は検討から始まります。私はgrill-meを実行します。これは、アイデアについて敵対的なラウンドでインタビューし、真の決定が下されるまで続けるスキルです。API呼び出しが失敗した場合のフォールバックは何ですか?私はそれをすべてに、小さな変更も含めて実行し、そこには私が気づいていなかったギャップが常に現れます。
設計が斬新な場合、計画はコードを書く前にコミットされる仕様になります。別のプロジェクトでは、最初のPRはドキュメントでした:機能は何であったか、どのように機能するか、信頼の境界線はどこにあったか。それは実装が存在する数日前にマージされたので、チームは最初に反対意見を述べることができました。
コミットされないのは、PRへの分解です。構築する前に何を構築するかを決定し、構築した後にどのようにスライスするかを決定します。
広く構築する
[画像: 片側にはくしゃくしゃになったスクラッチペーパーのビルドブランチ、もう片側には5つのプルリクエストがきれいに並んだ扇]
設計が確定したら、構築します。私はしばしば段階的に作業しますが、各ステップでPRを開いてレビューを待つことはしません。すべては1つのブランチに留まります。エンドツーエンドで、邪魔になるすべてのファイルを横断して動作するまでです。
コミットは発生しますが、それらは誰かにとっての節目ではありません。それらはセーブポイントです:コンセプトが証明された、またはリスクの高いことを試そうとしており、戻るためのロープが欲しい。最近完了したリファクタリングは、1日で12以上のコミットを数十ファイルにわたって実行し、運用メッセージ付きでした。私がどこに行ってきたかを見ることができるウェイポイントであり、レビュー担当者への物語ではありません。
これは一部のエンジニアを不快にさせる部分であり、その理由は理解できます:gitの履歴は記録であるべきです。しかし、この履歴は決して記録にはなりません。最後のPRはmainから新しく切り出され、ビルドブランチは捨てられるスクラッチペーパーです。時間的に隔てられた2つのオーディエンス、私とレビュー担当者、そしてそれらを分離しておくことで、両方に最適化できます。
コードを読む前にデモする
作業が良い状態になったら、立ち止まって見せます。PRやコードレビューとしてではなく、Slackでの短いビデオ、または変更をクリックする必要がある場合はプレビューデプロイメントとしてです。コードレビューが始まる前に、それを使用する人々からの動作するソフトウェアに対するフィードバックです。
レビューは、安価な半分が自動化された今、高価です。レビュー時に、間違ったものを作った(紛らわしいUIパターン、フロントエンドがデータをどのように使用するか合わないエンドポイントの形状)ことに気づくと、レビュー担当者の時間とあなた自身の時間を無駄にします。デモは変更が安価な間にそれを捉えます。再考が必要なことが明らかになった場合、私はまずそのフィードバックに対してgrill-meを実行するので、反復は単なる雰囲気ではありません。
狭くリリースする
[画像: 1つの絡み合ったビルドブランチが5つの狭いプルリクエストにカットされ、削除PRが最後]
ビルド順序は分割のラフドラフトにすぎません:ステップは再編成され、再カットされます。削除PRは最も明確な例であり、新しいパスが配置された後にのみ存在するユニットです。
私は1つのプロンプトを実行します:
現在の作業を、それぞれが単独でマージ可能で安全であり、可能な限りユーザーに価値を提供する、独立してレビュー可能な最小セットのPRに分割してください。gitのワークツリーを作成し、それぞれをmainからブランチしてください。依存関係が現実的な場合のみスタックし、それ以外の場合はmainからブランチしてください。置き換えられるコードの削除はすべて、独自の最終PRで行います。何かを作成する前に、提案された分割を見せてください。
所要時間は、作業の絡み具合によって数分から数回のやり取りまで異なります。いずれにせよ、手動でのチェリーピックはありません。
そのリファクタリングは5つのPRとして出てきました:mainから兄弟として2つのバックエンドエンドポイント、それらのデータが必要なバックエンドPRの上にそれぞれ座る2つのフロントエンドビュー、そして古いパスの純粋な削除である最終PR。削除は、機能全体が追加した行数よりも数百行多く削除しました。それがこの順序で行われたリファクタリングの形状です。
繰り返し行うことでたどり着いた2つのルールがあります:
依存関係が現実的な場合にのみスタックする。 フロントエンドビューPRは、そのバックエンドエンドポイントPRに依存し、ブランチはそのように反映されます。それ以外はすべてmainから来ます。利便性のためにスタックすると、一番下のPRでフィードバックがあった瞬間に後悔するリベースチェーンが作成されます。
クリーンアップは最後にリリースする。 古いコードは、新しいパスがライブになった後に、独自のPRで廃止されます。作成と削除を混在させると、レビュー担当者を混乱させ、ロールバックを曖昧にし、クリーンアップを機能のノイズに埋もれさせます。
分割は、私が自分の作業を読むときでもあります。PRごとに diff を確認し、頭で把握できるサイズで行うことは、AIが書いたコードをリリースしたことと、それを理解していることの違いです。私はそこで自分の問題を見つけたいです。
実用的な注意点:スタックの管理はコンテキストを急速に消費するので、分割作業をメインエージェントに報告するサブエージェントに引き渡してください。Cursorでは、split-to-prsスキルがこれをパッケージ化しています。
何が得られ、何がコストか
重いPRは重いままですが、それは当然です。バックエンドのPRは、実際のアーキテクチャリスク(新しいデータモデル、新しいAPIサーフェス、信頼の境界線)を担っており、レビュー担当者はそこに注意を払うべきです。それらを消費するフロントエンドPRは数分で読めます。小さく、集中したPRはスムーズに流れます。大きいものは滞留します。
エージェントのレビューループも、このスケールではより高速です。Adaptでは、Adapt自体をレビュー担当者として使用しています。これは、過去の作業からのビジネスコンテキストを持つエージェントです。PRが開かれてから数分以内にコメントし、やり取り(質問、明確化、小さな修正)は10分未満で解決します。これは、PRがすぐに読めるほど小さい場合にのみ機能します。複数の懸念事項を混在させた2,000行のPRは、人間からはまったくそのような扱いを受けません。
段階的にマージすることも、デプロイメントの管理を容易にします。何かが壊れた場合、焦点を絞った1つの変更を元に戻し、エラー追跡はその変更を指し示し、マージされたスタック全体を指し示すことはありません。
これらが利点です。それらには2つのコストが伴います。
リベース。 レビュー担当者が、別のPRがその上に座っているPRに対して変更を求めた場合、その上のすべてのブランチをリベースする必要があります。これは頻繁には起こりませんが(レビュー担当者は通常リーフPRに触れるため)、起こったときにはその影響を感じます。分割を生み出したチャットセッションを開いたままにしておいてください:それはまだ分割を保持しているので、手動で行う代わりに、上のブランチを更新するために再プロンプトできます。
分割はリリースではない。 これを書いている時点で、そのリファクタリングからの5つのPRはすべてまだ開いています。良い分割は、各PRをレビューしやすくし、かつ単独でマージする価値があるものにします。エージェントは前者(レビューのしやすさ)を私に代わって行いますが、後者は私が各PRに何を入れるかを決定する際の私の判断であり、チームが何をマージするかを決定する際の彼らの判断です。私のものは、私が前者(レビューのしやすさ)しか行わなかったために滞留しました。5つすべてが同じ日にマージされたとしても、私はレビューの利点と変更ごとのクリーンなロールバックターゲットを維持します。私が失うのは、インクリメンタルデリバリーです。なぜなら、ユーザーに早く到達したものはなく、デプロイは1つのバッチとして着地するからです。
いつ使うべきか
適している場合:バックエンドとフロントエンドを横断するマルチサーフェス機能、最終的な形状が作業完了までわからないリファクタリング、そうでなければ問題の境界線を推測することになるあらゆる作業。
難しい場合:本番環境でシーケンス化されなければならないマイグレーションとスキーマ変更。順序が現実的で、事前に計画すべき場合。カットする明確な場所が1つある作業。ステップ1が決して単独でリリースできない機能。すべてが一度に着地する場合、後からの分解はインクリメンタルレビュー以上のものを購入しません。
ヒューリスティック:あなたがRFCを書き、何も構築する前に課題にどう分割するかを推測しているなら、その時間は構築に費やした方が良いでしょう。あなたは最後に良い答えを持っているでしょう。私はこれをいくつかのプロジェクトでテストしてきましたが、うまくいっています。
構造上の決定は消えません。コードが目の前にある状態でそれを行うと、はるかに安価になるだけです。