phoebus_os/docs/adr
2026-09-24 19:14:16 -07:00
..
0001-rust-installer.md feat(git): add session context, host doctor, ADRs and git hygiene 2026-09-20 02:36:32 -07:00
0002-bls-over-uki.md feat(git): add session context, host doctor, ADRs and git hygiene 2026-09-20 02:36:32 -07:00
0003-desktop-systemd-profile.md feat(git): add session context, host doctor, ADRs and git hygiene 2026-09-20 02:36:32 -07:00
0004-portage-verify-keyring.md feat(git): add session context, host doctor, ADRs and git hygiene 2026-09-20 02:36:32 -07:00
0005-debian-live-appliance.md feat(desktop): make Mango + DankMaterialShell the default and build a live desktop ISO 2026-09-21 06:47:22 -07:00
0006-package-lanes.md feat(sys): hardware-aware lane selection and new lanes 2026-09-23 18:35:26 -07:00
0007-coherent-rollback.md feat(desktop): add Mango + DankMaterialShell profile with rollback, assistant and release foundations 2026-09-21 03:46:52 -07:00
0008-nix-isolation-lifecycle.md feat(desktop): add Mango + DankMaterialShell profile with rollback, assistant and release foundations 2026-09-21 03:46:52 -07:00
0009-mango-dankmaterialshell-desktop.md refactor(desktop): unify desktop stack on Mango + DarkMaterial and excise standalone dwl 2026-09-24 15:49:15 -07:00
0010-graphical-installer-frontend.md feat(installer): graphical welcome and install wizard over a typed bridge 2026-09-21 13:13:40 -07:00
0011-opencode-connection-boundary.md feat(gui): select and validate OpenCode from the installer 2026-09-22 02:36:36 -07:00
0012-nvidia-driver-policy.md docs: reconcile NVIDIA, verification and harness status 2026-09-23 06:28:30 -07:00
0013-ai-first-installation.md feat(install): AI-first sys install workflow 2026-09-23 20:30:13 -07:00
0014-privileged-approval-ledger.md fix(admin): anchor approval in a broker ledger, user-own settings, and carry reviewed effects 2026-09-24 19:14:16 -07:00
README.md feat(install): AI-first sys install workflow 2026-09-23 20:30:13 -07:00

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 Rust installer as production; Bash retained as reference Accepted
0002 BLS entries instead of UKI for the boot path Accepted
0003 Desktop installs inherit the Gentoo desktop/systemd profile Accepted
0004 Relax the getuto keyring for the dropped-privilege verifier Accepted
0005 Debian-Live appliance ISO with a Gentoo target Accepted
0006 Package lanes and hardware-aware software selection Accepted (revised 2026-09-24)
0007 Coherent rollback and recovery Accepted
0008 Nix lifecycle, build isolation, and packaging Accepted
0009 Mango + DankMaterialShell desktop option Accepted
0010 Graphical installer frontend and typed bridge Accepted
0011 OpenCode connection boundary Accepted
0012 NVIDIA accelerated-driver policy and payload Accepted
0013 AI-first package installation workflow Accepted

Format: Context / Decision / Consequences / Status.