When making significant project changes, create an Architecture Decision Record (ADR) under docs/adr/ using the naming convention NNNN-kebab-case-title.md (4 digits, zero-padded; start at 0001).
See docs/adr/AGENTS.md for the detailed rules and ADR template.