Skip to content

adr

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

adr

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
0001-adopt-adrs-alongside-audits.md
0001-adopt-adrs-alongside-audits.md
 
 
0002-capture-structure-beyond-mermaid-er.md
0002-capture-structure-beyond-mermaid-er.md
 
 
0003-richer-relationship-cardinality.md
0003-richer-relationship-cardinality.md
 
 
0004-subtype-generalization.md
0004-subtype-generalization.md
 
 
0005-value-types.md
0005-value-types.md
 
 
0006-action-reports-not-invariants.md
0006-action-reports-not-invariants.md
 
 
0007-value-types-out-of-scope.md
0007-value-types-out-of-scope.md
 
 
0008-er-diagram-conventions.md
0008-er-diagram-conventions.md
 
 
0009-modelith-is-not-modelled-in-modelith.md
0009-modelith-is-not-modelled-in-modelith.md
 
 
0010-cross-model-references-by-vendoring.md
0010-cross-model-references-by-vendoring.md
 
 
0011-network-boundary.md
0011-network-boundary.md
 
 
0012-imports-bind-the-scope.md
0012-imports-bind-the-scope.md
 
 
0013-imports-confined-to-the-repository.md
0013-imports-confined-to-the-repository.md
 
 
0014-prose-is-markdown-not-html.md
0014-prose-is-markdown-not-html.md
 
 
0015-vendoring-is-a-whole-file-copy.md
0015-vendoring-is-a-whole-file-copy.md
 
 
0016-staleness-is-a-content-comparison.md
0016-staleness-is-a-content-comparison.md
 
 
0017-recursive-provenance-verification.md
0017-recursive-provenance-verification.md
 
 
0018-qualified-entity-references-stop-at-import-boundary.md
0018-qualified-entity-references-stop-at-import-boundary.md
 
 
0019-azure-devops-as-a-second-transport.md
0019-azure-devops-as-a-second-transport.md
 
 
README.md
README.md
 
 

README.md

Architecture Decision Records

Forward-looking decision records. An ADR captures a decision or intention as it is made — the direction chosen and why — so the plan stays current and a future reader understands the constraint.

ADRs are numbered sequentially (0001-slug.md, 0002-slug.md) and never edited in place: a new ADR supersedes an old one. The shape, template, and the bar for writing one live in .claude/rules/adr.md.

ADRs vs. audits

Its sibling ../audits/ is retrospective: point-in-time snapshots of multi-agent reviews and their findings. When a decision comes out of an audit, record the decision here and leave the audit as the evidence trail.