Create ADR

Record one architecture decision — the "why" that code and commit messages can't carry — as a numbered, immutable file in the target repository.

An ADR records a decision made, not a proposal under discussion. If the decision isn't settled yet, help settle it in conversation first; write the ADR after.

Steps

1. Locate the ADR home. Look for an existing convention in the target repo: docs/adr/, docs/decisions/, adr/, or an existing NNNN-*.md series anywhere under docs/. Follow whatever exists (numbering width, template style). If none exists, create docs/adr/ and start at 0001.
   • Completion criterion: directory and next sequence number are known.