Documentation
README
suggest-sfx — the SFX pass
Take a rendered, voiced short and add tasteful sound effects, synced to the visual beats and the narration, drawn from a shared, growing SFX library. Work collaboratively and beat-by-beat; the user audits the plan and gives notes.
The shape: a declarative plan (sfx-plan.json) is the source of truth → a tool consumes it
(tools/mix_sfx.py) → a library grows (media/library/sfx/) → a hard USER-AUDIT gate
before anything is mixed.
Sound taste is a brand contract — read brand.md §7 every time. The house style is calm/premium
(Linear / Anthropic / Vercel), felt-not-heard, always under the voice. NOT MrBeast-loud.
Inputs (read these first, every session)
This is the opening of the README. Read the full README on GitHub.