Skip to content

090-決定記録(ADR)

重要な設計・技術選択についての意思決定をADR(Architecture Decision Record)形式で記録します。

ドキュメントの目的

  • システム設計・技術選択に関する重要な意思決定の根拠・経緯・結果を明確化し、関係者間の認識合わせ・再検討時の参考とする。
  • 設計・開発・運用の品質向上、トラブル防止の根拠とする。

ドキュメントの内容

ドキュメントには、少なくとも以下を含めます。

  • ADR(意思決定記録)の概要
  • 記録方法・記載例
  • サンプル(小売業務システム例)

なぜこのドキュメントが必要か

  • 重要な意思決定の根拠・経緯・結果を明確にすることで、設計・開発・運用の品質・効率を高める。
  • 再検討・トラブル時の迅速な対応を可能にする。

このドキュメントがないとどう困るか

  • 意思決定の根拠・経緯・結果が曖昧になり、設計・開発・運用で誤解や手戻りが発生する。
  • 再検討・トラブル時の対応が遅れる。

サンプル

ADR記録例(小売業務システム/表形式)

ADR番号決定日決定内容選択理由影響範囲備考
ADR-0012025/10/01DBはPostgreSQLを採用コスト・拡張性全システム既存MySQLから移行
ADR-0022025/10/05フロントはReactを採用UI拡張性・開発効率店舗業務画面Vue案と比較
ADR-0032025/10/10API認証はJWT方式セキュリティ・標準全API既存セッション方式廃止
ADR-0042025/10/15バッチ処理はNode.js開発体制・実行速度売上集計バッチPython案と比較

注:上記は例です。実プロジェクトのADR記録を具体的に記載してください。