Practice Studio — PRD (design + execution spec)

_v1 · 2026-10-03 · owner Byron · live target https://music.arnao.ai/_

Plan + first critique: https://practice-plan.arnao.ai/ · Mockups: https://practice-plan.arnao.ai/mockups/ · Teacher critique: critique/teacher.md

1. Goal

One installable web app (PWA, offline) on the Galaxy Z TriFold (unfolded 2160×1584, 204.8×150.2 mm) that makes Byron measurably better at piano, guitar and ukulele:

2. Non-goals (v1)

Strumming on glass · audio chord recognition from scratch (we only verify an expected chord) · copyrighted lyrics/melodies · accounts/cloud sync · iOS.

3. Users & device

Byron only. Samsung Galaxy Z TriFold, Chrome. Landscape, unfolded. Also usable folded (cover screen) for the 90-second "daily changes" habit loop and chord lookup (v1.1).

4. Screen math (settled)

5. Features (v1 scope, in build order)

5.1 Calibration (E)

Card outline, nudge, ruler, instrument-measure alternative. Persist pxPerMm.

5.2 Instruments & chord library

5.3 Song catalog

5.4 Strumming / rhythm (new, from teacher)

5.5 Fretboard trainer (A, C)

5.6 Listening (mic)

5.7 Piano (B)

5.8 Song player (D)

5.9 Guided session (home)

5.10 Recorder

5.11 Posture card

One illustrated checklist per instrument at session start + "prop the phone at stand height".

6. Architecture

Static site, vanilla ES modules, no bundler, deployed to Vercel (music.arnao.ai). index.html + js/*.js + css/app.css + sw.js + manifest.json. All state in localStorage (small) and IndexedDB (recordings). No backend. Module contracts in EXECUTION.md.

7. Acceptance

8. Risks

Palm rejection on Samsung panels (spike first) · Chrome mic latency 60–150 ms (fine for grading, not for play-along sound) · DPR/zoom changes (re-calibrate) · copyright (modern songs = chords only, no lyrics or melody).