Track architectural decisions as git trailers on the commits that implement them. Your repo's history becomes the decision log: reviewable, greppable, impossible to lose, and impossible to silently outdate.
Every long-lived project accumulates decisions — invariants, conventions, hard-won "never do X again" rules — and every place teams put them fails