[markcarrier]

For software projects I like markdown architectural decision records:

https://adr.github.io/madr/

[saviorand]

This is actually very similar in structure. With possible consequences, outcome, decision pros and cons