b05990fffb
All checks were successful
CI / OCR Service Tests (pull_request) Successful in 23s
CI / Backend Unit Tests (pull_request) Successful in 4m48s
SDD Gate / RTM Check (pull_request) Successful in 15s
SDD Gate / Contract Validate (pull_request) Successful in 24s
CI / fail2ban Regex (pull_request) Successful in 46s
CI / Semgrep Security Scan (pull_request) Successful in 22s
CI / Compose Bucket Idempotency (pull_request) Successful in 1m6s
SDD Gate / Constitution Impact (pull_request) Successful in 18s
CI / Unit & Component Tests (push) Successful in 4m58s
CI / OCR Service Tests (push) Successful in 24s
CI / Backend Unit Tests (push) Successful in 5m51s
CI / fail2ban Regex (push) Successful in 48s
CI / Semgrep Security Scan (push) Successful in 23s
CI / Compose Bucket Idempotency (push) Successful in 1m9s
CI / Unit & Component Tests (pull_request) Successful in 3m36s
Two ADR-041 files landed on main in parallel (sdd-adoption and renovate-runner-setup). Renames the SDD one to 042 and repoints its references (SPEC_DRIVEN_DEVELOPMENT, constitution, .specify/adrs/README, sdd-gate.yml). The renovate ADR keeps 041; its references are left untouched. Riding this PR per request. Refs #778 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
26 lines
1.4 KiB
Markdown
26 lines
1.4 KiB
Markdown
# ADR archive — see `docs/adr/`
|
|
|
|
This project already keeps a mature, permanent ADR archive at
|
|
[`../../docs/adr/`](../../docs/adr/) (40+ records, format `NNN-kebab-title.md`). SDD does
|
|
**not** introduce a second archive — that would split the project's decision history in two.
|
|
|
|
## Where ADRs live
|
|
|
|
- **Project-wide decisions** → [`docs/adr/NNN-kebab-title.md`](../../docs/adr/). Use the
|
|
next free `NNN` (verify against the directory on disk — parallel worktrees make
|
|
issue-body numbers stale). Template: [`../templates/adr.md`](../templates/adr.md).
|
|
- **The decision to adopt SDD itself** →
|
|
[`docs/adr/042-sdd-adoption.md`](../../docs/adr/042-sdd-adoption.md) (this is the
|
|
"ADR-000" the SDD scaffold calls for, numbered to fit the existing sequence).
|
|
- **Feature-local decisions** that are only meaningful within one in-flight feature →
|
|
beside that feature's spec, e.g.
|
|
[`../features/_example/adr-001-avatars-reuse-archive-bucket.md`](../features/_example/adr-001-avatars-reuse-archive-bucket.md).
|
|
Promote one to `docs/adr/` if its reach turns out to be project-wide.
|
|
|
|
## Rules (unchanged from the existing convention)
|
|
|
|
- An ADR is **immutable once `Accepted`** — supersede it with a new, higher-numbered ADR;
|
|
set the old one's status to `Superseded by ADR-MMM`.
|
|
- Header style matches the existing archive: `# ADR-NNN — Title`, then
|
|
`**Status:** / **Date:** / **Issue:**`.
|