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
+3 -3
View File
@@ -1,8 +1,8 @@
# ADR Format
ADRs live in `docs/adr/` and use sequential numbering: `0001-slug.md`, `0002-slug.md`, etc.
ADRs live in `docs/authoritative/adr/` and use sequential numbering: `0001-slug.md`, `0002-slug.md`, etc.
Create the `docs/adr/` directory lazily — only when the first ADR is needed.
Create the `docs/authoritative/adr/` directory lazily — only when the first ADR is needed.
## Template
@@ -24,7 +24,7 @@ Only include these when they add genuine value. Most ADRs won't need them.
## Numbering
Scan `docs/adr/` for the highest existing number and increment by one.
Scan `docs/authoritative/adr/` for the highest existing number and increment by one.
## When to offer an ADR
+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