設計ドキュメントは仮実装のcommit値を「現状」として書かず、実測を設計入力に採用案・根拠・未確定事項を書く
設計
ドキュメント
意思決定
運用
原則
仮実装のブランチがある状態で設計ドキュメントを書くとき、commit 上の暫定値(例: メモリ設定、暫定 cron 間隔)を「現状の仕様」として記述すると、暫定値が将来の前提として固定化してしまう。設計段階の書き方は、暫定 commit 値を正とする表現・差分表現(「Aから Bへ変更」)を排し、本番実測を設計入力として「採用案・判断根拠・未確定事項」を書く(「Bを採用する設計根拠」)。現行運用の実績(既存版の実測)は設計入力として明確に分離し、確定前の値は「負荷試験後に確定する構成案」として保留事項に明記する。