誰が ADR を作成できますか?

特定の人、特定の役割、特定のチーム、特定の部門などの領域を検討してください。また、ADR を委託できる人、役割、チーム、部門がいるかどうかも検討してください。つまり、他の誰かが執筆する ADR を依頼できる場合です。

回答例: アーキテクチャ決定記録の README ページを読んだ組織内の誰もが ADR を提案できます。つまり、その人は ADR の執筆を開始し、チームと共有できます。

ADR を起こすことを正当化するものは何ですか?

組織のチームの仕事の進め方、ソフトウェアシステムの構造、チーム間の調整、長期的な保守性、外部インターフェース、誰に利益をもたらしたいか、といった領域を検討してください。

回答例: 私たちは、将来の開発者に自分たちが行っていることの「なぜ」を理解してもらいたいときに、ADR を作成したいと考えます。

ADR を起こさないことを正当化するものは何ですか?

アーキテクチャに関するものではない決定、リスクが最小限であったり、自己完結していたり、1 人の開発者に限られるなど些細な決定、標準、ポリシー、文書などで既に完全にカバーされている決定、あるいは回避策、概念実証、実験などの一時的な決定といった領域を検討してください。

回答例: 私たちは、決定が範囲、時間、リスク、コストの面で限定的な場合、または既に他の場所でカバーされている場合は、ADR を省略したいと考えます。

ADR のライフサイクルとは何ですか?

作成プロセス、調査プロセス、意思決定プロセス、実装プロセス、廃止プロセスといった領域を検討してください。ADR のライフサイクルを時間とともにどのように追跡するか、たとえば ADR をある状態から次の状態へどのように移行させるか、またこれをステークホルダーにどのように伝えるかを検討してください。

回答例: 私たちは、ADR に 5 つのライフサイクル段階を持たせたいと考えます: 開始(Initiating) → 調査(Researching) → 評価(Evaluating) → 実装(Implementing) → 維持(Maintaining) → 廃止(Sunsetting)。

ADR のライフサイクルの各ステップの基準は何ですか?

ADR の受け入れ基準といった領域を検討してください。つまり、ある ADR がライフサイクルの次のステップに進むのに十分良いとどうやって判断しますか? 問題は明確に述べられていますか? 代替案は検討されましたか? トレードオフは十分に理解され文書化されていますか? 関連するすべてのコンテキストが揃っていますか? 関連するすべてのステークホルダーが関与していますか? すべてのフィードバックが取り込まれましたか?

回答例: 私たちは、アクティブなチームが 1) 調査を完了し、2) 評価を完了し、3) コメント依頼と 1 週間の期限を付けて ADR 提案をステークホルダーに公開し、4) すべてのステークホルダーのコメントが取り込まれ対処された時点で、ステークホルダーが ADR について投票することを望みます。

どのような役割と責任が ADR と関わりますか?

提案者、調査者、評価者、レビュー担当者、承認者、保守担当者などの役割を検討してください。ステークホルダーとのコミュニケーション、期待が満たされていることの確認、ウェブサイトやイントラネットでの共有、作業の定期的な、特に関連する変更が起きたときのレビューなどの責任を検討してください。

回答例: 私たちは、各 ADR に常に、主担当者、副担当者、および責任チームを置きたいと考えます。これらは、コミュニケーション、公開、保守、少なくとも年に一度の定期レビュー、および必要に応じた最終的な廃止に責任を負います。

ガバナンスは ADR とどのように関わりますか?

組織の仕事の進め方、法務面や人事面などの特別なコンプライアンス上のニーズ、合意対対立対エスカレーションをどのように扱いたいか、といった領域を検討してください。ADR について、承認する、投票する、拒否権を行使するなど、他よりも大きな影響力を持てる領域や人やチームはありますか?

回答例: ADR のガバナンスは次の優先順位です: CEO、CTO、CLO、ADR を実装するチーム、その ADR について最も知識の豊富なチーム内の専門家。ADR に記載されていない限り、他の誰もガバナンスを持ちません。

どのような原則が ADR と関わりますか?

素早く動くか、ゆっくり動くか、決定の合意か決定の対立か、リスクの選好か安全の選好か、公開の議論か非公開の議論か、といった組織の仕事の進め方を含む領域を検討してください。

回答例: 私たちは、行動への偏重、反対しつつもコミットする(disagree-and-commit)、容易に元に戻せて容易に切り離せる決定には 70% の見積もりで十分、そして組織の機密保持契約に記載された機密情報を除く公開での仕事の進め方、というリーダーシップ原則を使用します。