ADRテンプレ(意思決定記録)

メタ情報

  • 日付:
  • ステータス: 提案 / 採用 / 廃止
  • Owner:

背景

  • なぜ決める必要があるか(現状/課題/制約)

論点

  • 何を決めるか(決めないことは書かない)

選択肢

  • A:
  • B:
  • C:

決定

  • 採用案:
  • 理由:

影響

  • 期待する効果:
  • リスク/デメリット:
  • 運用影響(監視/手順/教育):

移行/ロールバック

  • 移行手順:
  • ロールバック手順:
  • ロールバック判断基準:

関連

  • Issue:
  • PR:
  • 参考(一次情報/調査ログ):

記入例(抜粋)

  • 日付: YYYY-MM-DD(例)
  • ステータス: 採用
  • Owner: @team-frontend(例)
  • 背景: 入力フォームの誤操作が多く問い合わせが増加(誤操作率 5%)
  • 論点: バリデーションを「フロントのみ/サーバのみ/両方」のどれで実装するか
  • 選択肢:
    • A=フロントのみ(UXは良いが不正入力に弱い)
    • B=サーバのみ(安全だがUXが悪化しやすい)
    • C=両方(安全とUXの両立)
  • 決定: C(フロントで即時フィードバック、サーバで最終防御)
  • 影響: 実装箇所が増えるが、誤操作率を 5%→1% 以下に低減できる見込み
  • 移行: feature flag で段階リリースし、ログで弾かれた入力パターンを収集
  • ロールバック: flag をOFF、サーバ側は後方互換のまま維持
  • 関連: Issue #123 / PR #456(例)