受け入れ基準(Acceptance Criteria)とは、ひとつのユーザーストーリーがプロダクトオーナーに受け入れてもらうために満たすべき条件です。その作業で何ができるようになるべきかを書いたものです。一方、完了の定義(Definition of Done、DoD)は、ストーリーの中身にかかわらず、チーム全員がすべてのストーリーに当てはめるひとつのチェックリストです。誰かが「終わった」と言う前に、作業が越えなければならない品質のラインです。受け入れ基準が答えるのは「正しいものを作ったか?」で、中身はストーリーごとに違います。完了の定義が答えるのは「ちゃんと作ったか?」で、スプリントが変わってもほとんど変わりません。両方を満たして、はじめてストーリーは完了です。
この二つが混同されるのも無理はありません。どちらもチェックボックスが並んだリストで、どちらもチケットのいちばん下にあり、どちらもカードをボードの最後の列に動かしてよいかを決めるものだからです。そこから生まれる言い合いは、だいたいこうなります。開発者は、チケットに書かれたことは全部できているから完了だと言う。別の誰かは、まだレビューされていない、ノートPCでしかテストしていない、韓国語のエラーメッセージを誰も見ていない、だから完了ではないと言う。どちらも正しいのです。見ているリストが違うだけで。初めてマネージャーとして受け持ったチームでチーム規範を書き出したとき、「完了とは実際のところ何を指すのか」は、リストに挙げた暗黙の前提のひとつでした。その答えの大部分が、この区別です。
完了の定義と受け入れ基準の違い(比較表)#
| 受け入れ基準 | 完了の定義 | |
|---|---|---|
| 対象 | ひとつのユーザーストーリーやバックログアイテム | チームが仕上げるすべてのアイテム |
| 答える問い | このストーリーに必要なことができているか? | 自分たちの基準どおりに作られているか? |
| 書く人 | プロダクトオーナー(開発者と一緒に詰める) | チーム全員(組織に標準があれば、それが最低ライン) |
| 書くタイミング | ストーリーがスプリントに入る前、リファインメントで | 一度決めて、あとはレトロスペクティブで見直す |
| 変わる頻度 | ストーリーごとに違う | めったに変わらない。変わるなら厳しくなる方向だけ |
| スクラムガイドでの扱い | 言及なし | あり。インクリメントの確約(コミットメント)として |
| 例 | 「期限切れのリセットリンクを開くと、期限切れだと伝えて新しいリンクを案内する」 | 「別の開発者のレビュー済み、CIでテストが通る」 |
意外に思われるのが、スクラムガイドの行です。2020年版のスクラムガイドは完了の定義を「プロダクトの品質基準を満たすインクリメントの状態を示した正式な記述」と定義していて、それを満たしていないアイテムは「リリースすることはできない。ましてやスプリントレビューで提示することもできない」としています(公式の日本語版では「完成の定義」と訳されていますが、この記事では一般によく使われる「完了の定義」で通します)。一方、受け入れ基準はスクラムガイドに一度も出てきません。ルーツはユーザーストーリーの系譜、つまりエクストリームプログラミング(XP)と、その後の振る舞い駆動開発(BDD)にあります。それでもほとんどのスクラムチームが受け入れ基準を使っているのは、それがないストーリーは「推測で作ってください」と言っているようなものだからです。
ひとつのストーリーで見る、受け入れ基準と完了の定義の例#
たいていのプロダクトのバックログに、どこかしらにあるストーリーを例にします。
パスワードを忘れた顧客として、メールでパスワードをリセットしたい。それは、自分のアカウントにまた入れるようにするためだ。
このストーリーの受け入れ基準を、Given/When/Then形式のシナリオで書くとこうなります。
Scenario: リセットリンクを請求する
Given サインインページを開いている
When 「パスワードをお忘れの方」を選び、自分のアカウントのメールアドレスを入力する
Then 1分以内にリセットリンクがメールで届く
And 受信箱を確認するようにとページに表示される
Scenario: アカウントのないメールアドレス
Given 入力したアドレスを使っているアカウントがない
When リセットリンクを請求する
Then ページには同じ「受信箱を確認してください」というメッセージが表示される
And メールは送られない
Scenario: 期限切れのリンク
Given リセットリンクが発行から30分以上たっている
When そのリンクを開く
Then リンクの期限が切れていることが表示される
And 同じページから新しいリンクを請求できる
Scenario: 新しいパスワードを決める
Given 有効なリセットリンクを開いている
When パスワードのルールを満たす新しいパスワードを入力する
Then サインインした状態になる
And 古いパスワードとほかのリセットリンクはすべて使えなくなる受け入れ基準が本領を発揮するのは、2つ目のシナリオのようなところです。アカウントがあってもなくても同じメッセージを出せば、どのメールアドレスが登録されているかを、フォームが見知らぬ人に教えてしまうことはありません。これはプロダクトとしての判断で、誰かが決めなければなりません。決めるのにいちばんいいタイミングは、あとからレビューコメントで指摘されたときではなく、誰かがコードを書き始める前です。
そして、こちらがチームの完了の定義です。このストーリーでも、ほかのどのストーリーでも同じです。
- [ ] 別の開発者がコードをレビューし、承認している
- [ ] 新しい振る舞いの自動テストを書き、CIですべて通っている
- [ ] 受け入れ基準をローカルだけでなくステージングで確認した
- [ ] ステージングへのデプロイ後、エラートラッカーに新しいエラーが出ていない
- [ ] ユーザーに見える文言を、プロダクトが対応するすべての言語で追加した
- [ ] 振る舞いが変わったなら、APIドキュメントか変更履歴を更新した
- [ ] プロダクトオーナーが動いているところを見た3行目に注目してください。完了の定義は「受け入れ基準を満たしていること」を求め、その中身が何かは受け入れ基準が決めます。二つのリストはこうしてつながっていて、だからこそ、どちらも相手の役目まで背負おうとするべきではありません。
準備完了の定義(Definition of Ready)の位置づけ#
この仲間の3つ目の用語が、準備完了の定義(Definition of Ready、DoR)です。チームがストーリーをスプリントに取り込む前に満たしているべき、短いチェックリストです。よくある中身は、受け入れ基準があること、見積もりがあること、依存関係がわかっていること、そしてスプリント内に終えられる大きさであること。これもスクラムガイドには出てきません。2020年版にあるのは、「1スプリント内でスクラムチームが完成できるプロダクトバックログアイテムは、スプリントプランニングのときには選択の準備ができている」という一文だけです。
順番にすると、スタート地点に準備完了の定義、スプリントの前に書いて最後に確かめる受け入れ基準、そしてゴールラインに完了の定義、となります。受け入れ基準のないストーリーは、まだ準備ができていません。誰も十分にわかっていないせいで受け入れ基準が書けないなら、たぶん先にスパイクが必要です。ただし、準備完了の定義は短く保ってください。厳格な関門として扱うと、作業を断るための道具になってしまい、半分しかわかっていないストーリーについての有意義な会話が起きなくなります。
役に立つ受け入れ基準の書き方#
タスクではなく、ユーザーやシステムが何をするかを書きます。「reset_tokensテーブルを作る」は作り方で、開発者の計画に書くものです。「古いパスワードが使えなくなる」は成り立っていなければならないことで、こちらが基準です。
どの基準も、議論の余地なく合否がつくようにします。「メールがすぐ届く」はレビューで揉めますが、「1分以内」なら揉めません。
うまくいかない場合(アンハッピーパス)も書きます。期限切れのリンク、登録されていないアドレス、同じリンクの2回目のクリック。バグが潜んでいるのはこういうところで、まだ決まっていないプロダクトの問いが隠れているのも同じ場所です。
数は3〜7個くらいを目安にします。それより大幅に多いなら、たいていそのストーリーは実は2つのストーリーです。
形式はストーリーごとに選びます。Given/When/Thenは振る舞い駆動開発から来た書き方で、自動テストやUATのスクリプトにそのまま対応するので、流れのあるものには私はこれを使います。単純なルールなら、ふつうのチェックリストで十分です(「この欄には1〜200文字を入力できる」など)。どの基準も無理にGiven/When/Thenに押し込むと、長い文ができあがるだけです。
受け入れ基準は、開発者もいるリファインメントの場で書きます。責任を持つのはプロダクトオーナーですが、「リンクを2回開いたらどうなるの?」と聞いてくれるのは、実際に作る人たちです。
実際に使われる完了の定義の作り方#
理想を並べたリストからではなく、調子のいい日にチームがすでにやっていることから始めます。全員が黙って半分を飛ばしている完了の定義は、ないよりも悪いものです。チェックリストはただの飾りだ、とチームに教えてしまうからです。
完了の定義は、作業が行われる場所に置きます。私がいたチームでは、Wikiのページに書いていました。書かないよりはずっといいのですが、ページは誰かが開こうと思い出したときにしか読まれず、それはたいていレトロスペクティブのときです。プルリクエストのテンプレートに入っていれば、変更のたびにチェックが入ります。
<!-- .github/pull_request_template.md -->
## 何をなぜ変えたか
## 完了の定義
- [ ] テストを追加または更新し、CIで通っている
- [ ] 受け入れ基準をステージングで確認した
- [ ] ユーザーに見える新しい文言を、対応するすべての言語で追加した
- [ ] 振る舞いが変わったなら、ドキュメントか変更履歴を更新したどの行も、確かめられるものにします。「コードがきれい」には、誰も正直にチェックを入れられません。「別の開発者がレビューし、承認した」なら入れられます。
基準は意図して上げていきます。今のリストを余裕を持って満たせるようになったら、次の項目を足します。リスクのある変更にはフィーチャーフラグを付ける、黙って失敗しうる新しいものにはアラートを設定する、といったものです。それを決めるのにちょうどいい場がレトロスペクティブです。
ひとつのプロダクトに複数のチームが関わっている場合、スクラムガイドは「共通の完成の定義を作成して、それに準拠する必要がある」としています。さらに、組織に標準の完了の定義があれば、すべてのチームが「最低限それに従う必要がある」。ということは、チームはそこに足すことは自由にできても、何かを削ることはできません。
気をつけたい失敗#
完了の定義を、ストーリーごとの受け入れ基準に書き写すこと。「テストを書いた」「コードレビュー済み」はストーリーに書くものではありません。どのチケットも膨らむうえに、本当にそのストーリーについての基準が埋もれてしまいます。
中身が実はタスクだったり、デザインだったりする受け入れ基準。「モーダルを使う」はデザインの判断です。「ページを離れずに新しいリンクを請求できる」なら基準で、デザイナーがモーダルよりいい方法を考える余地も残ります。
スプリントの途中で、何も言わずに受け入れ基準を変えること。要件が変わったのなら、それはプロダクトオーナーと話すべきことで、多くの場合は新しいストーリーになります。古いストーリーをこっそり書き換えて済ませるものではありません。
「完了はしたけど、本当の完了(done-done)ではない」。マージした時点で、まだ誰もステージングで確認していないのに完了扱いになるなら、チームは2つの定義を1つと呼んで運用しています。どこまでやれば完了なのかを、完了の定義にはっきり書いておきましょう。
長すぎて、スプリントの中で誰も満たせない完了の定義。そうなると、みんながそれぞれ別の行を飛ばし、誰もそれを口にしなくなります。
ユーザー受け入れテスト(UAT)とのつながり#
受け入れ基準は、ユーザー受け入れテスト(UAT)を始めるときの自然な出発点です。シナリオのひとつひとつが、チームの外の人でもたどれるテストケースになります。そしてUATは、受け入れ基準そのものの確認にもなります。ユーザーがすべてのシナリオを通り抜けたのに、それでも自分の仕事ができない、ということがあります。その場合、間違っていたのはコードではなく基準のほうです。次のストーリーを書く前に知っておけると助かる情報です。
受け入れ基準と完了の定義のテンプレート#
受け入れ基準:
**ストーリー:**[ユーザーの種類]として、[目的]したい。それは[理由]のためだ。
**受け入れ基準**
- [前提となる状態]のとき、[操作]をすると、[結果]になる。
- [前提となる状態]のとき、[操作]をすると、[結果]になる。
- [前提となる状態]のとき、[操作]をすると、[結果]になる。
**対象外:**[このストーリーであえてやらないこと]「対象外」の行は任意ですが、私なら残します。レビューのときに起きるはずだった言い合いの多くを、始まる前に終わらせてくれます。
削るなり足すなりして使える、完了の定義のたたき台です。
- [ ] 別の開発者がコードをレビューし、承認している
- [ ] 自動テストを書き、CIで通っている
- [ ] 受け入れ基準をステージングで確認した
- [ ] ステージングへのデプロイ後、監視に新しいエラーや警告が出ていない
- [ ] ユーザーに見える文言を、対応するすべての言語で追加した
- [ ] 振る舞いが変わったなら、ドキュメント、変更履歴、リリースノートのいずれかを更新した
- [ ] プロダクトオーナーが動いているところを見たざっくり言うと#
受け入れ基準は、ひとつのストーリーのものです。そのストーリーが何をすべきかを書き、スプリントの前にプロダクトオーナーがチームと一緒に書き、毎回中身が違います。完了の定義は、チームのものです。どのストーリーも通らなければならない品質基準のチェックリストがひとつだけあり、変更のたびにチームの目に入る場所に置かれ、変わるのはチームが基準を上げると決めたときだけです。準備完了の定義を使っているなら、それは両方の手前にあって、ストーリーが着手する価値があるだけの詳しさを、受け入れ基準も含めて備えているかを確かめるものです。
さらに読む#
このサイトの関連記事:
- スパイクとは?アジャイル・スクラムで見積もれないストーリーの調べ方 - まだ受け入れ基準を書けないストーリーのために
- ユーザー受け入れテスト(UAT)の進め方とフィードバックの扱い方 - 受け入れ基準がテストのスクリプトになる場面
- エンジニアリングチームで本当に定着するチーム規範の作り方 - 「完了」の意味をそろえる話も含めて
- スプリントレトロスペクティブ(ふりかえり)の進め方:実際の変化につなげるには - 完了の定義を見直すべき場
外部リソース:
- スクラムガイド(2020年版)(日本語版PDF) - 完了の定義を、スクラムガイド自身の言葉で
- Introducing BDD(Dan North) - Given/When/Thenの出どころ
- Given When Then(Martin Fowler)
