要件定義の書き方|小さなシステムの範囲・条件・確認方法をそろえる
※本記事にはPRを含む場合があります。
こんにちは。『脱会社員』脱サラを応援し続けるブログ、運営者の『なかびー』です。
要件定義を書くとき、最初から立派な目次や専門用語をそろえる必要はありません。まず必要なのは、何のために、どこまでを作り、何が確かめられればよいかを、関係者が同じ意味で読めるようにすることです。「便利な管理システムがほしい」という要望を、そのまま完成の約束にせず、判断できる単位へ分けていきます。
小さな業務システムでも、貸出できる人、同じ備品を扱うときの条件、記録する情報、間違えた場合の扱いなど、決めることはあります。話した内容を順番に並べただけの議事録では、採用された要望と検討中の案が混ざりがちです。要件定義書では、それぞれに識別番号を付け、理由、前提、確認方法をつなげると、後から変更の影響をたどれます。
この記事では、架空の小規模オフィスで使う「備品貸出一覧」を題材に、目的と範囲、要求の採否、要件の文章、機能以外の条件、確認基準、変更管理を六つの段階で整理します。掲載する組織、役割、日付、件数、時間、書式は説明用の架空例です。実在する案件の実績や、あらゆるシステムに適用できる標準値を示すものではありません。図版は説明用に生成したイメージです。
公式資料は2026年10月6日(日本時間)に確認しました。NASAやMicrosoftの資料は文章の明確さや確認方法を考える参考にし、本稿の日本語記入例は独自に作成しています。特定製品の導入、宇宙開発の全工程、法的な検収や契約条項を一律に求める内容ではありません。まずは、一つの要望を最後の確認まで追える文書を作ってみましょう。
目的と対象範囲を、作るもの・作らないものに分ける

業務の困り事と、今回変える状態を先に書く
架空のオフィスでは、共用のプロジェクターや変換アダプターを紙の貸出票で管理しているとします。困っているのは、備品が棚にないときに、貸出中なのか、返却後に別の場所へ置かれたのか分からないことです。この場合の目的は「管理をデジタル化する」より、「担当者が備品ごとの現在の貸出状況を確認できるようにする」と書く方が、必要な機能を選びやすくなります。
目的欄に、まだ測っていない削減時間や改善率を入れる必要はありません。確認できた困り事と、期待する変化を分けて書きます。もし「問い合わせを減らす」という目標も置くなら、今の問い合わせの数え方と確認期間を決めてから評価する項目にします。根拠のない「作業時間を半減」を、システム完成時の保証へ変えないようにしてください。
現在の業務も短く残します。誰が備品を渡し、誰が紙に記入し、返却後に誰が状態を確かめるのかを、一往復の流れとして記述します。新しい一覧を作っても、実物を返したことと返却記録が一致しなければ、所在は分かりません。人が担当する作業と、システムで扱う情報の境目を見つけることが、最初の整理になります。
対象と対象外を同じ定義票に置く
対象範囲は「備品管理一式」では広すぎます。今回の例なら、備品の登録、貸出の記録、返却の記録、現在状態の参照を対象とします。将来の貸出予約、自動の督促通知、購入申請、修理依頼は対象外と明示します。これにより、予約の相談が出たときも、書き忘れなのか、追加で判断する要望なのかを区別できます。
※表は横にスクロールできます。
| 定義する項目 | 備品貸出一覧の架空例 | 確認する観点 |
|---|---|---|
| 目的 | 担当者が備品ごとの現在の貸出状況を確認する | 記録と実物の受け渡しを誰が対応させるか |
| 利用者 | 備品担当者。その他の職員は担当者へ貸出を依頼 | 職員による直接更新を今回含めるか |
| 今回の対象 | 備品登録、貸出記録、返却記録、現在状態の参照 | それぞれの開始条件と終了状態 |
| 対象外 | 将来の予約、自動通知、購入申請、修理依頼 | 追加する場合は別の採否判断へ回す |
| 前提 | 担当者が実物を渡した後、その場で貸出を記録する | 記録前に別担当が操作した場合を後で確認 |
| 確認対象 | 記録から貸出可能・貸出中を区別できる | 故障中など別状態の必要性は未決として残す |
対象外は、関係者の希望を否定する欄ではありません。「将来も作らない」と「今回の版に含めない」は分けます。自動通知を今回は見送るなら、通知しない間は誰が返却予定を確認するかを業務側へ確かめます。対象外にしたことで残る作業まで見えていれば、システムの外に必要な対応を置き忘れにくくなります。
説明する人、使う人、判断する人を区別する
要件を説明した人が、すべてを決められるとは限りません。備品担当者は日常の例外に詳しくても、記録を保持する期間や参照権限を決める役割は別の管理担当かもしれません。定義票には、業務の説明者、内容を確認する人、範囲を決める人を分けて書きます。同じ人が兼ねる場合も、どの立場の判断かを残すことが大切です。
IPAの「ユーザのための要件定義ガイド 第2版」の公開概要と目次では、業務部門の関与に加え、データ、機能、運用や移行などが扱われています。本稿ではこの案内の概要と目次を参照しています。案内は2024年4月時点のアーカイブであり、ここに載る書籍の販売は終了しています。特定のひな型を埋めることだけで、業務側の確認が済むわけではありません。
この段階の完成物は、目的・範囲・対象外の定義票です。担当者が休んでも、次の人が「何を扱う仕組みなのか」「今回どこまで決めるのか」を説明できるかを読んで確かめます。説明を聞いて初めて分かる条件があれば、本文か前提欄へ追記してください。まだ答えのないことは、都合のよい仮定で埋めず、未決として次の一覧へ渡します。
要望を根拠と採否付きの一覧へ整理する

