選択の理由を残す
録音した設計会議からアーキテクチャ決定記録(ADR)を作る
ADRには重要なアーキテクチャ上の決定を一つ記録します。背景、比較した案、選んだ案、影響、状態を残します。文字起こしは議論の根拠をたどるために使い、技術的な正確さは参加者が確認します。
実際の録音を使う学習用の具体例コピー用テンプレート
選択の理由を残す
録音した議論からArchitecture Decision Recordを作る方法
ADRには重要なアーキテクチャ上の決定を一つ記録します。背景、比較した案、選んだ案、影響、状態を残します。文字起こしは議論の根拠をたどるために使い、技術的な正確さは参加者が確認します。
文字起こしがあれば発言を確認できます。文脈、条件付きの発言、議論の流れを残せるためです。最終的な文言は作成者が決め、参加者に確認してもらいます。
手順
手順に沿ってADRを書く
決定を一つ選ぶ
独立したアーキテクチャ上の決定は別々に記録します。
背景を説明する
判断が必要になった要因と制約を書きます。
選択肢を比較する
案ごとに主な利点、欠点、見送った理由を残します。
影響を明記する
利点、費用、新たな制約、リスク、見直しの条件を挙げます。
具体例で確認
学習例:音声ファイルの保存方式を選ぶ
以下は架空の学習用事例です。名称、条件、結果は手順を説明するためのものです。
学習用録音の抜粋 · 12:40
「アーカイブにはオブジェクトストレージの方が安いですが、一時リンクを発行する仕組みが別途必要です。」
背景は、録音ファイルが大きく、アクセスには有効期限が必要で、リンクの発行を管理したいことです。オブジェクトストレージを選びました。費用だけでなく、拡張性とアクセス方式も判断に影響します。
必要な作業とリスクを記載します。一時リンク、有効期限の管理、ログの記録、障害時のテストです。費用の前提が変われば、履歴を残したまま新しいADRに置き換えられます。
| 項目 | 判断に役立つ記録 | 避けたい例 |
|---|---|---|
| 背景 | 大きなファイルと限られたアクセス | 新しいストレージが必要 |
| 選択肢 | オブジェクト/ファイルストレージ | 一番よい案を選んだ |
| 決定 | AとBの理由でオブジェクトストレージ | 設計担当者が決めた |
| 影響 | 一時リンクと監視 | 欠点はない |
そのまま使えるひな形
ADRのひな型
ひな型をコピーし、具体的な録音に基づいて記入します。推測は仮説として記録します。
作業用テンプレート選択してコピー
タイトルと状態: 日付と参加者: 背景と制約: 検討した案: 決定と理由: 影響、リスク、見直しの条件:
結果の確認
送付前の四つの確認
- 一つの決定を記録している。
- 実際の制約を背景に示している。
- 代替案と見送った理由を残している。
- 欠点と見直しの条件がある。
よくある質問
詳しく見てみましょう
承認済みのADRは編集できますか?
誤字は直せます。判断そのものが変わったら、新しいADRを作って以前の記録にリンクします。
文字起こしを一緒に保存する必要はありますか?
社内資料へのリンクとタイムコードがあれば、通常は見解が分かれる発言を確認できます。
録音をさらに活用する