https://github.com/commonality/architecture-decision-records
䷁ Capture important architectural and design decisions—along with their context and consequences—for the benefit of future team members, as well as and external oversight.
https://github.com/commonality/architecture-decision-records
adr architecture-decision-records architecture-doc docs evolutionary-architecture
Last synced: 2 days ago
JSON representation
䷁ Capture important architectural and design decisions—along with their context and consequences—for the benefit of future team members, as well as and external oversight.
- Host: GitHub
- URL: https://github.com/commonality/architecture-decision-records
- Owner: commonality
- License: mit
- Created: 2017-12-18T03:47:12.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2018-09-21T18:03:50.000Z (over 7 years ago)
- Last Synced: 2025-09-01T03:50:47.410Z (6 months ago)
- Topics: adr, architecture-decision-records, architecture-doc, docs, evolutionary-architecture
- Homepage:
- Size: 435 KB
- Stars: 10
- Watchers: 1
- Forks: 3
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Architecture Decision Records (ADRs)
> 
A community-driven repository of Architecture Decision Records (ADRs): lightweight, actionable documents that capture design, framework, and application choices that address significant requirements and product delivery challenges facing commonality's product delivery teams.
---
## Propose an architecture decision
> 
We classify ADRs by [TechRadar ![External link][icon-octicon-link-external]][tw-tech-radar-faq-url] Quadrant.
- Propose a [Language or Framework ![External link][icon-octicon-link-external]][tw-tr-languages-frameworks]
- [MADR template][adr-madr-languages-frameworks]
- [Nygard template][adr-nygard-languages-frameworks]
- Propose a [Platform ![External link][icon-octicon-link-external]][tw-tr-platforms]
- [MADR template][adr-madr-platforms]
- [Nygard template][adr-nygard-platforms]
- Propose a [Technique ![External link][icon-octicon-link-external]][tw-tr-techniques]
- [MADR template][adr-madr-techniques]
- [Nygard template][adr-nygard-techniques]
- Propose a [Tool ![External link][icon-octicon-link-external]][tw-tr-tools]
- [MADR template][adr-madr-tools]
- [Nygard template][adr-nygard-tools]
---
[adr-madr-languages-frameworks]: https://github.com/commonality/architecture-decision-records/compare/adr-0001?expand=1&title=adr(languages-frameworks):%20add%20MADR%20template&template=adr_template_madr.md
[adr-madr-platforms]: https://github.com/commonality/architecture-decision-records/compare/adr-0001?expand=1&title=adr(platforms):%20add%20MADR%20template&template=adr_template_madr.md
[adr-madr-techniques]: https://github.com/commonality/architecture-decision-records/compare/adr-0001?expand=1&title=adr(techniques):%20add%20MADR%20template&template=adr_template_madr.md
[adr-madr-tools]: https://github.com/commonality/architecture-decision-records/compare/adr-0001?expand=1&title=adr(tools):%20add%20MADR%20template&template=adr_template_madr.md
[adr-nygard-languages-frameworks]: https://github.com/commonality/architecture-decision-records/compare/adr-0001?expand=1&title=adr(languages-frameworks):%20add%20MADR%20template&template=adr-nygard-template.md
[adr-nygard-platforms]: https://github.com/commonality/architecture-decision-records/compare/adr-0001?expand=1&title=adr(platforms):%20add%20MADR%20template&template=adr-nygard-template.md
[adr-nygard-techniques]: https://github.com/commonality/architecture-decision-records/compare/adr-0001?expand=1&title=adr(techniques):%20add%20MADR%20template&template=adr-nygard-template.md
[adr-nygard-tools]: https://github.com/commonality/architecture-decision-records/compare/adr-0001?expand=1&title=adr(tools):%20add%20MADR%20template&template=adr-nygard-template.md
[icon-octicon-link-external]: https://cdnjs.cloudflare.com/ajax/libs/octicons/4.4.0/svg/link-external.svg
[icon-octicon-file-text]: https://cdnjs.cloudflare.com/ajax/libs/octicons/4.4.0/svg/file-text.svg
[icon-octicon-info]: https://cdnjs.cloudflare.com/ajax/libs/octicons/4.4.0/svg/info.svg
[icon-octicon-repo]: https://cdnjs.cloudflare.com/ajax/libs/octicons/4.4.0/svg/info.svg
[label-langs-frameworks-img]: https://fakeimg.pl/200x40/b32059/FFF/?text=Languages+%26+Frameworks&font_size=24
[label-tech-radar-langs-frameworks-img]: https://fakeimg.pl/200x80/b32059/FFF/?text=TechRadar:%0ALanguages+%26+Frameworks&font_size=24
[label-tech-radar-langs-frameworks-adopt-img]: https://fakeimg.pl/80x40/b32059/FFF/?text=Adopt&font_size=18
[label-tech-radar-langs-frameworks-trial-img]: https://fakeimg.pl/80x40/b32059/FFF/?text=Trial&font_size=18
[label-tech-radar-langs-frameworks-assess-img]: https://fakeimg.pl/80x40/b32059/FFF/?text=Assess&font_size=18
[label-tech-radar-langs-frameworks-hold-img]: https://fakeimg.pl/80x40/b32059/FFF/?text=Hold&font_size=18
[label-platforms-img]: https://fakeimg.pl/200x40/f38a3e/FFF/?text=Platforms&font_size=24
[label-tech-radar-platforms-img]: https://fakeimg.pl/200x80/f38a3e/FFF/?text=TechRadar:+Platforms&font_size=24
[label-tech-radar-platforms-adopt-img]: https://fakeimg.pl/80x40/f38a3e/FFF/?text=Adopt&font_size=18
[label-tech-radar-platforms-trial-img]: https://fakeimg.pl/80x40/f38a3e/FFF/?text=Trial&font_size=18
[label-tech-radar-platforms-assess-img]: https://fakeimg.pl/80x40/f38a3e/FFF/?text=Assess&font_size=18
[label-tech-radar-platforms-hold-img]: https://fakeimg.pl/80x40/f38a3e/FFF/?text=Hold&font_size=18
[label-techniques-img]: https://fakeimg.pl/200x40/1ebccd/FFF/?text=Techniques&font_size=24
[label-tech-radar-techniques-img]: https://fakeimg.pl/200x80/1ebccd/FFF/?text=TechRadar:+Techniques&font_size=24
[label-tech-radar-techniques-adopt-img]: https://fakeimg.pl/80x40/1ebccd/FFF/?text=Adopt&font_size=18
[label-tech-radar-techniques-trial-img]: https://fakeimg.pl/80x40/1ebccd/FFF/?text=Trial&font_size=18
[label-tech-radar-techniques-assess-img]: https://fakeimg.pl/80x40/1ebccd/FFF/?text=Assess&font_size=18
[label-tech-radar-techniques-hold-img]: https://fakeimg.pl/80x40/1ebccd/FFF/?text=Hold&font_size=18
[label-tools-img]: https://fakeimg.pl/200x40/86b782/FFF/?text=Tools&font_size=24
[label-tech-radar-tools-img]: https://fakeimg.pl/200x80/86b782/FFF/?text=TechRadar:+Tools&font_size=24
[label-tech-radar-tools-adopt-img]: https://fakeimg.pl/80x40/86b782/FFF/?text=Adopt&font_size=18
[label-tech-radar-tools-trial-img]: https://fakeimg.pl/80x40/86b782/FFF/?text=Trial&font_size=18
[label-tech-radar-tools-assess-img]: https://fakeimg.pl/80x40/86b782/FFF/?text=Assess&font_size=18
[label-tech-radar-tools-hold-img]: https://fakeimg.pl/80x40/86b782/FFF/?text=Hold&font_size=18
[icon-octicon-question]: https://cdnjs.cloudflare.com/ajax/libs/octicons/4.4.0/svg/question.svg
[tw-tr-languages-frameworks]: https://thoughtworks.com/radar/languages-and-frameworks
[tw-tr-platforms]: https://thoughtworks.com/radar/platforms
[tw-tr-techniques]: https://thoughtworks.com/radar/techniques
[tw-tr-tools]: https://thoughtworks.com/radar/tools
[tw-tech-radar-faq-url]: https://www.thoughtworks.com/radar/a-z