principle-sequence-verifiable-units

作業を検証可能な単位に分けて進める

作業を、確認できる状態で終わる小さな単位の連続として順序立て、現在の単位が正常になるまで先へ進まないでください。

理由： 問題が原因となった単位で見つかれば、原因の特定は容易です。まとめて実行した後に見つかった問題は埋もれてしまい、すでに壊れた土台の上にさらに作り込んでいることになります。同じ単位を、レビュー担当者が再現できる形で順序立てて納品すれば、「信じてください」が「失敗するのを見てから、成功するのを見てください」に変わります。

実行。 一括変更、移行、または同様の編集を連続して行う場合は、次の作業を始める前に変更を一つずつ検証してください。各単位は変更前後の確認です。正常な状態を確認し、変更を一つ加え、チェックを実行してから次へ進みます。まずクリーンな trunk にリベースし、すべてのチェックが実際のベースラインと比較されるようにします。編集をレバーに任せる場合、単位ごとのチェックはほぼ無料です。それでも実行してください。

納品。 作業を証明できる順序でコミットと PR を積み重ねます。基本形は、失敗するテストを先に置き、その上に修正を重ねる形です。そのほかの構成例として、形を変える前に不要なものを取り除く、処置を行う前にベースラインを記録する、機能を実装する前に足場を整える、といった順序があります。各コミットはそれぞれ単独で成立し、一連の流れが論証として読めるようにします。

チェックを確実なものにする prove-it-works 原則スキルと、単位ごとのチェックを容易にする build-the-lever 原則スキルを補完する、順序立ての原則です。