Architecture Decision Records
This directory records significant design decisions as Architecture Decision Records (ADRs), one per decision. ADRs are immutable once accepted; when a decision changes, a new ADR supersedes the old one.
- ADR-0001: Python as the Implementation Language
- ADR-0002: Internal State File for Download Tracking (superseded by ADR-0003)
- ADR-0003: Hybrid Filesystem-Based State Management (superseded by ADR-0005)
- ADR-0004: Documentation Structure and Wiki-Style Product Documentation
- ADR-0005: SQLite as a Derived State Index
- ADR-0006: Three-Way Track Identity in Standard Tag Frames
- ADR-0007: Exact YouTube Video ID Resolution
- ADR-0008: Serialised Single-Worker Downloads
- ADR-0009: Multi-Format Output with a Flat Download Layout
- ADR-0010: Fuzzy MusicBrainz Recording Matching
- ADR-0011: Bundled Async, Typed MusicBrainz Client