Skip to main content

Architecture Decision Records

Short records of decisions that are expensive to reverse or easy to re-litigate without a written rationale. One file per decision, numbered sequentially (0001-*.md, 0002-*.md, ...), never renumbered or deleted once merged — a superseded decision gets a new ADR that says so and links back.

Use the lightweight format: Status, Context, Decision, Consequences. Keep it to what a future contributor needs to not redo the argument; put implementation detail in specs/ or code comments instead.

Index​

Numbers 0026 and 0032 are reserved by the roadmap for ADRs not yet written (node kinds, graph rules); 0031 and later were written first. Declarative pins (0025), localization (0027), node search (0028), node capabilities (0029) and the Extensibility split (0030) are written.