最初の言葉を残してから、困り事へ結び付ける
聞き取った要望は、要望IDを付けて保存します。例として、REQではなくWANT-01を「いま誰が使っているか知りたい」、WANT-02を「同じ備品を二重に貸したくない」とします。元の言葉を残すのは、後で文章を整えた結果、相手が意図した困り事まで変わっていないかを確かめるためです。識別番号の接頭辞は自由ですが、一度決めた意味を資料の途中で変えないようにします。
要望欄の隣には、誰のどの業務で必要なのかを書きます。「担当者からの要望」だけでは、理由が弱くなります。「棚にない備品について問い合わせを受けたとき、貸出相手を確認したい」という場面まで残すと、必要なデータや確認方法を検討できます。困り事の発生頻度が不明なら、不明と書き、実測した数字のようには扱いません。
解決手段が先に提示される場合もあります。「スマホへ通知してほしい」と言われたら、まず通知で解決したい問題を聞き分けます。返却予定を忘れることなのか、一覧を見ないことなのかで、必要な内容が変わります。要望の記録欄には元の案を残し、検討欄へ代替案を並べます。最初に出た手段が、そのまま必須要件になるわけではありません。
採否を四つに分け、判断者と理由を添える
小規模な例では、採否を「必須」「後回し」「不採用」「未決」の四つで整理できます。ここでの必須は今回の目的達成に必要と関係者が判断したもの、後回しは必要性を認めても今回の対象から外すもの、不採用は理由があって取り入れないもの、未決は判断材料が不足しているものです。この区分は本稿の記入例であり、決まった業界共通の格付けではありません。
※表は横にスクロールできます。
| 要望ID・内容 | 根拠となる場面 | 今回の採否と理由 | 判断・確認の残し方 |
|---|---|---|---|
| WANT-01:現在の貸出先を知る | 棚に備品がなく、担当者が所在を尋ねられる | 必須。現在状態の把握が目的のため | 業務責任者の確認を記録しREQ-01へ |
| WANT-02:二重貸出を防ぐ | 別の担当者も同じ備品を扱う | 必須。一つの備品を同時に複数へ割り当てない | 業務上のルールを確認しREQ-02へ |
| WANT-03:返却予定の自動通知 | 予定日を過ぎたときに確認したい | 後回し。初版では担当者が一覧を確認 | 再検討条件と代わりの業務を記録 |
| WANT-04:全職員が履歴を更新 | 担当者が不在でも変更したい | 不採用。初版の記録責任を担当者に限定 | 不在時の代理担当の扱いは別に確認 |
| WANT-05:故障中を区別する | 返却済みでも次に貸せない備品がある | 未決。修理中の業務ルールが未確認 | 業務責任者・確認日・影響する状態定義を記録 |
必須が増えすぎたら、一つずつ「これがないと、今回の目的のどの部分が成立しないか」を確認します。強い希望や発言回数だけで優先順位を決めないことが大切です。一方、発生頻度が低いからといって、不正な変更や取り返しのつかない記録喪失への対策を機械的に後回しにしないでください。頻度に加えて、起きたときの影響と代替手段を比較します。
複数人の意見が違うときは、両方の前提を残します。「誰でも変更できる方がよい」という人は夜間の利用を想定し、「担当者だけがよい」という人は記録の責任を重視しているかもしれません。まず場面を分け、代理担当を設けるなど、目的と責任を満たす選択肢を検討します。多数決の結果だけを、必要な関係者の判断に置き換えないようにしましょう。
未決と後回しを混ぜず、終わらせる条件を置く
未決には、何が分かれば判断できるか、誰が確認するか、いつまでに回答を得たいか、未回答なら何が進められないかを添えます。故障中の扱いが未決なら、「業務責任者が貸出停止と再開の条件を確認。状態一覧の確定前に回答が必要」と残します。単に「要相談」と書いた行は、担当者が変わるとそのまま放置されやすくなります。
後回しは、すでに今回の範囲から外す判断をしたものです。再検討のきっかけを「利用開始後の問い合わせ記録を見て判断」と書けますが、実施時期や実現を約束したことにはしません。不採用も削除せず残すと、同じ提案が再び出たときに、当時の理由が今も成り立つかを確認できます。採否の履歴は、提案者を評価するためではなく、文書の判断を追えるようにするためのものです。
この段階で、採用する要求には次に作る要件IDの参照先を付けます。一つの要望から、複数の要件が生まれる場合はあります。反対に複数の要望が同じ要件で満たせる場合もあります。行数を一対一にそろえることより、どの困り事に対応しているかをたどれることを優先してください。どの要望にも結び付かない機能があれば、追加した理由を確かめます。
一つの要件を条件・対象・結果が分かる文章にする

