ADRを運用している話 - サーバーワークスエンジニアブログ

はじめに 前提 ADRとは？ - 意思決定とその記録 Design Docsとの差分 Design Docsとは？ 経緯 FYI いつ書く？ ADR運用の前提条件 ステークホルダー コスト要件 導入対象の要件 確認・調査工数 フォーマット 意識していること 言語化とすり合わせ ？やTBD、会話の引用を活用する ドキュメントの読み手を意識する メリットとデメリット メリット 基本設計書や概念ドキュメントのベースとなる 後々の変更や運用において安全で迅速な対応が可能 デメリット とにかく時間がかかる なくてはならないもの？ ADR Design Docs 注意点 万能ではない 方針迷子に注意 プロジェクトに根付かせるポイント フォーマットを決める 書き手の意識 ステークホルダーへメリットを実感してもらう このブログもADRを根付かせる活動 最後に はじめに 本ブログでは、私が運用しているArc