Resources

ADR Background

• Architectural Decision Records - The official ADR homepage
• Documenting Architecture Decisions - Michael Nygard's original blog post
• MADR - Markdown Architectural Decision Records

Tools

• adr-tools - The original bash-based ADR tool
• adrs - This project (Rust rewrite)
• adr-log - Generate an ADR log from MADR files
• pyadr - Python ADR tool

Articles

• When Should I Write an Architecture Decision Record - Spotify Engineering
• ADR Process - AWS Prescriptive Guidance
• Architecture Decision Records - ThoughtWorks Technology Radar

Templates

• MADR Templates - Official MADR templates
• ADR Templates - Collection of ADR templates

Books

• Documenting Software Architectures - Clements et al.
• Design It! - Michael Keeling