要件文は、いつ・何に対して・どうなるかを書く
要件文には、動作する条件、対象となるもの、期待する結果を入れます。たとえばREQ-01を「備品担当者が登録済みの備品を指定したとき、システムはその備品の現在状態と、貸出中の場合の借り手識別情報を表示する」とします。現在状態の意味は別の用語表へ定義し、この文章だけで状態の種類や例外を全部抱え込まないようにします。
「一覧を使いやすくする」「速やかに処理する」「適切に管理する」は、そのままでは読み手によって意味が変わります。何を見つけられる必要があるか、どの操作の結果を評価するかへ書き換えましょう。ただし、具体的な数値が未確定なのに、書式を完成させるためだけに値を入れてはいけません。数値が必要な項目は、測定条件と判断者を付けて未決として扱えます。
NASAのSystems Engineering Handbook付録Cでは、一つの要件に一つの内容を持たせること、用語や前提をそろえること、検証できる表現にすることなどが確認観点として示されています。本稿では文章を点検する考え方を参考にしており、英語のshallの書式やNASAの工程全体を、そのまま小規模な業務システムへ義務付けてはいません。
※表は横にスクロールできます。
| 元の書き方 | 分けて記載する例 | 別欄で補うこと |
|---|---|---|
| 備品を簡単に管理する | REQ-01:指定した備品の現在状態と、貸出中の場合の借り手識別情報を表示する | 対象備品、状態の定義、参照権限 |
| 貸出と返却と通知を行う | 貸出記録と返却記録を別IDにする。通知は採否一覧へ戻す | 独立した結果ごとに確認方法を作る |
| 二重貸出を防ぐ | REQ-02:貸出中の備品への新規貸出記録を拒否する | 同時操作時の扱い、拒否後の既存記録 |
| 返却処理をする | REQ-03:担当者が貸出中の記録を選び返却を確定したとき、返却日時を記録する | 日時の取得元、訂正権限、状態の更新要件 |
| 誰でも分かる状態にする | 状態の定義を用語表に記載し、表示する名称を統一する | 利用者に意味が伝わるかを別途レビュー |
一文の中の複数の約束をほどく
「返却すると状態が変わり、履歴が保存され、通知が送られる」という一文には、独立して確認したい結果が三つあります。状態の更新、履歴の記録、通知の送信をそれぞれ分ければ、一つが未対応でも残りを完成扱いにしてしまうことを避けられます。通知が今回の対象外なら、文の勢いで混入させず、要求の採否へ戻して判断します。
分けすぎにも注意します。単語ごとにIDを振ると、業務として何が完了するのか読みにくくなります。判断の目安は、結果や確認方法を独立して説明できるかです。必要な関係は「REQ-03により返却日時を記録した貸出について、REQ-04で現在状態を貸出可能へ更新する」のように、参照先でつなげます。参照を使う場合は、片方だけ変えたときの不整合も点検します。
システムの動作と、利用者の行動は分けて書きます。「担当者が毎朝未返却を確認する」は業務手順です。「担当者が指定した基準日より返却予定日が前で、返却未記録の貸出を抽出できる」はシステムに求める働きです。どちらも必要になり得ますが、一つの要件文へ混ぜると、担当者の作業までシステムが自動実行するように読まれるおそれがあります。
同じ名詞を同じ意味で使い、実装の理由は分ける
備品、貸出、返却、在庫など、日常語ほど意味のずれが起きます。本稿の例では、備品は個別の備品IDで識別する一つの物品とします。同じ型のアダプターが二つあれば、別々の備品IDで管理する前提です。数量の合計だけで管理する消耗品は対象外と書いておくと、「残数を減らす」別の方式を途中で持ち込みにくくなります。
※表は横にスクロールできます。
| 用語 | この架空例での意味 | 混同しやすいもの |
|---|---|---|
| 備品ID | 一つの物品を識別する、変更・再利用しない番号 | 同じ型番や商品名 |
| 貸出中 | 有効な貸出記録があり、返却が記録されていない状態 | 将来の利用予約 |
| 返却記録 | 担当者が実物の返却を確認して記録すること | 返却予定日になっただけの状態 |
| 貸出可能 | 登録済みで、有効な未返却の貸出記録がない状態。故障など別の制限は未決 | 故障や棚の実物確認まで自動保証した状態 |
| 業務責任者 | 例の業務ルールと対象範囲を判断する役割 | 日々のすべての入力を行う担当者 |
「このデータベースを使う」「このライブラリで作る」といった手段は、目的だけから当然には決まりません。既存環境との連携などで指定が必要なら、制約欄に、指定の理由、確認した人、変更できる条件を別記します。必要な結果と実現手段を分けておくと、後から別の手段を検討しても、業務として満たすべき約束を見失いません。
要件一覧は、理由と前提を別欄にしてつなぐ
記入を始めるときは、次のように要件文と根拠を並べると、読み直しやすくなります。表は架空の文書例であり、実際に承認された要件ではありません。REQ-02は貸出の可否を決める条件、REQ-05は許された貸出について記録する内容を扱います。機能名だけでまとめず、違う結果を別のIDで参照します。
※表は横にスクロールできます。
| ID・要件文の記入例 | 根拠と前提 | 対応する確認 |
|---|---|---|
| REQ-01:担当者が登録済みの備品を指定すると、システムは現在状態と、貸出中の場合の借り手識別情報を表示する | WANT-01。状態の定義が合意され、記録が更新されている前提 | CASE-01 |
| REQ-02:システムは、現在状態が貸出可能の備品についてのみ新規の貸出記録を認める | WANT-02。一つの備品IDは一つの実物を表す。貸出中は拒否する | CASE-02・CASE-03・CASE-05 |
| REQ-03:担当者が貸出中の記録を指定して返却を確定すると、システムは返却日時を記録する | 実物の返却を担当者が確認する前提。日時の意味を事前に確定する | CASE-04 |
| REQ-04:返却日時を記録した貸出の備品について、システムは現在状態を貸出可能へ更新する | 返却記録と状態参照を一致させる。故障中の扱いは別の未決事項 | CASE-04 |
| REQ-05:許可された貸出の確定時に、システムは貸出ID、備品ID、借り手の識別情報、貸出日時、返却予定日を記録する | 貸出先と予定を特定するため。各項目の必須条件と値の意味は項目定義を参照 | CASE-02 |
この例で故障中の扱いが決まっていない間は、それが影響するREQ-02やREQ-04まで最終確定したとは扱いません。関連する未決IDを併記し、条件が解消した後に文章と確認ケースをそろえて見直します。表の文字をすべて埋めることと、合意に必要な材料がそろうことを区別してください。
書き終えたら、要件文だけを別の人に読んでもらい、条件・対象・結果を指してもらいます。「これ」「適宜」「必要に応じて」の指す先が一致しなければ、名詞や条件へ置き換えます。文章を短くすることだけを優先して、重要な前提まで落とさないでください。本文と根拠欄の役割を分けると、読みやすさと説明の厚みを両立できます。
機能だけでなくデータ・利用条件・運用も確認する

