Use authoritative ADR directory

This commit is contained in:
2026-08-15 23:46:34 -04:00
parent 184816b1c4
commit 4a04de1e9c
2 changed files with 12 additions and 10 deletions
+9 -7
View File
@@ -15,9 +15,10 @@ Most repos have a single context:
/
├── CONTEXT.md
├── docs/
│ └── adr/
── 0001-event-sourced-orders.md
── 0002-postgres-for-write-model.md
│ └── authoritative/
── adr/
── 0001-event-sourced-orders.md
│ └── 0002-postgres-for-write-model.md
└── src/
```
@@ -27,17 +28,18 @@ If a `CONTEXT-MAP.md` exists at the root, the repo has multiple contexts. The ma
/
├── CONTEXT-MAP.md
├── docs/
│ └── adr/ ← system-wide decisions
│ └── authoritative/
│ └── adr/ ← system-wide decisions
├── src/
│ ├── ordering/
│ │ ├── CONTEXT.md
│ │ └── docs/adr/ ← context-specific decisions
│ │ └── docs/authoritative/adr/ ← context-specific decisions
│ └── billing/
│ ├── CONTEXT.md
│ └── docs/adr/
│ └── docs/authoritative/adr/
```
Create files lazily — only when you have something to write. If no `CONTEXT.md` exists, create one when the first term is resolved. If no `docs/adr/` exists, create it when the first ADR is needed.
Create files lazily — only when you have something to write. If no `CONTEXT.md` exists, create one when the first term is resolved. If no `docs/authoritative/adr/` exists, create it when the first ADR is needed.
## During the session