Use the S.O.S. test to decide whether a choice deserves an Architecture Decision Record (ADR), rather than a code comment. section 2.7
Ask whether the choice is:
- Significant: Does it change how other parts of the system work? section 2.7
- Onerous to change: Would reversing it later be a nightmare? section 2.7
- Surprising: Would a future developer wonder why it was done this way? section 2.7
If any answer is yes, write an ADR. Choosing Redis over a database table may qualify; choosing a for loop over map() is a local detail better handled with a code comment. section 2.7
