仕様書・コード・本番のどれを正しいとするか

業務基盤のcanonical文書は、現在採用している意味や契約を置く場所です。コードはその契約がどの経路へ実装されたかを示します。画面ごとに業務定義を複製しないという決定も、文書の採用と全画面への実装は別です。

Developer Hubは、AIの発言、変更、証拠、人の判断を分けて扱います。集約画面はそれらから作るもので、画面の要約を新しい根拠にしません。情報源が古くなれば、表示の確からしさも変わります。

問い合わせ基盤には、イベント駆動と補完処理を検討した記録と、後に定期取得を中心にする方式へ変えた記録があります。古い記録だけから「採用している構成」を書けば、過去の意図を現在へ持ち込んでしまいます。

現行仕様、置き換えた決定、実装を照合して現在の設計を説明します。さらに本番で動くと述べるには、配備と実行の証拠が必要です。repositoryの説明だけで最後の段階を埋めることはできません。

クラウドの公式設計指針は比較材料になりますが、機能が提供されていることは自社で有効になっている証拠ではありません。Terraformのplanも予定変更を確認する道具で、適用と実際の利用の証明とは異なります。

根拠の権威だけでなく、何を、いつ、どの環境で観測したかを見ます。PBGの現在の判断は、万能な一つの正本より、問いごとに根拠を定義し、不一致を追跡することです。