完成の定義

どのようなものか

完成の定義は、作業を完成したプロダクトのインクリメントに含めるために
満たすべき、共通の品質基準です。「私のパソコンでは動く」は一つの観察
結果です。完成の定義があれば、変更を統合したか、必要な確認を済ませた
か、別の担当者が利用や保守を行える状態かを、チームで判断できます。プ
ロダクトが今どの状態にあるかを、関係者から見えるようにするためのもの
です。

スクラムガイドでは、プロダクトに必要な品質基準を満たしたときのインク
リメントを正式に記述したものと説明しています。基準を満たさない作業
は、リリースしたり、スプリントレビューでインクリメントの一部として提
示したりできません。後で再検討するため、プロダクトバックログへ戻しま
す。組織に定められた基準があれば、スクラムチームは少なくともその基準
に従います。同じプロダクトを作る複数のチームには共通の完成の定義が必
要です。証拠を集める手段まで同じである必要はありません。

受け入れ基準は、個々の変更に求める挙動を示します。例えば、書き出しに
関する変更では、利用者が指定した場合だけ、保管済みのアカウントを含め
るよう求めることがあります。一方、完成の定義では、保存データを変更す
る作業が統合され、既存の代表的な記録で確認され、必要な運用手順の更新
を伴うことを求められます。前者はその書き出しの挙動を扱い、後者はプロ
ダクト全体の作業に共通する品質を扱います。変更の判断には、それぞれの
証拠が必要です。

なぜ重要なのか

共通の判断基準があると、計画と引き継ぎで迷いにくくなります。バックグ
ラウンド処理が単体テストに通っていても、古いデータを使って移行を試し
た人がまだいない場合があります。実装担当者は作業がほぼ終わったと考
え、運用担当者は公開に向けたリスクが残っていると考えるかもしれませ
ん。完成の定義は、別の担当者が変更を前提に計画を立てる前に、何を示す
必要があるかを明らかにします。不足している証拠も具体的に伝えられま
す。

条件を選ぶときは、チームが繰り返し対処する故障や不備を考えます。ライ
ブラリであれば、変更した公開動作のテスト、影響を受ける版での互換性の
確認、互換性が失われる場合の更新案内を求められます。個人情報を扱う
サービスでは、変更した経路でその情報がどう処理されるかを確認します。
画面を担当するチームには、キーボード操作に関する共通条件や、対応言語
ごとに変更した文言を読む確認があり得ます。いずれも、検証できる状態を
条件として書きます。その状態を示すコマンド、記録、レビュー結果は別に
残せます。

この定義があれば、進捗の表示も比較しやすくなります。一方のチームが
コードレビューの後で作業を完了とし、他方が代表的なデータでの試験を待
つなら、同じ表示に異なる残作業が隠れます。基準をそろえても開発の難し
さはそろいません。どこまで確認したかを、同じ意味で伝えられるようにな
ります。

実際の活用例

架空の報告システムを考えます。夜間に取引先のファイルを取り込み、失敗
時には最後に検証した報告を利用できるようにしています。次の変更では任
意項目を一つ追加します。受け入れ基準は、項目のあるファイルとないファ
イルを扱います。取り込み処理の変更に対する完成の定義には、次の条件が
考えられます。

  * 全体として評価する版に変更を統合する。代表的な入力で、受け入れ基
準と、影響を受ける既存の挙動を確認する。

  *
安全な試験環境で、途中の失敗と再試行を実際に発生させる。前回の報告を
開けることと、再試行で同じ行が二重に登録されないことを確認する。

  * 変更した運用手順を、担当者が探す場所で更新する。リリースの記録
に、試した入力、結果、重要な制約を記載する。

検証には実際のリリース候補を使います。既存のファイル、新しい項目を持
つファイル、制御した障害の順に試します。障害の前後で報告の識別子を記
録し、再試行して合計と行の識別子を照合します。別の担当者に新しい手順
書を探してもらい、どの報告が利用可能かを確かめてもらいます。正しい手
順書が、使う人に見つけられない場所にあることもあります。試験で必要な
状態を観察できなければ、不足を記録して検証方法を直します。

当社のサービスレベルでは、文書化や、コード、アクセス権、認証情報、現
状の引き継ぎについて説明しています。これらは調べられる具体的な内容で
す。例えば、別の保守担当者が使える引き継ぎ文書を条件とし、その人に関
連する手順や未解決の問題を見つけてもらう方法があります。これは完成条
件の一例です。リンク先の公開内容は、チームが選ぶ開発手法とは独立して
います。

問題が起きるところ

判断できない文言は問題になります。「入念にテストする」だけでは、取り
込みが中断したときに不足していることを判断できません。「復旧を確認す
る」だけでは、報告を実際に開く前に確認を終えてしまうかもしれません。
何を観察し、どの結果を得ればよいかを書きます。確認項目が変更に本当に
当てはまらない場合は、理由を記録して、当てはまる確認を続けます。

長い作業一覧を共通基準にすると、変更に適した方法を選びにくくなりま
す。既知の報告を使うだけで復旧を確かめられるチームもあれば、実際の
バックアップを復元する必要があるチームもあります。証拠の取り方は違っ
ても、復旧後に必要な状態は共通です。具体的なやり方は道具の近くに置
き、重要な状況が曖昧だと分かったら共通条件を見直します。

テストが通っても、示せるのは確認した範囲です。報告が存在することを検
証しても、それが前日のものだと見落とす場合があります。各観察が何を示
し、実際に次へ進める候補に対して行ったものかを確認します。基準を満た
せなければ、不足する証拠と次の作業を残します。達成した結果と、利用で
きるインクリメントになるまでの作業が、それぞれ分かります。

参考資料

  * スクラムガイドの完成の定義

  * Scrum.org による完成の定義の解説

  * 英国政府のサービスマニュアルのユーザーストーリーと受け入れ基準

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/definition-of-done/	engineer.company	70
