> the reasons behind architectural choices

Should go into a historical document, not a durable record of decisions for an AI to follow unless those reasons are themselves decisions for it to act on.