keunwoochoi/physical-instruments.js

finalize-pr

Bring a PR to merge-ready state without merging it - verify GitHub issue linkage, review gates, current-head evidence, and follow-up routing. Usage - finalize-pr <PR number>

原文语言：英语

panel-review

Run the full 7-persona USER panel on the product — instruments, sound, UI, public API, and what a visitor lands on. Required before merging instrument, public-API, or user-visible packaging changes. Not for harness/CI/internal-docs changes. Usage -…

原文语言：英语

review-as

Shared persona-review engine. Review a PR/diff/design through exactly one persona lens. Usage - review-as <keunwoo|hayoung|yotam|juhan|jordan|senior-web-dev|producer> <PR number|diff|design-doc path>

原文语言：英语

match-reference

LLM-driven auto-research loop - iteratively evolve a physical model's equations and parameters until its render matches reference recordings, guided by spectral/envelope/loudness metrics. Usage - match-reference <instrument> [reference.wav]

原文语言：英语

audit-dynamics

Does harder playing change both LOUDNESS and TIMBRE, the way a real instrument does — not just get louder, and not the same at pp and ff. Usage - audit-dynamics <instrument>

原文语言：英语

audit-envelope

The time-domain shape — the ATTACK (how the note speaks) and the DECAY/release (how it dies). A note that starts or ends wrong is as fake as one with the wrong spectrum. Usage - audit-envelope <instrument>

原文语言：英语

audit-headroom

No note, at any velocity, may clip or ride the master limiter — and every instrument sits at a matched loudness. Clipping is invisible to RMS gates and corrupts every other measurement. Usage - audit-headroom <instrument>

原文语言：英语

audit-stability

No NaN, no denormals, no runaway — across the full range, every velocity, sustained for seconds, and for self-oscillators, robust ignition and a limit cycle that holds. Usage - audit-stability <instrument>

原文语言：英语

audit-tune

Does the instrument play the pitch it was ASKED for, across its whole range and at every velocity — the most basic failure there is, and the hardest to see by eye. Usage - audit-tune <instrument>

原文语言：英语

audit-voice

The instrument's HARMONIC CHARACTER — does it lead with the fundamental like the real thing, and does it have ONE committed voice instead of a washed-out average. Usage - audit-voice <instrument>

原文语言：英语

instrument-quality-matrix

Apply every quality aspect (audit-tune/voice/dynamics/envelope/headroom/stability) to every instrument, in the right order, and track the scorecard. The comprehensive pass. Usage - instrument-quality-matrix [instrument]

原文语言：英语

wrap-session

Close a progressive or stacked work session without starting new scope - reconcile exact heads, evidence freshness, published-branch topology, blockers, and deterministic resume points in GitHub. Usage - wrap-session [tracker issue]

原文语言：英语

harness-audit

Audit and repair the agent harness itself - cross-tool skill exposure, frontmatter, links, GitHub templates, authority defaults, and owner-surface boundaries. Usage - harness-audit

原文语言：英语

dsp-bench

Measure DSP cost against the audio-thread budget. Run on every DSP change; CI tripwire mode fails on regression. Usage - dsp-bench [--ci]

原文语言：英语

new-design-doc

Scaffold a dated design doc for any feature bigger than one PR, from the template. Usage - new-design-doc <topic-slug>

原文语言：英语

port-audit

Run before and during any port of third-party DSP code. License ledger check + legacy-flaws checklist. Usage - port-audit <source> <files>

原文语言：英语

run-evals

Render the fixed MIDI corpus through the current build and incumbents; emit AB/ABX comparison page and spectral regression diff. Usage - run-evals [instrument|arrangement]

原文语言：英语