Architecture Decision Records

Architecture Decision Records (ADRs) capture durable design choices whose rationale should survive implementation refactoring. They complement ../architecture.md; they do not replace the product contract.

ADR Decision
ADR-001 Snapshot is the default publication mode
ADR-002 Execution is bound to immutable approved source state and fails closed on drift
ADR-003 Replacement preserves repositories and recovery evidence rather than deleting or auto-rolling back
ADR-004 Wizard/public command share the approved-plan application engine; native commands use centralized no-shell execution
ADR-005 Content verifies before protection restoration; v0.1.0 supports github.com only

Each ADR records context, decision, alternatives/tradeoffs, and consequences. New ADRs should be added only for durable choices that would be costly or confusing to rediscover from source history.