Architectural Decision Records

Every non-trivial design choice in glixos is captured here. Each ADR follows the same lightweight shape: context → decision → consequences. ADRs are append-only: once accepted, they are amended by adding new ADRs rather than editing old ones.

Index

ID	Title	Status
ADR-001	Two flakes, one direction of dependency	Accepted
ADR-002	Flake contract: optional nixosModule / homeModule	Accepted
ADR-003	Manifest-driven, glix writes one file	Accepted
ADR-004	Resolver chain: URI → glixos registry → nix registry	Accepted
ADR-005	Multi-host: one repo, hosts/<name>/ subdir	Accepted
ADR-006	Secrets are out of scope for v1	Accepted
ADR-007	Flakes-only, no nix-channel	Accepted
ADR-008	glix rollback reverts manifest and generation together	Accepted
ADR-009	Per-package config injected as glixConfig	Accepted
ADR-010	Home-scope routing keyed by Package.user	Accepted

Writing a new ADR

1. Copy an existing file and increment the number.
2. Use front-matter title and sidebar_label consistent with the index above.
3. Keep the three-section shape; resist adding a long preamble.
4. Add the row to the index table and to sidebars.js.