https://en.wikipedia.org/wiki/Architectural_decision
This directory records high level architectural decisions for the project, acts as an Architecture Decision Log (ADL).
Filename: <iso date>_<name>.md
Initially, have the date is when it was first proposed (added to repo). When decision is final, change the filename date to that date. After decision is final, change the decision by adding a new ADR, with a new date. Can be a different name if you want, just add links to the files.