Decision records

Architecture Decision Records (ADRs) capture why grim is shaped the way it is — the context, the choice, and the consequences — so the reasoning survives the people who made it.

Each record is immutable once accepted: to change a decision, add a new ADR that supersedes the old one rather than editing history. Keep them short.

#	Decision	Status
0001	Separate the engine (grim) from the data (a grimoire)	accepted
0002	Own the file-templating layer; retire chezmoi	accepted
0003	Platform precedence by inferred bands, error on ties	accepted
0004	Secrets are optional, pluggable providers	accepted
0005	Defer file sync + backup to a later phase	accepted
0006	A Cargo workspace with a pure, I/O-free core	accepted