Comment by zihotki

That's what ADRs (architecture decision records) are for.

Documentation of the project are the projections of coded intent at a higher zoom level. C4model is an amazing concept and applies well to the context management and docs