使う場面

データベース、フレームワーク、ホスティング方式、APIの形式など、後から変更しにくい技術的な選択をしたときにADRを書きます。将来の担当者や新しいメンバー、レビュアーはこれを読み、当時どんな制約があったのかを理解します。議論の記憶が新しいうちに書き、提案が進むにつれて状態の行を更新しておきましょう。

含まれる内容

• プロジェクト名、作成者、日付を入力する欄と状態の行を含む、番号付きのADRタイトル。
• 現状維持の行も含めて、利点と費用を比較する選択肢の表。
• 決定事項、良い影響と悪い影響、実施のチェックリスト、見直しの契機。

より良い文書にするヒント

• 決定事項を一文で述べ、最も強い理由をひとつ挙げましょう。理由が5つ必要になる場合、背景の項目がまだ足りていない可能性があります。
• 悪い影響については率直に書きましょう。図で説明したほうが伝わる変更があれば、Mermaidのブロックを追加すればPDFにもそのまま表示されます。