#113 - Architecture Decision Record (ADR) - Michael Keeling
Tech Lead Journal14 Marras 2022

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

“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."

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.

Listen out for:

  • Career Journey - [00:05:02]
  • Discovering ADR - [00:07:05]
  • ADR - [00:08:57]
  • ADR Objectives - [00:11:18]
  • Facilitating Good Design - [00:12:31]
  • Not Capturing Design Decisions - [00:15:06]
  • Distance Between Developers and Design - [00:17:19]
  • Key Behaviour Changes - [00:19:11]
  • Recent Popularity - [00:22:11]
  • ADR Tips - [00:24:31]
  • When to Create an ADR - [00:26:36]
  • Updating Previous ADR - [00:27:55]
  • Diagrams - [00:29:28]
  • ADR Patterns - [00:31:06]
  • ADR Anti-Patterns - [00:32:48]
  • Doing ADR as a Team - [00:34:25]
  • 3 Tech Lead Wisdom - [00:37:05]

_____

Michael Keeling’s Bio
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 architecture and agile communities. He holds a Masters in Software Engineering from Carnegie Mellon University and a BS in Computer Science from the College of William and Mary. His current research interests include software design methods, patterns, and human factors of software engineering.

Follow Michael:

_____

Our Sponsors

Mental well-being is a silent pandemic. According to the WHO, depression and anxiety cost the global economy over USD 1 trillion every year. It’s time to make a difference! Learn how to enhance your lives through a master class on mental wellness. Visit founderswellbeing.com/masterclass and enter TLJ20 for a 20% discount.

Skills Matter is the global community and events platform for software professionals. You get on-demand access to their latest content, thought leadership insights as well as the exciting schedule of tech events running across all time zones.
Head on over to skillsmatter.com to become part of the tech community that matters most to you - it’s free to join and easy to keep up with the latest tech trends.


Like this episode?
Follow @techleadjournal on LinkedIn, Twitter, and Instagram.
Pledge your support by becoming a patron.
For episode show notes, visit techleadjournal.dev/episodes/113.

Tämä jakso on lisätty Podme-palveluun avoimen RSS-syötteen kautta eikä se ole Podmen omaa tuotantoa. Siksi jakso saattaa sisältää mainontaa.

Jaksot(279)

Software Engineering Laws Every Developer Must Know in the AI Era - Milan Milanovic

Software Engineering Laws Every Developer Must Know in the AI Era - Milan Milanovic

Does moving faster with AI mean you get to skip the laws that governed every software project before it? Milan Milanovic argues the opposite, the old laws of software engineering now apply twice as ha...

10 Elo 1h 1min

Signals & Levers: Systems Thinking to Navigate Software Delivery Illusions - Elisabeth Hendrickson & Joel Tosi

Signals & Levers: Systems Thinking to Navigate Software Delivery Illusions - Elisabeth Hendrickson & Joel Tosi

(04:48) Brought to you by SpeechifyAITired of text-to-speech that sounds robotic or costs too much at scale? SpeechifyAI's new Simba 3.2 model ranks #1 on Artificial Analysis for realness, priced unde...

3 Elo 1h 17min

From Technical Debt to Triple Debt: The Hidden Cost of AI-Generated Code

From Technical Debt to Triple Debt: The Hidden Cost of AI-Generated Code

Is vibe coding quietly draining the thing that makes teams effective: their shared understanding? Margaret breaks down her new “triple debt” model, and why cognitive debt might be the one nobody’s tra...

27 Heinä 1h 10min

Ex-Gojek CTO: Why the Age of AI Rewards Builders as Judgment Becomes Expensive

Ex-Gojek CTO: Why the Age of AI Rewards Builders as Judgment Becomes Expensive

If expertise is becoming almost free, why is judgment becoming the most expensive skill in tech? Ajey Gore, former Gojek CTO, explains why the age of AI agents rewards builders over typists.In this ep...

13 Heinä 1h 22min

The AI Productivity Paradox: Why 10X Output Doesn't Mean 10X Business Outcome

The AI Productivity Paradox: Why 10X Output Doesn't Mean 10X Business Outcome

What if optimizing for AI output is actually slowing your company down? When code becomes nearly free to produce, the organizations still measuring productivity by output are solving the wrong problem...

29 Kesä 1h 5min

The Hidden Stories Sabotaging Your Culture Change

The Hidden Stories Sabotaging Your Culture Change

Why do 70% of change efforts fail — even when leadership is fully committed? The answer isn’t strategy or resources; it’s the hidden stories people unknowingly carry that silently block every initiati...

15 Kesä 1h 8min

Creator of Meta's Hack: Your AI Will Always Cheat — Here's How to Stop It

Creator of Meta's Hack: Your AI Will Always Cheat — Here's How to Stop It

What if your AI coding agent is quietly cheating on your tests — and how do you stop it? Julien Verlaguet, who built the type system Meta used to migrate tens of millions of PHP lines, is now building...

8 Kesä 1h 18min

Eric Ries: Why Good Tech Companies Go Bad, and How to Stop It

Eric Ries: Why Good Tech Companies Go Bad, and How to Stop It

Why do companies with the best intentions end up betraying their customers, employees, and mission? Eric Ries calls it “financial gravity” — an invisible force that pulls even the most principled comp...

1 Kesä 1h