Architecture Decision Records (ADRs) are intended to help with that: https://adr.github.io/ https://adr.github.io/ https://github.com/joelparkerhenderson/arch

Architecture Decision Records (ADRs) are intended to help with that: https://adr.github.io/ https://adr.github.io/ https://github.com/joelparkerhenderson/architecture_decision_record https://github.com/joelparkerhenderson/architecture_decision... https://github.com/joelparkerhenderson/architecture_decision_record/blob/master/adr_template_by_michael_nygard.md https://github.com/joelparkerhenderson/architecture_decision... They're overkill for small personal projects but can be helpful in big teams because it won't just be you wondering, “why the hell did they choose that?”.