# Architecture Decision Records Short records of significant decisions, so a new session understands *why* rather than only *what*. Add a new numbered file for each meaningful decision and link it here. | ADR | Title | Status | |-----|-------|--------| | [0001](0001-rust-installer.md) | Rust installer as production; Bash retained as reference | Accepted | | [0002](0002-bls-over-uki.md) | BLS entries instead of UKI for the boot path | Accepted | | [0003](0003-desktop-systemd-profile.md) | Desktop installs inherit the Gentoo desktop/systemd profile | Accepted | | [0004](0004-portage-verify-keyring.md) | Relax the getuto keyring for the dropped-privilege verifier | Accepted | | [0005](0005-debian-live-appliance.md) | Debian-Live appliance ISO with a Gentoo target | Accepted | | [0006](0006-package-lanes.md) | Package lanes and hardware-aware software selection | Accepted (revised 2026-09-24) | | [0007](0007-coherent-rollback.md) | Coherent rollback and recovery | Accepted | | [0008](0008-nix-isolation-lifecycle.md) | Nix lifecycle, build isolation, and packaging | Accepted | | [0009](0009-mango-dankmaterialshell-desktop.md) | Mango + DankMaterialShell desktop option | Accepted | | [0010](0010-graphical-installer-frontend.md) | Graphical installer frontend and typed bridge | Accepted | | [0011](0011-opencode-connection-boundary.md) | OpenCode connection boundary | Accepted | | [0012](0012-nvidia-driver-policy.md) | NVIDIA accelerated-driver policy and payload | Accepted | | [0013](0013-ai-first-installation.md) | AI-first package installation workflow | Accepted | | [0014](0014-privileged-approval-ledger.md) | Privileged approval ledger | Accepted | | [0015](0015-agent-execution-boundaries.md) | Explicit agent execution boundaries | Accepted | Format: Context / Decision / Consequences / Status.