数か月後に「なぜこのDBを選んだのか」が分からないと、過去の制約を知らずに変更する危険があります。
短い記録の型
題名: 画像保存先にオブジェクトストレージを使う
状態: 採用
背景: アプリサーバーの再配置でローカル画像が消える
制約: 月額予算、公開URL、バックアップ
候補: ローカルディスク / DB / オブジェクトストレージ
決定: オブジェクトストレージ
理由: 容量と配信をアプリから分離できる
結果: 設定と障害点は増える
見直し条件: 月間転送量が予算を超える時
会議録との違い
発言を全部残すのではなく、後の変更判断に必要な背景と結果を残します。
決定は変更できる
記録は永久ルールではありません。前提が変わったら新しい記録で置き換え、過去の理由も残します。