🏗️Architecture Decision Record (ADR)
Also known as Architectural Decision Record, Decision Log, ADR File
A short note that saves one design choice and why the team made it.
Think of it like
It is like a diary page for one big choice. It says what you chose and why.
Example
Emma's team picks PostgreSQL over MongoDB. She writes record number 7 with the reasons, so a new developer a year later knows why.
Why it matters
Teams forget why things are the way they are. A record stops the same argument from coming back again and again.
Definition
Example code
console
$ ls docs/adr
0001-record-architecture-decisions.md
0002-use-postgresql.md
0003-split-billing-service.mdCommon mistake
Key takeaways
- 1One decision each. Short and numbered.
- 2Context and consequences. Why, and what follows.
- 3Never rewritten. Replaced by a new one.