Use Architecture Decision Records (ADRs) to document significant architectural decisions. ADRs capture the context, decision, and consequences of each decision.
The Cognitect Blog post by Michael Nygard discusses the importance of documenting architecture decisions.