| Need | Start here |
|---|---|
| Find a feature, its UI and tests; choose where new code goes | Architecture and domain ownership |
| Coding conventions, compatibility and test organization | Coding standards |
| Test design, evidence layers and qualification gaps | Testing guidance |
| Setup, commands, threading, boot and test groups | Developer guide |
| Domain language and decision guidance | Domain guidance, glossary |
| QML slots/signals and payload rules | Bridge reference |
| Branches, issues, reviews and validation evidence | Implementation workflow, issue tracker, triage |
| Architecture decisions | ADRs: quality, provider stop, migrations, distribution, onboarding, Library semantics, capabilities and historical Windows builds |
| Accepted product extensions (planned) | Execution boundary, fulfillment intent, composable surfaces/Settings, redacted events |
| Apple Music behavior and integration contract | Provider specification; follow its referenced ADRs |
| Dependency changes | Update policy |
| Packaging and platform decisions | Developer guide, wrapper distribution, license review |