Architectural Decision Records または Architecture Decision Records(通称 ADR)を実践してみての備忘録諸々。 このスクラップ投稿時点では、既に実践してしばらく経った状態で、この備忘録はリアルタイムなメモではなく振り返りながら書いたもの。 ※ 参考文献: Design It! 目的や背景 Why にフォーカスしたドキュメントを残したい 設計判断の共有・分析のハードルを下げたい 現状のアーキテクチャに関するコンテキストを、その過程と結び付けて(第三者に)提供したい ADRとは何なのか? 「アーキテクチャ上の設計判断と意思決定の履歴を、テキストベースの軽量なテンプレートを使用して記録するもの」 享受できるメリット 設計判断をチームの責任において記録できる 重要な設計判断をリポジトリに保存することで、コードに近い場所に置いておける 他