Files
hyperframes/skills/website-to-hyperframes/references
ukimsanov 83e570c042 fix(skill): SFX volume = natural across all docs (background-music + capabilities)
Audit found two docs still carrying the OLD 0.2-0.35 SFX prescription
after the natural-level stance landed in commit cd5f6bcc:

1. background-music.md (volume hierarchy table) — the SFX row read
   "Sound effects (hits) | 0.2 – 0.35". The canonical SFX file
   (skills/hyperframes/references/sound-effects.md) was updated in
   cd5f6bcc, but background-music.md's parallel table was missed. An
   agent reading the music doc to set up BGM would also see this
   table and pre-duck SFX they should leave natural.

   Fixed by updating the SFX row to "natural (omit `data-volume`)"
   and adding a paragraph below the table that names the canonical
   source-of-truth (sound-effects.md) and notes the one exception
   (ambient bed at ~0.1 — the "felt, not heard" texture case).

2. capabilities.md (audio mixer example) — the canonical example
   `<audio>` tag was written with `data-volume="0.8"` inline. That's
   a structural example (not specifically SFX), but the literal 0.8
   reads as a recommendation when scanned. Updated the example to
   omit `data-volume` (since it's optional) and added an inline note
   that the attribute is optional with a default of natural / 1.0,
   pointing at background-music.md + sound-effects.md for the per-
   layer guidance.

Memory `project_hyperframes_sfx_catalog.md` also updated in this
turn (separate file outside the worktree, in ~/.claude/projects/):
the SFX wire spec there still cited `data-volume(0.2-0.35 under VO)`
as the contract. Updated to reflect the natural-level stance + the
catalog-as-source-of-loudness reasoning, with a pointer at the
commit that landed the change.

Closes the audit's punch list for SFX-volume consistency. The full
matrix is now:

  sound-effects.md   → "Volume — default is natural, no auto-duck"
                       + nudge-ranges table (cd5f6bcc)
  background-music.md → SFX row reads "natural (omit data-volume)"
                       + reference paragraph to canonical source
  capabilities.md    → audio mixer example omits data-volume + notes
                       it's optional
  step-3-storyboard.md → "Volume — default natural" + trust-the-mix
                       prose (cd5f6bcc)
  step-5-build.md    → no SFX volume prescription (correctly silent)
  beat-builder-guide → no SFX volume prescription (correctly silent)
  assemble-index.mjs → emits data-volume only when cue.volume is set
                       (cd5f6bcc)
  memory feedback_sfx_volume_no_vo.md → updated to natural-level
                       stance with timing-alignment emphasis (cd5f6bcc)
  memory project_hyperframes_sfx_catalog.md → updated this turn

Zero remaining surfaces with the old prescription.
2026-06-12 02:23:58 -07:00
..