入力項目は、意味と状態を一緒に定義する
貸出記録の機能が書けても、何を保存するのかが曖昧なら動作を確かめられません。データの一覧には、項目名、意味、必須か任意か、値の形式、値を決める元、更新できる人を置きます。たとえば返却予定日は業務で必要な日付ですが、実際の返却日時は返却した結果の記録です。似た名前でも意味が違うため、一つの欄で代用しないようにします。
架空例の貸出データは、貸出ID、備品ID、借り手の識別情報、貸出日時、返却予定日、返却日時で考えます。借り手の識別情報は、組織で使う番号など必要な範囲を確認し、個人の住所や私用の連絡先を便利そうだからと追加しないようにします。要件の説明や試験用サンプルには架空の値を使い、実データを無条件に複製する前提にしません。
空欄の意味も決めます。返却日時が空欄なら未返却と解釈する案がありますが、移行元の記入漏れまで未返却と扱うと誤ります。通常運用で生じた空欄と、移行時に意味が分からない空欄を区別する必要があります。分からない履歴は「未確認」として整理し、移行の判断が済むまで通常の状態計算へ含めない、といった扱いを業務側と決めます。
状態の変化と、許されない変化を確認する
状態の一覧だけでは、いつ変わるのか分かりません。貸出可能から貸出中へ変えるきっかけは、有効な貸出記録の作成です。貸出中から貸出可能へ戻すきっかけは、実物を確認した担当者による返却記録です。返却予定日を過ぎただけで自動的に貸出可能へ戻すと、実物が戻っていないのに貸せる扱いになるため、別の判断が必要です。
貸出中の備品へ同時に二人の担当者が新規記録を作ろうとした場合も、要件として結果を決めます。「一つの備品に有効な貸出が二つ成立しない」「成立しなかった操作に理由を示す」といった結果を置き、その実現方式の説明とは分けます。先に画面を開いた方が優先なのか、確定した順なのかなど、業務上の意味がある条件は未決のまま隠さないでください。
※表は横にスクロールできます。
| 点検区分 | 備品貸出一覧で確かめること | 文書に残すもの |
|---|---|---|
| 機能 | 貸出・返却・状態参照・訂正の対象と権限 | 要件ID、条件、結果、対象外 |
| データ | 備品ID、借り手、日時、空欄、重複、状態 | 項目定義と正しい例・誤った例 |
| 利用条件 | 使う端末、ブラウザー、通信、同時利用 | 確認済み環境と未確認環境の区別 |
| 品質条件 | 応答、データ量、誤操作、アクセス制限 | 測定条件、期待値、確認方法 |
| 運用 | 担当者の交代、訂正、問い合わせ、停止時 | 担当の役割と業務手順の参照先 |
| 保持・移行 | 履歴の保持方針、移行対象、欠落した履歴 | 判断者、対象期間、照合方法、未決事項 |
性能の数字は、測る条件と一組にする
「すぐに一覧を開ける」という希望へ、根拠なく秒数を当てはめないようにします。まず備品数、貸出履歴の量、同時に操作する人数、対象操作、確認に使う環境をそろえます。たとえば「架空データの備品二百件・貸出履歴二千件を使う」という試験条件案を書けますが、その件数を一般的な小規模オフィスの標準規模とは呼びません。
数値を置く書き方の例として、「合意した確認環境で、状態参照の操作開始から結果表示までを十回測り、十回すべてが二秒以内」を候補にすることはできます。ただし、二秒・十回は説明用の仮条件です。実際には業務上の必要性と実現可能性を確認して決めます。通信の状態、準備済みデータ、初回と連続実行の扱い、計測の開始・終了点も合わせて残さなければ、同じ数字で比較できません。
使いやすさも、利用者と課題を具体化できます。「代理担当が、説明資料を参照して、指定された備品の貸出先を確認できるか」を評価する案なら、誰に何を頼むかが分かります。全員にとって使いやすいという広い保証へ変えず、観察した迷いと未確認の利用条件を分けて記録します。画面の配置をここで細かく決めるのではなく、必要な行動と確認対象を明らかにします。
使い始めた後の担当と、止まったときの扱いを置く
運用では、誤った貸出先を記録したとき、担当者が交代したとき、一覧を使えないときに誰が判断するかを確認します。訂正を許すなら、訂正前の内容をどう扱うか、何の記録を残すかが要件へ影響します。単なる入力の自由度として扱うと、後から誰の記録を信頼するか分からなくなります。必要な履歴の範囲は、業務上の目的と管理方針に沿って決めます。
履歴の保持期間や削除方法は、テンプレートに書いてある値をそのまま採用せず、組織の方針と必要な確認を経て決めます。移行対象も、全履歴か現在貸出中の記録だけかで確認量が変わります。移行前の一覧と移行後の件数・識別番号を照合し、解消していない差分を誰が判断するかまで、要件に対応する確認事項として残してください。
この節の点検票は、機能以外の抜けを見つける入口です。すべてのセキュリティ対策、法令、運用品質を保証する一覧ではありません。扱う情報や業務の影響に応じて、管理担当や専門担当による確認が必要になります。その確認が済んでいない範囲を、文書の体裁が整っただけで合意済みにしないことが重要です。
確認方法を要件IDへ結び付けてレビューする

