Architecture Decision Record

Architecture Decision Record（ADR）は、重要な技術的意思決定を短く記録する文書です。何を決めたか、なぜ決めたか、どんな選択肢を検討したか、どんな影響があるかを残します。

システムが成長すると、なぜその技術や設計を選んだのかが忘れられます。背景を知らない人には、不自然な制約や古い判断に見えるかもしれません。

含める項目

  • タイトル
  • 状態
  • 背景
  • 決定
  • 検討した選択肢
  • 影響

ADR は長い設計書ではありません。将来のチームが判断の文脈を理解できる程度に、簡潔に残すことが重要です。

意思決定の記録があると、前提が変わったときに見直しやすくなります。