Architecture Decision Records (ADRs)¶
We document significant technical decisions using Architecture Decision Records in Nygard format.
Immutable Once Accepted¶
Once an ADR reaches status Accepted, its text is immutable. If architectural direction evolves, a new ADR is created that supersedes the prior one.
Seed ADRs¶
| # | Title | Status | Date |
|---|---|---|---|
| 0001 | Centralized Declarative Version Manifest (versions.json) |
Accepted | 2026-09-10 |
| 0002 | Multi-Tiered Global Anycast & Stratum-1 NTS Topology | Accepted | 2026-09-10 |
| 0003 | NVIDIA Multi-Generational CUDA & Driver Segmentation | Accepted | 2026-09-10 |
| 0004 | Hypervisor Guest Agent Coexistence (QEMU + VMware) | Accepted | 2026-09-10 |
| 0005 | Bare-Metal Compressed Block Streaming Installation | Accepted | 2026-09-10 |
| 0006 | K3s Lightweight Fleet Edge Flavors | Accepted | 2026-09-10 |
| 0007 | Cloud-Native Immutable and CNCF Storage Appliances | Accepted | 2026-09-10 |
| 0008 | Specialized Homelab Appliance Flavors | Accepted | 2026-09-10 |
| 0009 | Multi-Distribution Base OS Architecture and Roadmap | Accepted | 2026-09-10 |
| 0010 | Modern Container Runtimes, Lazy-Pulling Snapshotters, and Zero-Footprint Diagnostic Tooling | Accepted | 2026-09-10 |
| 0011 | Enterprise Golden Image Hardening, Compliance Crosswalk, and Lifecycle Governance | Accepted | 2026-09-10 |
| 0012 | Universal Architecture Portability, Containerd 2.x CRI Modernization, and Dual-Stack Hardening | Accepted | 2026-09-10 |
| 0013 | Persistent Cross-Session Memory via Hindsight Semantic Backend & MCP Architecture | Accepted | 2026-09-10 |
| 0014 | Automated Dependency & Security Governance via Zero-Noise Renovate and Native CodeQL | Accepted | 2026-09-10 |
| 0015 | Progressive Disclosure Agent Skills & Two-Phase Staged MCP Mutation Guardrails | Accepted | 2026-09-10 |
| 0016 | Hypervisor, Storage, and Runtime Image Optimization Architecture | Accepted | 2026-09-10 |
| 0017 | Developer Workstation Environments, Single-Node Kubernetes, and Clustered Orchestration Expansion | Accepted | 2026-09-10 |
| 0018 | Open-Source and Virtual Network Attached Storage (NAS) Ecosystem Architecture | Accepted | 2026-09-10 |
| 0019 | Fleet Migration to cordanaLLM/imago: Praetor Governance, Golusoris Core, and a Routed Planning Graph | Accepted | 2026-09-15 |
| 0020 | Aegis Product-Input Contract Acceptance | Accepted; amended by 0028; decision 4 superseded by 0030 | 2026-09-15 |
| 0021 | Pinned Kernel Artifact Contract with cordanaLLM/nucleus | Accepted; amended by 0028 | 2026-09-15 |
| 0022 | Fail-Closed Provisioners and a Declared Rule Set for main |
Accepted | 2026-10-11 |
| 0023 | EUPL-1.2 Licence and REUSE Annotations | Accepted | 2026-10-11 |
| 0024 | Product-Result Emitter and the Signature Reference Form | Accepted | 2026-10-11 |
| 0025 | The Forge as the Record of Open Work and a Frozen Planning Graph | Accepted; amended by 0029 | 2026-10-11 |
| 0026 | Required Checks Accept Only Detector-Decided Skips | Superseded by 0027 | 2026-10-12 |
| 0027 | Pull Request Jobs Never Skip; Each Job Filters Its Own Paths | Accepted | 2026-10-14 |
| 0028 | One Reason Bound for Every Contract Parser | Accepted | 2026-10-14 |
| 0029 | A Planning Step Reopens When Its Acceptance Is Unmet | Accepted | 2026-10-17 |
| 0030 | The Kernel Requirement Decoder Follows the Schema Owner | Accepted | 2026-10-17 |
| 0031 | Fail-Closed Build Dispatch | Accepted | 2026-10-17 |
| 0032 | Local Packer Executor | Accepted | 2026-10-17 |
| 0033 | Aegis OS Image Build and Release Workflow | Accepted | 2026-10-17 |
| 0034 | iPXE Netboot Assets and Root Integrity | Accepted | 2026-10-17 |
| 0035 | Required Checks Wait Only for Gate Workflows | Accepted | 2026-10-19 |
| 0036 | Required Checks Count Run Time, Not Queue Time | Accepted | 2026-10-19 |
| 0037 | Release Build in Reusable Workflow with SLSA v1 Build Level 3 Provenance | Accepted | 2026-10-19 |