Объясняющий ролик: от текста к раскадровке и записи (references/storyboard.md)

Источник: ds-internal/presentations/component-video-skill/references/storyboard.md — справочник скилла astra-component-video

Объясняющий ролик — видео-презентация с голосом диктора о процессе, формате или решении. Пример — design-contract-v3 (3 мин 17 с, 13 кадров): что такое дизайн-контракт, что ломается сейчас, что решили, первые результаты.

Длинный ролик не собирается сразу. Сначала раскадровка — черновик, который автор комментирует кадр за кадром. Озвучка и рендер — только после неё: переозвучить три минуты дороже, чем поправить слайд.

1. Источник

Тексты и цифры — только из источника: сценарий автора, колода, документ, вывод команды, журнал изменений. В примере это сценарий для подрядчика, колода в Figma и файлы репозитория. Своего не добавлять.

У каждого числа — источник и дата: файл и запрос, которым оно снято. Число со слов автора без источника помечается и уходит вопросом (шаг 2).

2. Раскадровка — колода для комментариев

Колода слайдов, где автор может оставить комментарий на любом кадре: артефакт со слайдами, Figma, Google Slides. Нет инструмента — Markdown-таблица «кадр · картинка · голос · откуда».

Состав колоды:


Обложка	тема, версия, «черновик для комментариев: ничего не озвучено и не отрендерено»
Порядок кадров	весь ролик на одном экране: карточки «номер · блок · название», сгруппированы по блокам; новые кадры выделены цветом
Кадр — по слайду на каждый	слева — макет картинки в цветах ролика; справа — «Голос»: текст диктора дословно; «Откуда»: источник текста и цифр
Откуда цифры	таблица: кадр · число · источник · статус («проверено 20.10», «нужен источник»)
Ушло из ролика	что вырезано и где ему место: отдельный ролик, регламент, встреча
Что решить до записи	3–5 вопросов автору: источник цифр, имена, длина, финальная фраза

Сюжет — 3–4 блока с вопросом-заголовком: «Что это → Что ломается сейчас → Что решили → Итог». Заголовок кадра станет caption сцены, макет — типом сцены (references/scenes.md), текст «Голос» — массивом voice.

Тексты кадров и голоса — по инфостилю (references/infostyle.md): главное в начале, одна мысль на кадр, без командного жаргона для широкого зрителя («мастер», «ось», «сверка в ноль» заменить обычными словами). В слайдах раскадровки неразрывные пробелы ставить самим (раздел 10); в ролике их ставит движок.

3. Правки по комментариям

Автор комментирует кадры: «после 7», «убрать», «объединить с 3», новый текст. Правки вносятся в колоду, вопросы снимаются. Версия ролика растёт: design-contract → -v3 — прежний файл данных и рендер остаются для сравнения.

4. Ролик по блокам

Первый блок отдельным роликом (<ролик>-what, 3–4 кадра, около минуты): на нём автор утверждает голос, темп и вид сцен. Пробы голоса — два-три коротких ролика с тем же текстом (мужской и женский голос по описанию).
Утвердили — весь ролик одним файлом данных. Блоки из пробного ролика переносятся без изменений; ссылка на раскадровку и источники всех блоков — в шапке файла данных.
Финальная фраза — сцена quote с hold: 2.5: мысль держится на экране дольше.

5. Сборка и проверка

node tools/build.mjs <ролик> --no-render
<python с faster-whisper> -I -X utf8 tools/voice_check.py <ролик>
node tools/build.mjs <ролик>

Снимки — по два на кадр: проверить, что текст на экране совпадает с тем, что звучит, и ничего не налезает на шапку и подвал. Отмеченные проверкой голоса фразы — прослушать.

В отчёте: длина, кадры по блокам, источник каждого числа, что ушло вопросом к автору, модель голоса и её лицензия.