Architecture Decision Records

This directory contains durable engineering decisions for MLX-Gen. ADRs are policy, not task tracking; backlog items record execution state and evidence.

ADR	Status	Decision
ADR 0001	Accepted	New model routes need model-backed smoke proof before being described as working.
ADR 0002	Accepted	Ambiguous or unsupported requests fail closed; automatic fallback is explicit opt-in only.
ADR 0003	Accepted	MLX-Gen owns exact runtime truth; higher-level integrations own convenience and curation.
ADR 0004	Accepted	SeedVR2 video defaults to a conservative host-safe CLI profile, and heuristic metrics alone do not justify public family-quality rankings.
ADR 0005	Accepted	SeedVR2 public video quality claims require at least five contiguous seconds of reader-first proof plus direct visual review artifacts.
ADR 0006	Accepted	Prompt-guided source-video editing belongs to mlxgen generate; the first public milestone is plain video-to-video, not VACE conditioning.
ADR 0007	Accepted	Reference images are typed conditioning, and factored model components require explicit compatible sources and provenance.