mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-19 19:36:04 +00:00
Audit found two docs still carrying the OLD 0.2-0.35 SFX prescription after the natural-level stance landed in commitcd5f6bcc: 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 incd5f6bcc, 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.