Architecture Decision Record
← ドキュメント

ADR の使い始め方

ADR を使い始めるには、次の領域についてチームメイトと話し合ってください。

決定の特定:

  • AD はどれほど緊急で、どれほど重要ですか?

  • 今すぐ決める必要がありますか、それともより多くのことが分かるまで待てますか?

  • 個人的および集合的な経験、ならびに認知された設計手法やプラクティスは、決定の特定に役立ちます。

  • 理想的には、製品の ToDo リストを補完する決定の ToDo リストを維持します。

意思決定:

  • 一般的なものとソフトウェアアーキテクチャに特化したものの両方で、多くの意思決定手法が存在します。たとえば、ダイアログマッピングがあります。

  • グループ意思決定は活発な研究テーマです。

決定の実施と徹底:

  • AD はソフトウェア設計で使用されるため、システムに資金を提供し、開発し、運用するステークホルダーに伝達され、受け入れられなければなりません。

  • アーキテクチャ上明白なコーディングスタイルと、アーキテクチャ上の懸念と決定に焦点を当てたコードレビューは、関連する 2 つの実践です。

  • AD は、ソフトウェアの進化の中でソフトウェアシステムを近代化する際にも(再)検討されなければなりません。

決定の共有(任意):

  • 多くの AD はプロジェクト間で繰り返されます。

  • したがって、過去の決定に関する良い経験も悪い経験も、明示的な知識管理戦略を採用する際に、価値ある再利用可能な資産になり得ます。

決定の文書化:

  • 決定を記録するための多くのテンプレートとツールが存在します。

  • アジャイルコミュニティを参照してください。たとえば M. Nygard の ADR。

  • 従来のソフトウェアエンジニアリングやアーキテクチャ設計プロセスを参照してください。たとえば、IBM UMF や CapitalOne の Tyree と Akerman が提案するテーブルレイアウト。

詳細: