Skip to content

README.md

Latest commit

 

History

History
35 lines (30 loc) · 1.87 KB

README.md

File metadata and controls

35 lines (30 loc) · 1.87 KB
Raw

Architecture Decision Records

ADRs record decisions that affect Wright's observable product/compiler contract or component boundaries. They complement, rather than replace, the normative contracts in docs/architecture.md and docs/compatibility.md.

Conventions

  • Files use a zero-padded sequence and a short title, for example 0003-ir-boundary.md.
  • An ADR starts as Proposed and becomes Accepted when the decision is the repository's current contract. Superseded ADRs remain for history and link to the decision that replaces them.
  • An accepted ADR is not rewritten to hide history. A material change gets a new ADR, and the old record links to it.
  • Decisions state their scope, consequences, compatibility impact, and open questions. They describe observable constraints rather than implementation guesses.
  • New ADRs should link to the affected architecture or compatibility document and to any superseded or related decision.

Index