第7章ADRの扱い ── 台帳を守る

台帳を守る

ADRは、プロジェクトが進むにつれて何十、何百と溜まっていきます。1本ずつ書いただけでは、やがて次のことが分からなくなります。

• 自分がいま書いている成果物に、どのADRが影響するのか。
• 同じことを決めたADRが2本あるとき、どちらが今も生きているのか。
• 成果物が指しているADRや、ADRが指している成果物が、まだ実在するのか。

ADRの束を、こうしたことに答えられる状態に保つ必要があります。

状態と属性を残す

台帳として並べ、探し、つなぐには、決定の中身とは別に、ADRについての情報が要ります。

それぞれ、次のことを表します。

• 状態：いまどの段階にあるか（仮決定／承認済み／発展済み／廃止）。
• 発生工程：その決定がどの工程で生まれたか（要件定義・外部設計など）。
• 発生箇所：その決定がどこで生まれたか（どの業務・サブシステムで決めたか）。
• 確定者：誰が確定したか。
• 置換リンク：置き換えた元のADR、置き換えた先のADR。
• 前提とする決定：その決定が前提として置いている、別のADR。前提のADRが置き換わったときに、影響を受けるADRを拾うために使います。

発生箇所と影響範囲は、別のものです。X業務で生まれた決定が、Y業務の成果物にも影響することはあります。影響する相手は、制約節の影響範囲に書きます。

たとえば ADR-0231 なら、ステータス節に書く代わりに、ファイルの先頭に次のように持ちます。

---
id: ADR-0231
状態: 仮決定
発生工程: 要件定義
発生箇所: 販売業務
確定者: 発注者側の販売業務責任者
置換元: なし
置換先: なし
前提とする決定: なし
---
# ADR-0231：送料無料の閾値は、業務部門が自分で切り替える

影響範囲はヘッダに写しません。制約節の各行（「販売業務の要求事項：…」）から読みます。

ヘッダに整理しておくと、次のような索引が作りやすくなります。

影響範囲                      影響するADR
横断                          ADR-0007
販売業務の要求事項            ADR-0231
販売業務の業務の定義          ADR-0231, ADR-0205
販売業務のユースケース        ADR-0231

ADRの一生

ADRに書くのは、決まったことだけです。まだ決まっていないことは、未決型ISSUEに置きます。

書いたばかりのADRは、仮決定です。「仮」とありますが、決定そのものはもう済んでいます。仮なのは記録のほうで、決定を正しく書き写せているか、制約節が検査に使える形になっているかを、まだ磨いている段階です。記録が決定を正しく写していると確かめられたら、承認済みになります。

仮決定でも、決定そのものは済んでいます。だから、承認を待つあいだに検査の空白を作らずに済みます。状態を添えておけば、指摘を受けた人は、根拠の決定がどこまで固まっているかを知ったうえで直せます。

決定そのものが、プロジェクトのルールや標準の方針として取り込まれることもあります。たとえば、「マスタを改定しても、確定済みの伝票は改定前の値のまま表示する」という決定が、受注で決めた後、請求・発注・出荷など伝票を持つ業務に広がり、プロジェクト共通のルールに書き込まれる、といった場合です。このときADRは消さずに、発展済みにします。

決定した内容を変更するときは、ADRを書き換えずに置き換えます。

複数の決定を1つのADRにまとめると、成果物との整合が取りづらくなるので、1決定1ADRを原則とします。追記を認めると、1つのADRの中に古い内容と新しい内容が混ざり、どの時点の内容で成果物を確かめればよいのかが分からなくなります。だから追記はせず、置き換えます。

成果物との整合を保つ

ADRの制約節は、影響範囲で成果物を示しています。ADRどうしも、置き換えや前提でつながっています。ADRが置き換わったり、成果物が消えたり名前が変わったりすると、指した先がなくなることがあります。そこで節目に、AIなどを使って、つながりが切れていないかを確かめます。見るのは次の3つです。

• 制約節に書いた影響範囲が、プロジェクトの文書に実在するか。「横断」は正しい値として扱います。
• 成果物の未決の印にあるISSUEのIDが実在し、開いているか。閉じたISSUEの印が残っていたら、成果物への反映が済んでいない合図です。
• ADRの前提とする決定が、廃止になっていないか。廃止になっていたら、そのADRを置き換えるか、そのまま残すかを人が決めます。

成果物に注記を付けているなら、注記のADRのIDが実在するか、別の工程のADRを指していないかも、あわせて見ます。

このうち、影響範囲の実在だけは、漏らさずに見ます。

影響範囲だけを厳しく見るのは、ADRと成果物のつながりの正本が、制約節の影響範囲だからです。ここが切れていると、【確かめる】はその決定を当てる相手を見失います。

前の工程の成果物を名指す決定

前の工程の成果物を名指すのは、ADRの章の規範（影響範囲に書けるのは、決めた工程の成果物だけ）から外れた書き方です。ただ、外れたこと自体が、前の工程で決めるべきことが決まっていなかったという合図になります。書き直させて消してしまうと、その合図も消えます。そこで弾かずに残し、名指された前の工程の成果物を直すときは、変更として扱います（変更管理の章）。

ADRの発生工程と、制約節が名指す成果物の工程を突き合わせれば、こうした決定はAIなどで拾えます。台帳が、シフトレフトの効き具合を映します。