1# Decision records23Framework changes that alter a documented product promise should retain a short decision record in4this directory. Historical M1/M2 decisions predate this index and remain represented by the5developer-experience contract, spike evidence, issues, and pull requests.67Name new records `NNNN-short-title.md` and include:891. **Question** — the decision being made.102. **Contract IDs** — promises affected in `docs/devx-contract.md`.113. **Exact versions** — package, runtime, browser, OS, and commit pins.124. **Control** — the comparison or vendor baseline.135. **Procedure** — repeatable commands and observable steps.146. **Evidence** — retained, non-secret artifacts.157. **Decision** — adopt, revise, defer, or reject.168. **Contract delta** — what changed in the product promise.179. **Follow-up** — remaining work with an owner or issue.1819A negative result is a valid decision. Do not replace evidence with a search summary, and never20record environment values, account secrets, recovery phrases, or sensitive user content.