FACTUAL ACTIVITY RECORD · 実際の作業をもとにした活動記録
実装handoffを四つの正本への参照契約にする
ページ内容の複製をやめ、参照先・停止条件・整合性確認だけを一つの文書へ残す
目的
サイトのページ別入力が新しい正本へ整理されても、実装handoffが以前のwordingや一ページだけの準備状態を保持したままでは、実装時に古い情報や異なる公開境界を引き継ぐおそれがあった。三つのページと共通要素が、どの入力を参照するかを一意にする必要があった。
同時に、handoffへ正本の内容を詳しく書き写すと、同じ情報を二重管理することになる。目的は、design-to-implementation引き渡しを第二のcontent masterにせず、実装面と正本を結ぶ小さな参照契約へ作り直すことだった。
実装
design-to-implementation引き渡しの旧構成を削り、四つのimplementation surfaceとcanonical sourceの対応を表にした。/はHome入力、/privacyはPrivacy入力、/termsはTerms入力、全ページ共通要素は共通入力を参照する。ページ固有情報と共通情報の取得元が重ならない構成にした。
- 実装開始時に、指定されたversionと四つのcanonical sourceを直接確認する。
- ページ固有情報は対応するpage sourceから、共通情報は共通入力だけから取得する。
- Canonical sourceの文言や意味をhandoff側で要約、言い換え、補完、再定義しない。
- Source内の管理情報を公開copyとして扱わず、掲載対象との区別はsourceの指示に従う。
- 既存artifact、sample、過去のhandoffから掲載内容や公開可否を推測しない。
- Source間や要求との不一致・曖昧さがあれば実装を止め、ownerへ戻す。
- Sourceにないdesign、技術、legal、公開判断が必要なら、対応するownerの確認を別のgateとする。
変更と検証の責務も分けた。Canonical sourceを変える場合はsource側で更新し、確認済みversionを改めて指定する。実装を変える場合はその作業内でcanonical sourceとの一致を確かめる。Content consistencyの証拠には、使用したversion、source path、差分結果を使い、同じ内容をhandoffへ再掲してmaster化しない規則を置いた。
最初の更新では、各ページの構造や公開境界までhandoffへ再記述し、175行になっていた。CEOの指摘で二重管理のriskを確認し、個別内容を削ってmapping、consumption contract、変更・検証規則、scopeだけの49行へ縮小した。古い共通file名への説明も削り、現行の四つの参照先だけを残した。
確認は、最終差分がdesign-to-implementation引き渡し一つだけであること、四つのsource pathがあること、canonical contentの複製が残っていないこと、空白差分検査が成功することを対象にした。UI、layout、interaction、runtimeは変更していないため、accessibility、responsive behavior、stateの検証はN/Aとした。Pencil designも不要とし、.pen、export、ほかのdesign artifact、site implementationと公開状態は変更・検証の範囲から外した。
図を描画しています…
確認したこと
確認結果
三つのrouteと全ページ共通要素は、それぞれHome入力、Privacy入力、Terms入力、共通入力へ一対一で対応した。
Handoffは175行から49行へ縮小され、ページ内容や公開境界の個別な複製ではなく、参照先と利用契約だけを保持する形になった。
最終差分は一つのMarkdown文書だけで44 insertions / 118 deletionsとなり、四つの参照先、停止条件、変更・検証規則を確認できた。空白差分検査も成功した。
最初の案にあった二重管理riskはCEOの指摘後に修正され、canonical contentの複製は最終版から除かれた。
cutoff時点で新しいhandoffはcurrent sourceへ反映されていた。UI、Pencil artifact、accessibility、responsive behavior、runtime、site implementation、公開環境の状態はこのActivityでは変更も検証もしていない。
完了とした根拠
四つのimplementation surfaceとcanonical sourceの対応が一意になり、直接参照、複製禁止、不一致時の停止、変更と整合性確認の規則が49行のhandoffへ収まり、対象外のUI・Pencil・runtime・公開状態を成功として扱わない境界まで確認できたことをもって完了とした。