diff --git a/domain-modeling/ADR-FORMAT.md b/domain-modeling/ADR-FORMAT.md index da7e78e..e735c9e 100644 --- a/domain-modeling/ADR-FORMAT.md +++ b/domain-modeling/ADR-FORMAT.md @@ -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 diff --git a/domain-modeling/SKILL.md b/domain-modeling/SKILL.md index e660e8c..580bbd6 100644 --- a/domain-modeling/SKILL.md +++ b/domain-modeling/SKILL.md @@ -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