Files
hyperframes/plans
Vance IngallsandClaude Opus 5 804bc1e888 docs(design): fix the hole in the single-knob rule — picking the range
Shape One Range has three controls (where, how much, how wide) and the copy
nominated "how much" as the one that matters. That is incoherent: boosting an
unspecified frequency means nothing. The range is the FIRST decision, not the
second, and the rule broke on this module without my noticing.

Two ways out, both drawn. A keeps the module generic and makes "where" a word
from the shared vocabulary instead of a frequency field — honest, but still two
decisions with the first one jargon in a friendly coat. B makes the range the
module: the add menu offers jobs — Reduce Mud, Add Clarity, Tame Harshness —
each a peaking node with its frequency already chosen, so one knob is honest
rather than a simplification hiding the real choice.

B is the answer, and it is the same insight as the multi-band EQ: an author
does not want a parametric equaliser, they want to fix a thing. It also
dissolves the duplicate-name problem at the root instead of papering it with a
role label — Clean Voice now reads Remove Rumble, Reduce Mud, Even Out
Loudness, Add Clarity, Peak Ceiling, and nothing repeats.

Option A is not wasted: its band picker is the right control for moving the
frequency under Details.

This changes the catalogue rather than only the copy — presets should reference
named jobs, and EFFECT_COPY.peaking stops being a single entry.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-12 00:47:56 -07:00
..