Heuristics

Use ADRs for Thinking, Not Just Recording

Authors: Peter Hunter, Elena Stojmilova, Kenny Schwegler, Andrea Magnorsky

Submitter: Elena Stojmilova

When is the right time to write an Architecture Decision Record?

Begin writing the ADR at the start of the decision-making process, not as an afterthought for documentation. Use its structure collaboratively as a tool to guide team discussion, explore options, and identify necessary research. The document becomes a guide for deliberation.

Examples

A team now starts by creating a draft ADR together. They use it to frame the context, list options, and decide on any spikes needed for investigation.

 

Tags

Follow us

Read our latest news from Virtual DDD on any of these social networks!

Recent heuristics

Discussed content

Sorry, no results found!

Whoops... we couldn't find what you're looking for