architecture-decision-record /architecture-decision-record
Architecture decision record (ADR) examples for software planning, IT leadership, and template documentation
★ 17,465⑂ 2,822👁 247⑃ 100● 31▤ 0
+0
日增长
17,465
stars
2,822
forks
247
watchers
100
prs
31
issues
0
releases
README
Architecture decision record (ADR) An architecture decision record (ADR) is a document that captures an important architecture decision made along with its context and consequences. [!IMPORTANT] Do your own due dilligence for these resources before using them in any critical systems. Website: architecture-decision-record.github.io — this README, plus every template and example, as a browsable site. Translations: العربية, বাংলা, Cymraeg, Dansk, Deutsch, English, Lietuvių, Gaeilge, Lëtzebuergesch, Norsk bokmål, ລາວ, ខ្មែរ, Gàidhlig, తెలుగు, தமிழ், मराठी, Hausa, ગુજરાતી, Euskara, भोजपुरी, Basa Jawa, فارسی, ਪੰਜਾਬੀ, Bahasa Melayu, ಕನ್ನಡ, Filipino, Naijá, 粵語, 吴语, kernewek, Scots, Malti, Latviešu, Slovenščina, Slovenčina, Hrvatski, Български, Čeština, Magyar, Ελληνικά, Română, Polski, Español, Eesti, Suomi, Français, עברית, हिन्दी, Bahasa Indonesia, Íslenska, Italiano, 日本語, 한국어, Nederlands, Português, Русский, Svenska, Kiswahili, ไทย, Türkçe, Українська, اردو, Tiếng Việt, 中文 Contents: - What is an architecture decision record? - How to start using ADRs - How to start using ADRs with tools - How to start using ADRs with git - Claude Code skills for ADRs - File name conventions for ADRs - Suggestions for writing good ADRs - ADR example templates - Teamwork advice for ADRs - Teamwork questions for ADRs - Next step concepts for ADRs - Architecture diagrams \& views \& viewpoints - Fitness functions for decisions as code - Decision guardrails for pull requests - For more information Templates: - Decision record template by Jeff Tyree and Art Akerman - Decision record template by Michael Nygard - Decision record template by EdgeX - Decision record template by arc42 - Decision record template for Alexandrian pattern - Decision record template for business case - Decision record template of the MADR project - Decision record template using Planguage - Decision record template by Paulo Merson - Decision record template by Olaf Zimmermann - Decision record template by Gareth Morgan - Decision record template by GIG Cymru NHS Wales - Decision record template for Important Technical Decisions (ITDs) by Ignacio Larrañaga - Translations into more languages Examples: - CSS framework - Environment variable configuration - Metrics, monitors, alerts - Microsoft Azure DevOps - Monorepo vs multirepo - Programming languages - Secrets storage - Timestamp format - Many more... Translations into more languages What is an architecture decision record? An architecture decision record (ADR) is a document that captures an important architectural decision made along with its context and consequences. An architecture decision (AD) is a software design choice that addresses a significant requirement. An architecture decision log (ADL) is the collection of all ADRs created and maintained for a particular project (or organization). An architecturally-significant requirement (ASR) is a requirement that has a measurable effect on a software system’s architecture. Al
Top issues
#112Proposal: Brazilian Portuguese translation (pt-BR)6 comments · 2026-08-07#103Suggestion for Arabic translation2 comments · 2026-05-06#51First ADR should always be about why we introduce ADRs in a project!2 comments · 2021-09-09#123MADR minimal1 comments · 2026-09-23#139Integration with BTABoK0 comments · 2026-11-13#120Proposal: Spanish translation (es)0 comments · 2026-09-19