Skip to content

Architecture Decision Records

This section documents significant architecture decisions using the ADR format. Each record captures the context, decision, and consequences of a key technical choice.

ADRTitleStatus
ADR-001UBI Image SupportSuperseded by ADR-010
ADR-002Ansible as Feature BootstrapperAccepted
ADR-003Non-Root vscode User ConventionSuperseded by ADR-011
ADR-004UV as Ansible RunnerSuperseded by ADR-008
ADR-005Bun as Package ManagerAccepted
ADR-006Checksum VerificationAccepted (amended)
ADR-007Feature Dependency ModelSuperseded by ADR-009
ADR-008Pinned .bootstrap UV EnvironmentAccepted
ADR-009Mandatory Dependencies via dependsOnAccepted
ADR-010Fedora 43 TargetAccepted
ADR-011Non-Root dev User AlignmentAccepted
ADR-012Feature Role ContractAccepted