# Copilot Instructions — MixBoard

> **Last updated**: 2026-03-13

---

## Workspace Overview

MixBoard is a **macOS native music player** built with Swift 5.9 and SwiftUI, targeting macOS 14+ (Sonoma).

### Key Features
- Audio playback via AVAudioEngine with 3-band EQ
- BPM and key detection
- Waveform visualization
- 14 retro skins
- DAW export (Audition, Bitwig, REAPER, etc.)
- Cue points, playlists with folders
- Lyrics fetching from LRCLIB
- SwiftData for persistence

### Active Integration: Chad Music
Cloud music integration with [Chad Music](https://gogs.chad-partners.com/chad-partners/chad-music) — a self-hosted Common Lisp music server. See `.orchestra/knowledge.md` for architecture decisions and full spec at Work vault `.orchestra/mixboard-chadmusic/spec.md`.

## Tech Stack
- **Language**: Swift 5.9
- **UI**: SwiftUI
- **Platform**: macOS 14+ (Sonoma)
- **Data**: SwiftData
- **Audio**: AVAudioEngine (local), AVPlayer (cloud streaming)
- **Build**: Xcode / xcodegen (project.yml)

## Conventions
- Source code in `Sources/`
- Tests in `Tests/`
- Project config in `project.yml` (xcodegen) and `Package.swift`
- Build instructions in `INSTRUCTIONS.md`

## Orchestra
Multi-model deliberation engine is active. Config at `.orchestra/config.json`, knowledge at `.orchestra/knowledge.md`. No domain pack — general mode.