soundlisted

# sound nereus:common 규칙을 따른다. 담당 에이전트: art-director. **엔진과 무관하다** — 로블록스든 Unity든 Switch든 같은 기준으로 판정한다. ## 0. asset 과의 경계 | | 담당 | |---|---| | 소리를 **만드는** 것 (TTS·SFX·BGM 생성, 포맷 변환, 반입) | `nereus-game:asset` | | 만든 소리를 **어떻게 쓸지** (예산·배치·피드백·믹스) | 여기 | 합치지 않는 이유: `asset` 의 범위는 "엔진 반입 직전까지"다. 사운드 설계는 반입 **이후**의 문제다. 소리가 전부 있어도 동시 발음수가 터지거나 같은 SFX 가 반복되면 게임은 여전히 나쁘게 들린다. ## 1. 계획을 JSON 으로 적는다 ```json { "maxConcurrent": 12, "loudnessLufs": -14, "cues": [ { "name": "jump", "variants": 3, "actions": ["jump"] }, { "name": "coin", "variants": 4, "actions": ["pickup", "purchase"] } ], "actions": ["jump", "pickup", "purchase", "land"] } ``` - `actions` 는 플레이어가 하는 **모든** 동작이다. 여기 있는데 어떤 큐에도 매핑되지 않으면 그 동작은 소리 없이 일어난다 — 검사기가 `no-feedback` 으로 잡는다. - `variants` 를 1 로 두지 않는다. 같은 소리가 반복되면 몇 분 만에 귀에 띈다. ## 2. 검사 ```bash echo '{"genre":"obby-platformer","plan":{...}}' | node "${CLAUDE_PLUGIN_ROOT}/lib/sound-budget.mjs" ``` 기준은 장르 프로파일의 `sound` 키에서 온다 — 스킬 안에 수치를 박지 않는다. 프로파일에 `sound` 기준이 없으면 통과가 아니라 `no-baseline` 이 나온다. **조용한 통과는 없는 게이트보다 나쁘다.** | 위반 코드 | 뜻 | |---|---| | `no-baseline` | 장르 프로파일에 `sound` 기준이 없다 | | `concurrency` | 동시 발음수가 상한을 넘는다 | | `variants` | 그 큐의 변형이 최소 개수 미만이다 | | `loudness` | 라우드니스가 목표 범위 밖이다 | | `no-feedback` | 그 동작에 대응하는 큐가 없다 | ## 3. 적응형 음악 상태 전이를 **선언**하고, 각 전이에 도달 조건과 복귀 조건을 같이 적는다. 복귀 조건이 없는 전이는 한 번 들어가면 못 나오는 상태다 — 라이브옵스의 롤백 경로와 같은 문제다. ## 4. 접근성 소리로만 전달하는 정보가 있으면 시각 대체를 같이 둔다. 소리를 못 듣는 환경(음소거·청각 장애)에서 그 정보가 사라지면 그건 설계 결함이다.