要件を書く段階で、確かめる材料まで考える
確認方法は、作り終わってから考えるより、要件を書いた時点で添える方が曖昧さを発見しやすくなります。REQ-01の状態参照なら、貸出可能の備品と貸出中の備品を一つずつ用意し、どちらも期待する状態を読めるかを確かめます。「一覧が開いた」だけでは、正しい状態が表示されたことの確認にはなりません。
NASAの付録D「Requirements Verification Matrix」は、要件を一意の識別番号、出典、検証の考え方へ結び付ける参考になります。本稿ではその図表を転載せず、備品貸出向けの自作の対応表へ置き換えています。小さな文書でも、要件IDから確認ケースへ行き、確認結果から元の要件へ戻れるようにしておくと、説明が途切れにくくなります。
確認ケースには、ケースID、対応する要件ID、開始時点のデータ、操作や確認の方法、期待結果、残す証拠を置きます。結果欄は実施前なら空欄か「未実施」とし、予定した期待結果を実測済みの結果と混ぜないようにします。誰が、どの版、どの環境で確かめたかを残す欄も用意すると、修正後の結果を過去の結果と取り違えにくくなります。
※表は横にスクロールできます。
| 確認ケース | 対応要件と開始条件 | 行う確認 | 期待する結果と証拠 |
|---|---|---|---|
| CASE-01:状態参照 | REQ-01。備品Aは貸出可能、備品Bは貸出中 | 担当者が各備品を指定して状態を参照 | 期待状態と一致し、貸出中の備品は借り手識別情報も一致。入力例と結果記録を残す |
| CASE-02:通常の貸出 | REQ-02・REQ-05。備品Aは貸出可能 | 必要な情報をそろえて貸出を確定 | 有効な貸出記録が一つ成立。記録IDと状態を照合 |
| CASE-03:二重貸出 | REQ-02。備品Bに有効な貸出記録がある | 同じ備品へ別の貸出を確定しようとする | 新規記録を拒否。既存の貸出が保たれる |
| CASE-04:返却 | REQ-03・REQ-04。貸出中の記録を指定 | 担当者が返却を確定する | 返却日時が記録され、状態が貸出可能となる |
| CASE-05:同時操作 | REQ-02。備品Aを二人が操作できる条件 | 合意した手順で同じ備品の貸出を同時に確定 | 有効な貸出は一つ。失敗側の案内と記録を確認 |
表のREQ-02は、貸出可能なら記録できることとの整合も含めて確認します。ただし、通常の貸出で保存する内容はREQ-05として別に管理します。例外だけが正しく拒否されても、必要な通常業務ができなければ目的を満たしません。反対に通常の成功例だけを試しても、既存記録を壊さず拒否できるとは限らないため、両側を用意します。
通常・境界・例外を、要件の意味から選ぶ
日付の前後関係を制限するなら、許される日、許されない日、ちょうど境界の日を並べます。「返却予定日は貸出日以後」というルールを採用した場合、貸出日と同じ日が許されるかを明確にします。「翌日以降」という言葉とは結果が違うため、例を一つ置くことで読み違いを見つけられます。ルールがまだ決まっていないなら、先にケースへ正解を書き込まないでください。
権限を分ける場合は、許可された担当者ができることだけでなく、許可されない立場から同じ操作を試した場合の期待結果も記載します。これは画面上で部品を隠すという配置の指定とは異なります。誰のどの操作が成立してよいかという要件を先に置き、必要な確認を管理担当とそろえます。ケース一覧だけで安全性が完全に証明されたと考えないようにします。
例外を増やす目的は、考えられる失敗を際限なく列挙することではありません。対象業務で起きる条件、誤った結果になった場合の影響、要件の判断を分ける境界を探します。試験の準備が難しい条件があれば、文書や記録の確認で足りるか、別の方法が必要かを相談します。確認できないままの要件を、確認方法欄の「テスト」で覆い隠さないことが大切です。
作ったとおりかと、業務で使えるかを分けて聞く
Microsoft LearnのAzure Boardsのユーザーストーリーと受入基準の解説は、誰のために何を達成するかを説明し、完了前に満たす条件を明確にする考え方の参考になります。製品内の入力欄を一般の要件定義書の必須様式とする必要はありません。文書や表計算でも、目的と期待結果が対応していれば同じ観点で確認できます。
レビューでは二つの問いを使います。一つ目は「この文章どおりの結果を確かめられるか」。二つ目は「その結果なら、困っていた業務を進められるか」です。状態が正しく表示されても、記録する担当が不在の時間帯に必要な業務が止まるなら、後者に課題が残ります。実装済みという状態と、利用目的に合っているという判断を別々に記録してください。
指摘は、対象の要件ID、問題、理由、求める確認に分けて残します。「分かりにくい」より「REQ-03の返却日時が実際の返却時刻か記録時刻か不明。記録が遅れた場合の扱いを業務責任者へ確認」と書けば、直す箇所が具体的です。指摘を修正したら、どの文章が変わったかと、再確認した結果を対応させます。説明を聞いて納得しただけで、文書が古いままにならないようにしましょう。
この確認表は、文書のレビューと完成物の確認を準備するためのものです。各ケースに合格が付いたことだけで、契約上の検収や支払条件が自動的に成立するとは扱いません。関係者が何の判断をしているのかを明記し、要件内容の合意、動作確認の結果、その他の手続きの記録を混同しないことが必要です。
合意した版と変更依頼を分けて管理する

