davidl/tolaria
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: ADR timing rule — create in same commit as code, never before

Browse Source
This commit is contained in:
Test
2026-03-28 18:51:23 +01:00
parent 3749770598
commit 89f53a1214
1 changed files with 2 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
CLAUDE.md
View File

@@ -90,6 +90,8 @@ ADRs live in `docs/adr/`. Before making an architectural choice, check existing
**When to create one**: storage strategy, new dependency, platform support, core abstraction change, cross-cutting concern. Use `/create-adr` for the full template and instructions.
**Timing**: create the ADR **in the same commit as the code** that implements the decision — never before, never after. An ADR committed without the corresponding code is invalid.
**When your work supersedes an existing ADR**: do not edit the existing file — use `/create-adr` which covers the superseding flow.
**Do not create ADRs for**: bug fixes, UI styling, refactors, or test additions.