Look into "architectural decision records" as a way to persist the "alternatives considered".

[jyasskin]

@dontcallmedom mentioned them in https://www.igalia.com/chats/dominique#:~:text=architectural%20decision%20records.

[jyasskin]

https://adr.github.io/ looks like a good exploration. https://adr.github.io/madr/#overview has what might be a good template.