Skip to content

Commit df2cc3e

Browse files
vanceingallsclaude
andcommitted
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>
1 parent 0caf449 commit df2cc3e

1 file changed

Lines changed: 31 additions & 0 deletions

File tree

plans/audio-fx-ux/README.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -97,6 +97,37 @@ property print as their escape sequence on the page. This cost three rounds of
9797
chasing what looked like three unrelated rendering bugs. The template is a plain
9898
literal; keep it that way, and use HTML entities for typographic characters.
9999

100+
## The hole in the single-knob rule: picking the range
101+
102+
`Shape One Range` has three controls — where, how much, how wide — and the
103+
copy nominated *how much* as the one that matters. That is incoherent, and it
104+
took someone asking to see it: boosting an unspecified frequency means nothing.
105+
**The range is the first decision, not the second.**
106+
107+
Two ways out:
108+
109+
**A — two controls.** Keep the module generic and make *where* a word from the
110+
shared vocabulary rather than a frequency field. Honest, and the ruler does the
111+
teaching, but it is still two decisions and the first is jargon in a friendly
112+
coat.
113+
114+
**B — the range IS the module.** The add menu offers *jobs* — Reduce Mud, Add
115+
Clarity, Tame Harshness — each a peaking node with its frequency already
116+
chosen. Picking the module is picking the range, so one knob is honest rather
117+
than a simplification hiding the real choice.
118+
119+
**B is the answer**, and it is the same insight as the EQ: an author does not
120+
want a parametric equaliser, they want to fix a thing. It also dissolves the
121+
duplicate-name problem at the root rather than papering it with a role label —
122+
`Clean Voice` reads *Remove Rumble · Reduce Mud · Even Out Loudness · Add
123+
Clarity · Peak Ceiling*, and nothing repeats.
124+
125+
Option A is not wasted: its band picker is exactly the right control for moving
126+
the frequency under **Details**, for the author who wants to.
127+
128+
This changes the catalogue, not just the copy: the presets should reference
129+
named jobs, and `EFFECT_COPY.peaking` stops being one entry.
130+
100131
## Proposed: a multi-band EQ ("Tone")
101132

102133
The clearest failure this exercise surfaced is a rack holding two *Shape One

0 commit comments

Comments
 (0)