合意版は、対象と残件が分かる状態で残す
レビューが終わったら、文書の版、対象範囲、確認した人、確認日、合意した項目、対象外、残っている未決を記録します。たとえば「備品貸出要件定義 v1.0」とし、どの要件IDを確定したかを一覧で示します。会議に出席した人を全員承認者とみなしたり、返答のない人を同意済みにしたりせず、実際に確認できた判断だけを残してください。
未決が残る場合は、その影響で進められない範囲を示します。故障中の状態追加が未決なら、故障の扱いを含む状態定義と関連確認は確定できません。一方、影響が切り離せる備品IDの定義などを確認済みとして記録することはできます。文書の表紙を「確定版」にしただけで、すべての行まで確定したように見せないようにします。
資料の場所も一本化します。正式に参照する版の置き場所、編集する次の案、以前の版を区別し、送付した添付ファイルだけが増え続ける状態を避けます。特別なツールを導入することより、関係者が同じ版を開けることと、変更前の内容を戻って読めることが重要です。内容の確認と、資料を閲覧できる権限の確認も分けて扱います。
追加要望は、まず変更依頼として受け止める
合意後に「返却予定日を過ぎた備品だけ見たい」という要望が出たら、すぐに本文を書き換えず、変更依頼へ記録します。例としてCHG-01とし、提案内容、必要になった理由、希望する時期、元の範囲との関係を記載します。要望を受け付けたことと、追加を決めたことは別です。受付時点の状態を「判断待ち」とすれば、作る約束をしたように読まれにくくなります。
Microsoft Learnの変更管理の解説でも、範囲と優先順位、明確な要件や受入基準、合意した変更の扱い、関係者との連絡が挙げられています。本稿の変更票はその考え方を小さな文書へ応用した独自例です。Azure DevOpsを使うことや、すべての変更を同じ重さの会議にかけることを前提にはしていません。
まず、既存要件の明確化か、結果を変える変更かを見分けます。誤字を直して意味が変わらない場合と、返却予定日の境界を「当日を含む」から「当日を含まない」へ変える場合は違います。後者は小さな文言変更でも結果と確認ケースが変わるため、関連IDへたどって影響を確認します。文字数の増減だけで軽微と判断しないことが大切です。
※表は横にスクロールできます。
| 変更影響票の欄 | CHG-01の架空記入例 | 判断前に確かめること |
|---|---|---|
| 依頼内容と理由 | 返却予定日を過ぎた、返却未記録の貸出を抽出したい | 担当者の確認業務で何が変わるか |
| 関連する要求 | 後回しにした自動通知とは別の一覧抽出案 | 通知を送る約束が混ざっていないか |
| 機能への影響 | 状態参照と貸出一覧へ抽出条件を追加する案 | 既存の参照要件と対象範囲 |
| データへの影響 | 返却予定日と返却日時を利用 | 空欄や未確認の移行記録をどう扱うか |
| 確認への影響 | 基準日の前日・当日・翌日、返却済みを確認 | 新ケースと、既存ケースの再確認範囲 |
| 予定への影響 | 条件整理、確認材料の準備、再レビューが増える | 必要な調査が済む前に確定日を置かない |
| 採否・反映先 | 判断待ち。採用後にv1.1案へ反映 | 判断者、判断日、理由、対象IDを記録 |
IDを起点に、機能・データ・確認・予定へたどる
変更の影響は、依頼された一行だけにとどまらないことがあります。返却予定日の扱いを変えるなら、入力できる値、抽出条件、既存データ、確認ケース、担当者向けの説明へつながります。要件一覧の関連ID欄と確認表を順にたどり、影響あり・影響なし・未調査を分けます。「影響なし」と記入するときも、何を見てそう判断したかを短く添えると確認しやすくなります。
とくに注意したいのは、一つの用語定義が複数の要件から参照されている場合です。「貸出可能」に故障状態の判定を加えるなら、表示の言い換えだけでは済みません。貸出記録の可否、状態参照、返却後の扱い、確認ケースに影響する可能性があります。用語表の変更も対象IDの一覧へ結び付け、文章を一か所直しただけで完了にしないでください。
予定への影響は、作る作業だけでなく、確認する人の回答、サンプルの準備、再レビューも含めて検討します。調査が必要な段階なら、その調査の結果として何を明らかにするかを記録します。まだ分からない作業量を、合意済みの納期へ無言で押し込まないことが大切です。採用する、次の版へ送る、見送るといった選択を、理由と一緒に判断者へ戻します。
変更前後の差分と、再確認した証拠を残す
変更が採用されたら、合意版を直接上書きするのではなく、次の案を作ります。変更ID、変更前の文章、変更後の文章、関連要件、確認ケースの追加や修正を対応させます。同じ意味の要件はIDを維持し、廃止したIDを別の意味で使い回さないようにします。要件を分割した場合は、元のIDから分割先を参照できる記録を残します。
再確認が終わったら、新しい版にどの変更依頼が含まれるかを示します。前の版で合格していた結果を、そのまま新しい版の合格へコピーしないでください。影響する確認をやり直したのか、影響がないと判断して結果を引き継いだのか、判断の根拠を区別します。未実施の確認が残るなら、実施担当と進める条件を残し、完了した項目へ混ぜないようにします。
最後に、要件一覧から一つのIDを選び、元の要望、採否の理由、前提、用語、確認ケース、変更履歴を順にたどってみてください。つながらない箇所があれば、そこが文書の改善点です。すべてを長文で説明するより、短い定義と一覧の参照が一致している方が、担当者の交代や追加要望にも対応しやすくなります。
要件定義の書き方で大切なのは、空欄のない書類を早く作ることだけではありません。必要な約束を、理由と条件が分かる形で選び、確認できる結果へ直し、変更したときも追えるようにすることです。まず目的と範囲の定義票を作り、一つの要望を要件IDと確認方法へつないでください。その一連の流れを確かめながら増やせば、小さなシステムでも、関係者が同じ内容を見て判断できる文書へ近づけます。