diff --git a/docs-site/src/profiles.md b/docs-site/src/profiles.md
index 7d100e6..90461f7 100644
--- a/docs-site/src/profiles.md
+++ b/docs-site/src/profiles.md
@@ -14,7 +14,7 @@ workflow — see [Building a Sound Library](sound-library.md).
 ## Orchestration profiles
 
 ```yaml
-# orchestration.yaml
+# orchestration.yaml — minimal teaching example (two roles)
 schema_version: 1
 name: hybrid-cinematic
 default_palette: ensemble
@@ -25,6 +25,14 @@ palettes:
     profile: ../renderers/scoredata-symphonic.yaml
 ```
 
+The ScoreData companion ships a fuller `hybrid-cinematic.yaml` with **11**
+palettes: arrangement roles `default` / `solo` / `ensemble` / `electronic`,
+plus thin vocal colours (`choir_male`, `choir_female`, `voice_solo`,
+`choir_aahs`, `voice_oohs`, `choir_treble`, `voice_whisper`). Vocal palettes
+are intentionally thin (only `choir` / `voice` / `choir_pad`); supporting
+tracks stay on an arrangement role. See
+[Building a Sound Library](sound-library.md#vocals-scoredata-vocal-palettes).
+
 ```bash
 scorekit schema --orchestration
 scorekit orchestration check orchestration.yaml
@@ -34,7 +42,8 @@ scorekit --json orchestration check orchestration.yaml
 `orchestration check` loads every referenced leaf profile relative to the
 orchestration file, resolves every leaf profile's `.sfz` paths, and fails
 loudly — with no partial output — if a palette's leaf profile or any mapped
-SFZ file is missing.
+SFZ file is missing. A build takes **exactly one** `--orchestration` file;
+layer multiple identities with per-track `palette:`, not multiple flags.
 
 Each scene track carries a stable `id` and an optional `palette`
 (`[a-z][a-z0-9_-]{0,63}`, same syntax as `id`). A track that omits `palette`
diff --git a/docs-site/src/sound-library.md b/docs-site/src/sound-library.md
index 42277a0..817e34e 100644
--- a/docs-site/src/sound-library.md
+++ b/docs-site/src/sound-library.md
@@ -114,6 +114,23 @@ CC0-1.0 unless noted.
 | Button Accordion HN | 2024-03-29 | |
 | MuldjordKit (acoustic drums) | 2020-10-18 | CC-BY-4.0 |
 
+### Vocals (ScoreData vocal palettes)
+
+| Library | Version | License | Channel / notes |
+|---|---|---|---|
+| VPO Vocals (male/female/mixed) | 3.2 waves + 3.3 scripts | VPO mixed-open (no repackaging) | Local `scoredata-fix1` strips `delay_random`; male exposed via `scoredata-choir-male` palette |
+| Legato Vocal Tutorial (Hadzi-Fia a) | 0.100 | CC0-1.0 | `github.com/sfzinstruments/legato_vocal_tutorial` — solo `a` vowel only |
+| MuseScore GM vocal extract | 0.2.0 | MIT (from MuseScore General) | Deterministic extract of GM 52/53/54/91 → `libraries/musescore/gm-vocals/0.2.0` (Aahs/Oohs/Synth/Space + treble/whisper filters) |
+
+Orchestration entrypoints (ScoreData companion):
+
+| file | default | notes |
+|---|---|---|
+| `profiles/orchestrations/hybrid-cinematic.yaml` | `default` | **General cinematic entry** — 11 palettes: arrangement roles `default` / `solo` (chamber) / `ensemble` / `electronic`, plus thin vocals `choir_male` / `choir_female` / `voice_solo` / `choir_aahs` / `voice_oohs` / `choir_treble` / `voice_whisper`. One `--orchestration` per build. |
+| `profiles/orchestrations/scoredata-vocals.yaml` | `mixed` | Vocals-only short names (`male`, `female`, `solo`, `aahs`, `oohs`, `treble`, `whisper`) over the **same** thin leaf profiles. |
+
+Thin vocal palettes map only `choir` / `voice` / `choir_pad` — put supporting instruments on `default` (or another arrangement role). `treble` is a high-pass filter colour, not a children's choir; `whisper` is a soft filter, not breath phonation. World/ethnic sung vocals remain an honest coverage gap.
+
 ### Community one-offs
 
 | Library | Version | License | Channel |
diff --git a/docs/research/open-sample-libraries.md b/docs/research/open-sample-libraries.md
index 863bd18..524763e 100644
--- a/docs/research/open-sample-libraries.md
+++ b/docs/research/open-sample-libraries.md
@@ -103,6 +103,8 @@ scorekit 当前构建脚本固定 sfizz 1.2.3。sfizz 官方 1.2.3 README 同时
 - **sfizz 风险：中到高**。教程的价值恰恰在复杂 legato/CC/include；scorekit 当前 articulation 只选文件，不会主动发送这些控制状态。只能先取最简单的 polyphonic patch 做实验。
 - **官方来源**：[项目说明](https://github.com/sfzinstruments/legato_vocal_tutorial) · [CC0 LICENSE](https://github.com/sfzinstruments/legato_vocal_tutorial/blob/main/LICENSE) · [v0.100 下载](https://github.com/sfzinstruments/legato_vocal_tutorial/releases/tag/v0.100)
 
+**ScoreData 状态（2026-08-03）：** 已安装并认证。仅映射 polyphonic no-legato `a` 元音为 `scoredata-voice-solo` palette 的 `voice`。多元音第二套 choir/voice 色彩改由 MuseScore General GM 52/53/54/91 确定性提取（`musescore/gm-vocals`）提供；VPO male 经 `scoredata-fix1` 暴露为 `male` palette。不要把教程的 multi-vowel 模块当完整库（v0.100 未附带 o/u/e 样本）。
+
 ## 暂不纳入短名单
 
 | 项目 | 分类 | 暂不采用的原因 | 官方证据 |