Architecture decision records¶
ADRs record durable local engineering decisions that do not require a full
research/API proposal. Create new records as ADR-NNNN-kebab-case-title.md.
An accepted ADR is not rewritten except for status and links; a replacement ADR
supersedes it.
Existing historical decision documents remain authoritative historical records. The index below gives each a stable ADR identifier without changing its text:
| ADR | Historical document | Subject |
|---|---|---|
| ADR-0001 | docs/24_bottom_mask_provenance_q2_decision.md |
Bottom-mask provenance status |
| ADR-0002 | docs/26_ros2_repo_layout_decision.md |
ROS 2 in-repository layout |
| ADR-0003 | docs/27_ros2_bundle_loading_decision.md |
ROS 2 bundle loading |
| ADR-0004 | docs/28_ros2_rmw_selection_decision.md |
ROS 2 middleware selection |
| ADR-0005 | docs/29_rest_grpc_bundle_service_decision.md |
REST/gRPC bundle service |
| ADR-0006 | docs/30_triton_inference_server_decision.md |
Triton inference-server integration |
| ADR-0007 | docs/41_gauge_policy_design_review.md |
Gauge-policy design review |
| ADR-0008 | docs/adr/ADR-0008-rr-dataset-nonfinite-json.md |
RR dataset non-finite JSON encoding |
| ADR-0009 | docs/adr/ADR-0009-pypi-audit-local-versions.md |
PyPI advisory lookup for local dependency versions |
Template¶
# ADR-NNNN — Title
**Status:** proposed | accepted | superseded | deprecated
**Date:** YYYY-MM-DD
**Owners:** maintainer handles
**Supersedes / superseded by:** ADR-NNNN or none
## Context
## Decision
## Consequences
## Alternatives considered
## Verification and rollout
Current semantic decisions:
- ADR-0010 — canonical physical namespace;
- ADR-0011 — SCM4 registry and orthogonal results;
- ADR-0012 — exact versus machine zero;
- ADR-0013 — canonical projective gauge; and
- ADR-0014 — bounded float64 refinement;
- ADR-0015 — retained alpha evidence binding;
- ADR-0016 — result origin and hash-bound execution evidence;
- ADR-0017 — working tensors versus durable snapshots; and
- ADR-0018 — legacy exact-literal zero contract.