first commit

docs/adr/README.md

@@ -0,0 +1,15 @@
+# Architecture Decision Records
+
+One file per decision: `NNNN-short-title.md`. Record the context, the decision, and the consequences. When a decision conflicts with [`CLAUDE.md`](../../CLAUDE.md), change the charter first (charter §18).
+
+## Index
+
+- _none yet_
+
+<!-- Template:
+## NNNN — Title
+- **Status:** proposed | accepted | superseded by NNNN
+- **Context:** what forced the decision
+- **Decision:** what we chose
+- **Consequences:** what this makes easy / hard
+-->