#113 - Architecture Decision Record (ADR) - Michael Keeling

<p><em>“An ADR is a simple text file describing the context, the decision, and the consequences of a single architectural decision stored in the version control repository."</em></p> <p>Michael Keeling is an experienced software engineer, architect, and the author of “Design It!: From Programmer to Software Architect”. In this episode, Michael shared in-depth about ADR. He first shared his story of discovering ADR before describing what an ADR is. Michael then shared the objectives and benefits of using ADR to record architecture decisions and explained the key behavior changes happening when we practise ADR. Towards the end, Michael shared a few practical tips on creating and updating ADR, some patterns and anti-patterns he observed from his experience, and suggestions on how we can practise ADR effectively as a team.</p> <p>Listen out for:</p> <ul> <li>Career Journey - [00:05:02]</li> <li>Discovering ADR - [00:07:05]</li> <li>ADR - [00:08:57]</li> <li>ADR Objectives - [00:11:18]</li> <li>Facilitating Good Design - [00:12:31]</li> <li>Not Capturing Design Decisions - [00:15:06]</li> <li>Distance Between Developers and Design - [00:17:19]</li> <li>Key Behaviour Changes - [00:19:11]</li> <li>Recent Popularity - [00:22:11]</li> <li>ADR Tips - [00:24:31]</li> <li>When to Create an ADR - [00:26:36]</li> <li>Updating Previous ADR - [00:27:55]</li> <li>Diagrams - [00:29:28]</li> <li>ADR Patterns - [00:31:06]</li> <li>ADR Anti-Patterns - [00:32:48]</li> <li>Doing ADR as a Team - [00:34:25]</li> <li>3 Tech Lead Wisdom - [00:37:05]</li> </ul> <p>_____</p> <p><em>Michael Keeling’s Bio</em><br> Michael Keeling is a software engineer at Kiavi and the author of Design It!: From Programmer to Software Architect. Prior to Kiavi, he worked at IBM on the Watson Discovery Service and has experience with a variety of software systems including service-oriented architectures, enterprise search systems, and even combat systems. Michael is an award-winning speaker and regularly participates in the archi