NotchBeat — handoff package

Three docs, meant to be dropped into the project repo root and read by Claude Code before it writes any Swift:

• PRD.md — what we're building and why, feature list, MVP scope
• ARCHITECTURE.md — tech stack, module breakdown, the private-API tradeoffs (trackpad gestures + optional MediaRemote), risk register
• PHASE_PROMPTS.md — one prompt per build phase, in order, each with acceptance criteria

Suggested handoff flow

1. Create the Xcode project folder, drop these three files at the root
2. git init, first commit with just these docs
3. Open Claude Code in that folder, paste Phase 0's prompt
4. Work phase by phase — review + commit between each, don't skip ahead

Key calls already made (see PRD §7 for the table)

• Spotify Web API for metadata (not the private MediaRemote route) — v1
• Stylized idle animation for the notch visual, not real audio-reactivity — v1
• Lock-screen feature deferred to Phase 6, built as a custom recreation — the real macOS lock screen can't host third-party UI, no way around that

Phase 5 (trackpad gesture) and any future MediaRemote work are the only pieces relying on private/undocumented frameworks — that's why this can't ship on the Mac App Store (see ARCHITECTURE.md §2).