Packages

development-driven-specs — the dds toolchain (protocol 2) as a Mix task. A thin shim over the bundled instruments (Python, stdlib); never a port.

Current section

Files

Jump to
dds priv toolchain migrations 0.11.5.md
Raw

priv/toolchain/migrations/0.11.5.md

# 0.11.5 — the ADR index leaves the canon (issue #34)
`docs/adr/README.md`'s `## Index` section was a hand-maintained
enumeration recoverable from the directory listing — the exact form
`principles.md` §1 forbids — and as canon-enforced content it produced
a standing `undeclared canon drift` finding on every repo that obeyed
its own instruction, plus an upgrade-clobber hazard.
## The one step
Delete the `## Index` section (heading, table, everything under it)
from `docs/adr/README.md`; the canon reconcile installs the
replacement text ("The index is a query, not a file"). Before
deleting: any `Topic` cell that carries prose NOT recoverable from the
ADR's content-named filename is content — quote each such cell in the
migration PR body (rare; a topic that differs from its filename
usually signals the file wants renaming under the content-naming
rule).
## Confirm
`dds` reports no drift on `docs/adr/README.md`; the directory listing
and `dds issues` serve what the index served.