DECISIONS

Architecture decision records

The cross-cutting decisions that shape how the constellation is built and relates — each one a record of context, the choice, and its consequences. Listed from atlas's adr/.

0001 atlas: a cross-repo structure layer, orthogonal to design

accepted

2026-06-02

0002 repo manifests: each system declares its own place and edges

accepted

2026-06-02

0003 errata for 0001/0002, and the cross-repo docs graph

accepted

2026-06-03

0004 substrate-release coordination: a publisher-emitted release BOM + verified per-repo adoption

accepted

2026-06-04

0005 topology-driven views & cross-repo propagation: generate the invariant shape, author the lesson, lint the seam

accepted

2026-06-04

0006 continuous substrate channels: auto-minted content-addressed releases + a moving channel pointer + an automated co-resolution loop

proposed

2026-06-04

0007 Substrate releases are atomic and convergent: one logical version per component, every dependent on it, every ecosystem published together

accepted

2026-06-04

0008 substrate release model (expert-refined): component & constellation releases, signed channel pointers, atomic advertisement, scoped-expiring skew exceptions, the release verdict, and the catalog-epoch trust root

accepted

2026-06-04

0009 the pin trinity: one per-repo lock + one `pin explain` for the design / atlas / substrate refs a repo runs against

accepted

2026-06-04

0010 the three coupling planes: live release metadata / a pinned verifier protocol / actuators on a release train

proposed

2026-06-07

0011 the constellation is a generated evidence ledger: collect / normalize / compare / report, never invent

proposed

2026-06-07

0012 the substrate-theory basis, and where the constellation's constitution lives

proposed

2026-06-07

0013 capability and realization as candidate theories; artifact folded into realization

proposed

2026-06-07

0014 the unified development process: vendored byte-identity for identity-critical files, linted convention for locally-varying files, one drift gate

proposed

2026-06-09

0015 cross-repo issue orchestration: native cross-repo sub-issues supersede the prose `Part of` convention

proposed

2026-06-09

0016 stele is the fact substrate; arche decomposes into primitive services

accepted

2026-06-10

0017 the adstrate: the off-record referent tier (CAS, cell, wire)

accepted

2026-06-13

0018 the adstrate becomes first-class: `layer: "adstrate"` + the Latin naming convention

accepted

2026-06-13