Decision records

Short documents that capture a significant technical decision — its context, the choice made, the reasoning, and the consequences. One file per decision, numbered and append-only. (This format is commonly called an Architecture Decision Record, or ADR.)

Records are immutable once accepted. A later decision that changes an earlier one is added as a new record that supersedes it, rather than editing the old one — so the history of why stays intact.