Architecture decisions

ADRs capture significant, hard-to-reverse decisions for Rivet. They are the review step in the project’s development process: research, design, review, architecture, then implementation — never implementation first. Each record states the context, the decision, the alternatives considered, and the consequences.

#	Decision	Status
0001	Platform & package-manager abstraction	Accepted
0002	Pluggable storage backends	Accepted
0003	Encrypted secrets vault (age)	Accepted
0004	Plugin contract & arbitrary file tracking	Accepted
0005	Cross-distro package identity	Accepted
0006	TUI navigation model	Accepted
0007	macOS as a first-class platform	Accepted
0008	Open core: commercial boundary & licensing	Accepted
0009	Public, canonical repository	Accepted

Status values: Proposed → Accepted → Superseded. ADRs 0001–0005 were reviewed and Accepted on 2026-07-24 (Opus); each carries an acceptance note fixing what is in-scope for v0.2 versus later. The finalized, implementation-ready detail lives in v0.2-implementation-spec.md. See ROADMAP.md for sequencing.