Skip to content

Architecture decision records

An ADR records a decision that constrains future work: the context that forced it, the choice made, and the consequences accepted. They are immutable once accepted — a reversal is a new record that supersedes the old one, not an edit.

Records here describe decisions that are already embodied in the code. Where a decision is still open, it is on the roadmap instead.

Use _template.md for new records.

Index

#TitleStatus
0001Entity graph free of domain semantics and serializationAccepted
0002Codec as a trait owned by the model crateAccepted
0003Domain crates as borrowed viewsAccepted
0004Geometry bridge, not geometry kernelAccepted
0005Scaffold modules declare ownership without claiming capabilityAccepted
0006Facade features default to thinAccepted
0007Authoring is a schema-layer concern, not a model-layer oneAccepted
0008Fixed slot constants for stable relationshipsAccepted
0009DERIVED attributes resolve through the parent contextAccepted
0010Checked mutation is a model-level primitive, not a bare accessorAccepted

Released under the AGPL-3.0-or-later licence. ISO and CEN standards material is not redistributed.