| Document | Purpose |
|---|---|
| PROJECT_STATUS.md | What's working, what's not |
| PROJECT_PLAN.md | Upcoming work |
| ARCHITECTURE.md | System design and layers |
| CONVENTIONS.md | Code style and patterns |
See decisions/README.md for all ADRs.
Key decisions:
- 005: On-Demand Transcoding
- 012: Music Database Architecture
- 014: Scanner Resilience
- 021: Progressive HLS
| Guide | Description |
|---|---|
| Plugin Development | Building enrichment plugins |
| Enrichment Pipeline | How metadata enrichment works |
| Real-Time Updates | SSE streaming and Event Bus |
| HLS Transcoding | Video transcoding and streaming |
| Category | Files |
|---|---|
| Planning | TECHNICAL_DEBT.md |
| Features | HARDWARE_ACCELERATION.md, TONE_MAPPING.md |
For AI assistants: Start with ../CLAUDE.md, then PROJECT_STATUS.md.