Architecture decision record

A short document recording one decision: the context, the options, what was chosen and what it costs. It lives with the code, is numbered, and is never edited after acceptance — a later decision supersedes it rather than rewriting history. Its value is entirely in the future: it is what stops a new team from either blindly keeping a constraint that expired or cheerfully re-making a mistake somebody already paid for.