agentleFS
mcdenil-skillsmcdenil-skills/AutoMontage-Agent/skills/reel-turnkey/SKILL.md

reel-turnkey

Skill9 starsChanged 25 days agoMITView on GitHub

Собирает ролик под ключ в AutoMontage-Agent: проверяет исходник, транскрибирует речь, показывает автору черновую нарезку своей съёмки без графики, готовит один полный пакет ТЗ со сценами, текстами, кадрированием, анимацией и аудиопробой, ждёт явного утверждения, рендерит ReelScenes и сам проводит визуальный и звуковой QA. Обязательно используй, когда пользователь просит «смонтируй ролик», «ролик под ключ», «сделай Reels/Shorts», «собери lesson» или даёт видео для монтажа, даже если не называет навык. В новом чате сначала предлагает готовый стиль, уникальный Creative Motion или монтаж по референсу. Запросы анимации без камеры направляет в motion-reel.

  • Reads credentials

The file

Files
SKILL.md

Ролик под ключ

Цель навыка: получить от пользователя короткий запрос, один раз согласовать все творческие решения и отдать готовый ролик без перекладывания технического контроля на пользователя.

Сначала выбери маршрут

Если нужен ролик без камеры, анимационный Reels/Shorts, кинетический текст или видео только из озвучки, передай работу навыку motion-reel и следуй ему до QA. Он использует audio-only проект, отдельную композицию MotionReel и семь motion-сцен. Правила видимого спикера в первые секунды, talking-head хука и --template lesson ниже относятся только к видео со спикером и не переносятся в motion-reel. При обычном монтаже исходного видео продолжай этот навык.

Рекламный или промо-ролик без голоса, ролик из AI-кадров, трейлер под музыку веди по навыку ai-promo: он собирает такой ролик через motion-reel с флагом --music-only.

Сначала покажи выбор монтажа

Прочитай справочник ремесла motion (числа и запреты движения) и контракт выбора и Creative Motion. Если пользователь ещё не выбрал маршрут, до анализа исходника покажи обязательную карточку «Что делаем?» (вопрос «Как монтируем?»): только неясные вопросы о задаче, формате, исходнике и способе монтажа; в «Как монтируем?» – уникальный Creative Motion (рекомендуется), Creative Motion + оверлеи Higgsfield (смета и «да» до генерации), готовый установленный стиль или «Решай сам». Монтаж по референсу – ответ «По ссылке-референсу». Не спрашивай то, что уже ясно; «реши сам» означает Creative Motion. После ответа работай автономно до полного проверенного preview.

Границы навыка

  • Стандартный и готовый маршруты монтируй через --template lesson, утверждённый brief, композицию ReelScenes и 7 официальных сцен: fullscreen, split, bottom-diagram, blur-overlay, text-only, stat, broll.
  • В Creative Motion создай новый арт-дирекшн и project-local motion pack внутри projects/<id>/motion-vNN/. Его полноразмерный слой проходит официальный импорт, нормализацию и SHA-256, затем подключается через поддерживаемую broll-сцену с мастер-аудио исходника. Не добавляй клиентские сцены в общий движок.
  • Не превращай успешный предыдущий ролик в новый шаблон. Повторяемыми остаются только технические стандарты, approval и QA; композиции, типографика и motion-язык выбираются заново под смысл нового ролика.
  • Воронка, кружок спикера, официальные социальные логотипы, анимированный градиент и CTA считаются вариантами готовых сцен.
  • Draft разрешено рендерить только командой automontage preview: тот же ReelScenes, выход только в previews/. Полный 1080p preview собирается в качестве финала без вшитой надписи (ЧЕРНОВИК рисует плеер пульта и Review), фрагмент и 4K – с watermark и пониженным качеством. Ролик со слоем kit на весь хронометраж собирается быстрым путём без Remotion. Всегда называй его полный ролик или указывай точный диапазон фрагмента.
  • Финальный рендер, renders/ и final/ по-прежнему требуют однозначного «утверждаю» и отдельной approved-копии только последней показанной версии ТЗ.
  • Не создавай HTML- или FFmpeg-макет дизайна: визуальное согласование использует только настоящий Remotion-preview.
  • Не выдумывай цифры, факты и цитаты. Редакторские заголовки и CTA показывай на утверждение.
  • Не добавляй в Git исходники, транскрипты, музыку, рендеры, личные пути, ключи и приватные темы.
  • Используй текущую подписку Claude Code/Codex: сам прочитай локальный транскрипт и подготовь draft. Не проверяй, не запрашивай и не используй ANTHROPIC_API_KEY или OPENAI_API_KEY для обычного монтажа. Наличие ключа в окружении не является разрешением на API-вызов.
  • Для явно заказанного изображения сначала используй встроенную генерацию текущей модели. Только если она недоступна, предупреди об отдельном платном OpenAI API и получи явное подтверждение. Такой ключ разрешён только для подтверждённой генерации изображения и ни для чего другого.
  • Никогда не проси прислать API-ключ в чат.

Client-delivery mode

Во время монтажа одного ролика не меняй src/, scripts/, schema/, общие тесты, документацию и тему. Все изменения ролика живут в projects/<id>/. Если возможности не хватает, не разрабатывай её внутри ролика: закончи ближайшим поддержанным вариантом и вынеси доработку движка в отдельную задачу. Для правки только brief запускай его валидацию и preview QA, а не полный npm test. В Creative Motion разрешены локальные React/Remotion-компоненты, сцены, design tokens и assets внутри project workspace; они не становятся общей возможностью движка.

Пакетный режим

Если пользователь передал несколько роликов или несколько вариантов хука как отдельные выходы (A/B), прочитай docs/BATCH-REELS-WORKFLOW.md и веди один общий пакет согласования. Каждый выход получает отдельный projects/<id>/, draft-preview, approval и QA. Общая основа hook-family после точки стыка должна совпадать по речи, сценам, графике, субтитрам и музыке. Несколько попыток одного ролика с одним выходом собираются как дубли (раздел «Несколько дублей одного ролика» ниже); если непонятно, это один ролик (из дублей или из разных записей) или разные выходы, задай один вопрос. Один ролик из нескольких разных записей по сценарию собирается тем же маршрутом дублей.

Инвентаризацию, транскрибацию, черновые нарезки и подготовку активов можно выполнять параллельно; brief каждого ролика – после подтверждения его нарезки (у аватара – после master). Полные Remotion-рендеры в одном checkout запускай последовательно; параллельный render допустим только в отдельных clone/worktree. Обложки готовь отдельно для каждого выхода и храни локально внутри его workspace.

Публичная и приватная темы

  1. Если пользователь указал тему, используй её.
  2. Если задан THEMES_EXT и запрошенная внешняя тема существует, используй её без копирования в открытый репозиторий.
  3. Если внешней темы нет, явно передавай --theme lesson-neutral. Не полагайся на локальный приватный дефолт.
  4. Имя темы и геометрия замораживаются в brief. Изменение любого из них требует нового draft и нового утверждения.

Шаг 0. Восстанови контекст

  1. Убедись, что находишься в корне AutoMontage-Agent.
  2. Прочитай AGENTS.md, локальный MEMORY.md, последние три дневника, релевантный memory/feedback_*.md и _progress.md, если они есть.
  3. Проверь git status, текущую ветку и git log. Выполни git fetch. Если ветка отстала и дерево чистое, примени только fast-forward. Не делай reset и не перезаписывай чужие изменения.
  4. Проверь наличие Node.js, ffmpeg, ffprobe, Python и faster-whisper через npm run doctor.
  5. Не проверяй provider API-ключи и не проси пользователя их добавить. Стандартный workflow работает через текущую подписанную сессию. Наличие ключа не означает согласия; отдельный платный OpenAI-вызов для изображения требует предупреждения и явного подтверждения и допустим только когда текущая модель не умеет сгенерировать изображение сама.

Шаг 1. Прими задачу

Если маршрут ещё не выбран, сначала покажи карточку из references/creative-motion.md и дождись одного ответа. Если пользователь сразу выбрал маршрут, коротко зафиксируй его и продолжай. После этого не задавай вопросы о вкусовых и технических деталях, которые можешь безопасно решить сам; вынеси выбранный арт-дирекшн, CTA и музыку в единый пакет preview для утверждения.

Извлеки из запроса:

  • путь к исходнику;
  • формат: source, vertical или horizontal;
  • площадку и желаемую длину;
  • цель, главную мысль и CTA;
  • обязательные формулировки;
  • тему и музыкальное настроение;
  • логотипы, b-roll и другие обязательные активы.
  • короткое название проекта; если пользователь его не дал, выведи из главной темы ролика.
  • все исходники, количество выходов и семейства вариантов с общей основой.

Дефолты:

  • формат равен исходнику;
  • полная длина исходника;
  • открытая тема lesson-neutral, если не подключена внешняя;
  • современный инструментальный бит с безопасной лицензией, если пользователь просит выбрать музыку;
  • один полный пакет согласования перед полным рендером.
  • для вертикального Reels говорящей головы первые 2–3 секунды сохраняют видимого спикера;
  • для ролика длиной 2–3 минуты используются 3–5 смысловых векторных объяснений.

Задай не более одного уточняющего вопроса, только если без ответа нельзя безопасно продолжать.

Шаг 2. Черновая нарезка

До транскрибации проверь исходник через ffprobe:

  • ширину, высоту, поворот, FPS и длительность;
  • наличие видео- и аудиопотока;
  • частоту дискретизации и стартовые таймкоды;
  • переменный или постоянный FPS;
  • полное декодирование без ошибок.

Извлеки кадры из начала, середины и конца. Определи facePos и faceZoom, чтобы лицо не прыгало между сценами. Паузы и повторы вырезает master по подтверждённой черновой нарезке, а brief делается уже по нему. Не меняй исходник после утверждения.

Для своей съёмки с речью тайминги ролика до слоя и до brief фиксирует автор: когда этап нужен, порядок поиска пауз и повторов, команды и ночной режим – в rough-cut.md. Для расшифровки используй large-v3-turbo с таймингами слов.

  1. Создай или открой workspace через createOrOpenProject() из scripts/project/workspace.js.
  2. Извлеки звук через ffmpeg и запусти локальный scripts/transcribe.py с large-v3-turbo; сохрани слова в transcript/words.json.
  3. Найди паузы и повторы по порядку из rough-cut.md (карта тишины по уровню звука, дословный проход Whisper без VAD, повторы, паузы) и запиши список кусков edit/roughcut-v01.json с причиной каждого выреза в note.
  4. Собери копию для автора и покажи итог, сомнительные места и пульт (automontage pult):

    automontage roughcut --project-dir <project-dir> --edit edit/roughcut-v01.json
  5. Остановись: ход за автором. «Нарезка готова» нажимает только он. Пока нарезка ждёт, готовь всё, что не зависит от таймингов (prep/, assets/, музыка); master, layer new и preview до подтверждения не запускай.
  6. После строки «Нарезка подтверждена» во входящих или явных слов автора в чате (тогда сначала automontage roughcut confirm) собери один master из оригинала по rough-cut.md (с правками автора – из копии edit/vNN-source.json) и переходи к шагу 3. Правки без подтверждения – новый список edit/roughcut-v02.json с этими правками и пункты 4–5 заново.

Если автор до показа сказал «режь сам» или «нарезку не показывай», пункты 4–5 пропусти: собери master из своего списка edit/v02-source.json и переходи к шагу 3.

У аватара (HeyGen и похожие) этап пропускается: оговорок в видео из текста нет. Пункты 4–5 пропусти так же: убери лишние паузы сам, собери master из своего списка edit/v02-source.json и переходи к шагу 3, не дожидаясь автора.

Удаляй только явное молчание, брошенный недоговорённый заход и подтверждённый дубль. Сомнительный повтор оставляй и назови автору – он решит на нарезке. Сначала прослушай оба места и будущий стык. Не определяй повтор только по похожим строкам транскрипта.

Несколько дублей одного ролика

Если пользователь прислал несколько попыток одного ролика, до brief собери master из лучших кусков по references/takes-selection.md: automontage takes add, automontage takes pack, выбор по смысловым блокам и automontage master с edit/vNN-takes.json. Тем же маршрутом собирается один ролик из разных записей по сценарию. Черновую нарезку для дублей не собирай: выбор дублей автор видит в пакете preview. Master уже пересчитывает транскрипт, поэтому Whisper по склейке заново не запускай. Дальше исходник и слова берутся из project.json (source.localPath и transcript.words), а не из input/source.mp4 и transcript/words.json. Выбор дублей покажи в пакете preview таблицей «блок → дубль → причина». Разные ролики и несколько выходов остаются пакетным режимом.

Шаг 3. Создай черновик

Шаг начинается после master по подтверждённой черновой нарезке (или по дублям). Не запускай стандартный API-backed plan path. Вместо этого:

  1. Возьми исходник и слова активной ревизии из project.json: source.localPath и transcript.words. Whisper заново не запускай: master уже пересчитал транскрипт.
  2. Есть призыв с кодовым словом или в личку – запиши обещание по разделу «Обещание в ролике» навыка skills/lead-magnet/SKILL.md или сверь с речью обещание, записанное до съёмки.
  3. Прочитай транскрипт сам в текущей подписанной сессии и создай lesson JSON/Markdown по schema/lesson-brief.schema.json и семи официальным сценам.
  4. Выполни validateLessonBrief() и опубликуй пару только через publishBriefRevision(). Не правь project.json вручную.

Для Creative Motion перед публикацией brief создай ДНК дизайна, карту смысловых вставок и project-local motion pack по references/creative-motion.md (заготовки из prep/, если готовил их, пока нарезка ждала автора). Используй семь типов lesson-сцен как транспорт утверждённого результата, а не как ограничение визуальной композиции: проверенный полноразмерный motion-слой подключается через brollMedia, а голос идёт из мастер-видео по глобальному таймкоду. Слой kit подключается с audioMode: "mix": в его звуке только эффекты. Если в слое нет звука (нет библиотеки или эффектов в плане) – brief слоя собирай с --audio mute. Другой project-local слой по умолчанию немой: audioMode: "mute". Слою со своим текстом добавь overlay: "none", чтобы движок не затемнял его и не рисовал поверх чип, заголовок и окно спикера. Слой поверх спикера или аватара собирай из motion-kit: раздел «Motion-слой из kit» ниже. Brief слоя kit публикует automontage layer brief, вручную его не собирай.

Для внешней темы используй её id вместо lesson-neutral. Результат должен содержать:

  • projects/YYYY.MM.DD_<latin-slug>/project.json с историей работы;
  • brief/vNN-draft.lesson.json со статусом draft;
  • brief/vNN-draft.lesson.md для чтения и утверждения;
  • transcript/words.json с таймингами;
  • отдельные assets/, previews/, renders/ и final/ внутри той же папки.

Сохрани абсолютный путь созданной project-папки. Все следующие команды этого ролика выполняй с --project-dir <этот-путь>. Не возвращайся к общему out/.

После генерации:

  1. Вычитай транскрипт по аудио и покажи все исправления распознавания.
  2. Раздели экранные тексты на дословную речь, редакторские заголовки и CTA.
  3. Построй визуальные события с ритмом 1,5–2,2 секунды. Событием может быть смена сцены, плана, текста или этапа анимации. Это ритм вертикали. В горизонтали 16:9 лицо не мелькает: крупность и позиция спикера меняются не чаще раза в 8 с, только общий W и крупный M, без сдвигов L/R (autoShots(words, { endSec, aspect: 'horizontal', hidden }) с окнами вставок и размытия, гейт G17). Ритм там держит графика – плашки, врезки и анимация меняются свободно.
  4. Не держи длинную цифровую карточку. Разбей её на короткие акценты.
  5. Возвращай fullscreen-спикера в ходе ролика и чаще показывай лицо в последней трети.
  6. Любое пересечение плашки с видео помечай как осознанное. Непомеченное наложение считай дефектом.
  7. В хуке первые 2–3 секунды оставь спикера в кадре; blur, логотип и текст могут лежать поверх, но чистый text-only экран в начале запрещён.
  8. Для 2–3-минутного Reels поставь 3–5 векторных объяснений. Процесс раскрывай поэтапно: блок → соединитель → следующий блок → результат, а не движением одной готовой картинки.
  9. Списки оформляй крупными карточками или дорожками. Сравнимые показатели показывай на общей шкале в одном кадре и явно выделяй победителя.
  10. На полноэкранной векторной графике субтитры скрывай или убирай, если они перекрывают смысл; speaker PIP также отключай при конфликте.
  11. Безопасная зона проверяется по всей анимации, а не только в остановившемся кадре: для 1080×1920 текст и его плашка не пересекают границы left: 70, right: 130, top: 250, bottom: 420 из src/scenes/safezone.js. Не используй отрицательные координаты или translateX, выносящий текст за экран; анимируй внутри безопасного контейнера.

Шаг 4. Подготовь музыку до утверждения

Если музыку выбирает агент:

  1. Используй современный инструментал без вокала и с безопасной лицензией.
  2. Начни с ритмичного участка. Не ускоряй неподходящий трек.
  3. Если трек не понравился, замени его. Не пытайся исправить выбор многократным изменением gain.
  4. Сделай две 10–12-секундные аудиопробы на реальном голосе: рекомендуемый трек и один запасной.
  5. Покажи источник и лицензию в пакете согласования.
  6. Музыку и лицензию храни в assets/music/, аудиопробы в previews/ текущего проекта.

Для разговорного Reels используй как стартовую точку, а не как неизменный рецепт:

{
  "gainDb": -20,
  "ducking": {
    "thresholdDb": -26,
    "ratio": 6,
    "attackMs": 10,
    "releaseMs": 220
  }
}

Сначала нормализуй чистый голос, потом подмешивай музыку через sidechain-ducking. Баланс зависит от голоса. Живая запись (свой голос с микрофона): в речи целься в разницу примерно 12–18 dB между голосом и музыкой по npm run qa:preview; если пользователь просит музыку слышнее, допустимо 8–10 dB. Голос аватара (ElevenLabs или HeyGen), со слоем kit и без него: ориентир – утверждённый эталон, по G8 музыка под речью примерно на 38 LU тише голоса, это около 9 dB по qa:preview (коридор 35–41 LU; трек около −20 LUFS, gainDb −16, ducking −40 dB, ratio 4); правило 12–18 dB к нему не применяй. Просьба сделать музыку слышнее – разрыв меньше на 6–8 LU. В паузах музыка должна подниматься примерно на 6–9 dB. Проверяй фактический микс, а не только цифру gainDb. Для слоя kit баланс проверяет G8 (раздел «Motion-слой из kit» ниже).

Для hook-family общий блок использует тот же трек, фазу, gain и sidechain. Проверь переход на стыке каждого хука: музыка не должна прыгать или перезапускаться без утверждённого замысла.

Шаг 5. Покажи один пакет согласования

Прочитай references/brief-package.md и используй его формат.

В одном сообщении покажи:

  • выбранный маршрут монтажа; для Creative Motion — ДНК дизайна и чем она отличается от прошлых роликов;
  • формат, тему, длительность, кадрирование и CTA;
  • все исправления транскрипции;
  • таблицу каждого визуального события: время, сцена, текст, кадр, анимация и звук;
  • ключевые стоп-кадры в целевом формате;
  • аудиопробы и лицензию музыки;
  • точный путь к Markdown- и JSON-черновикам.
  • для пакета: индекс всех выходов, hook-family, обложки и отдельный QA-статус каждой версии.

Для Creative Motion также покажи карту разных визуальных конструкций и короткий anti-template отчёт: нет повторяющейся композиции, соседних одинаковых механик и пустых чёрных переходов.

Перед просьбой об утверждении собери настоящий draft-preview:

automontage preview --project-dir <project-dir> --brief brief/vNN-draft.lesson.json
npm run qa:preview -- --project-dir <project-dir>

Покажи полный ролик или точный диапазон фрагмента. Заверши фразой: «Напиши “утверждаю” или пришли все правки одним списком». На этом остановись.

Шаг 6. Рендери только утверждённое

Если пользователь нажал «Утверждаю» в пульте на полном 1080p preview, финал обычно уже готов: пульт скопировал просмотренный preview в final/<slug>.mp4 (D-051), карточка «Готов», строки «Утверждено» во входящих нет, а повторная расшифровка финала идёт в фоне – дождись строки «Проверка финала…» и переходи к шагу 7 по этому финалу.

Если после «Утверждаю» в пульте во входящих всё же строка «Утверждено» (фрагмент, 4K, preview прежней версии движка), approveBrief уже выполнен: brief/vNN-approved.lesson.json создан и записан в project.json. Пункты 2–4 пропусти – повторный approve-brief.js откажет, потому что текущий brief уже не черновик, – и сразу запускай рендер (пункт 5).

После явного утверждения в чате:

  1. Убедись, что после показа ТЗ не было новых правок.
  2. Поменяй статус этого brief с draft на approved.
  3. Не меняй утверждённые тексты, музыку, тему, формат и исходник.
  4. Заморозь утверждённую копию и обнови project.json:
node scripts/project/approve-brief.js <project-dir> brief/vNN-draft.lesson.json

Если команда напечатала final: …, просмотренный чистый preview уже стал финалом, а final QA идёт в фоне: пункт 5 пропусти и переходи к шагу 7. Строка финал соберёт рендер: … – выполняй пункт 5.

  1. Запусти:
node scripts/build.js <project-dir>/input/source.mp4 --template lesson \
  --project-dir <project-dir> \
  --brief brief/vNN-approved.lesson.json \
  --version-label first-render

Если исходник менялся через automontage master, вместо input/source.mp4 передай активный source.localPath из project.json.

build.js должен рендерить ReelScenes, сохранять единый таймкод видео, нормализовать голос, компенсировать задержку финального AAC и после этого подмешивать музыку с ducking. Каждая правка получает новый --version-label, например new-music, quieter-music или ducking. Не перезаписывай старую версию.

Шаг 7. Проверь готовый файл

Прочитай references/qa-checklist.md и выполни весь чек-лист. Успешный рендер не равен готовому ролику.

Минимальные доказательства качества:

  • полное декодирование файла без ошибок;
  • геометрия, FPS, кодеки и длительность по ffprobe;
  • A/V-синхрон в начале, середине и конце;
  • контакт-лист со стоп-кадром каждого визуального события;
  • ручная проверка safe-zone, текста, лица, логотипов и наложений;
  • замер музыки под речью и в паузах;
  • сверка всех текстов с утверждённым brief.
  • для hook-family: доказательство, что общая основа совпадает во всех вариантах;
  • для пакета: сводная таблица promised outputs, preview/final и per-item/family QA.

Если любая проверка не пройдена, исправь дефект до показа ролика. Если исправление меняет утверждённое творческое решение, верни brief в draft и покажи изменение на утверждение.

Шаг 8. Отдай результат

В финальном ответе дай:

  1. Кликабельную ссылку на готовый MP4.
  2. Коротко: формат, размер, FPS, длительность и кодеки.
  3. Результат трёх проверок A/V-синхрона.
  4. Как музыка приглушается под голосом и возвращается в паузах.
  5. Ссылку на контакт-лист, если он полезен для приёмки.
  6. Подтверждение, что приватные медиа и тема не попали в Git.
  7. Ссылку на project-папку, где лежат ТЗ, превью и все версии рендера.
  8. Для пакета: одну таблицу всех финалов, обложек и SHA-256, чтобы проверялась именно QA-версия.
  9. Предложение чистки этого ролика – всегда, после финала и QA. Выполни automontage clean --project <папка> --level archive без --yes и покажи ГБ и список файлов (сборка и approve-brief.js уже печатают строку «Можно освободить N ГБ: …»). Команду с --yes запускай только после явного «да» пользователя в чате; без «да» ничего не удаляй.

Для Telegram советуй отправлять ролик как файл, чтобы мессенджер не сжимал вертикаль.

Motion-слой из kit

Слой с аватаром или живым спикером в кадре собирай из motion-kit. Пути – от корня движка; весь путь, команды и гейты – docs/MOTION-KIT.md.

Перед layer new всегда соберите master из подтверждённой черновой нарезки (по умолчанию рабочий 1080p): автор посмотрел её в пульте и нажал «Нарезка готова» или подтвердил словами в чате. Таймингов ещё нет – слой не создаём: пока нарезка ждёт автора, master и layer new отказывают. Master – один раз из оригинала: --edit edit/roughcut-vNN.json или копия edit/vNN-source.json с правками автора; порядок и поздняя оговорка после master (новый master и новый слой, полный круг) – skills/reel-turnkey/references/rough-cut.md. Вырезать нечего – в нарезке один кусок на всю запись по кадровым границам; «режь сам» до показа и аватар (нарезки нет) – свой список edit/v02-source.json. 4K/родной размер – только по явной просьбе пользователя через master --quality source. Далее берите активные source.localPath и transcript.words из project.json; при смене размера старый слой пересоберите, иначе G6 его остановит. Для ролика только из озвучки этот шаг не нужен: master и kit требуют видео.

  1. automontage layer new --project-dir projects/<папка> создаёт motion-vNN/. Субагенту слоя отдай одно задание: skills/reel-turnkey/references/motion-layer-brief.md с этой папкой.
  2. automontage layer check --project-dir projects/<папка> --layer motion-vNN – после каждой правки плана, за секунды: ритм, safe-zone, спикер в хуке, звуки, сток, чужое видео. Сток под вставку – automontage layer stock (без PEXELS_API_KEY клип кладут вручную).
  3. Цикл критика (до рендера preview). Кадры рисуются прямо из композиции слоя, без рендера видео: automontage layer sheet --mode moments --project-dir projects/<папка> --layer motion-vNN кладёт кадры ключевых моментов, лист и телефонный лист в qa/moments-stills-* (слой должен пройти layer check, иначе команда отказывает). Запусти субагента motion-critic (в Codex – отдельного агента с заданием из motion-critic.md); передай ему путь к свежему qa/moments-stills-<sha8>.json, который напечатал layer sheet, и номер круга. Он только читает кадры и отвечает JSON-отчётом. Сохрани ответ в файл и прогони automontage critic --project-dir projects/<папка> --report <файл.json>: команда сверяет отчёт с последними кадрами и печатает решение. При fix («Решение: исправлять») исправь три названные худшие сцены в плане слоя, затем снова layer check → layer sheet --mode moments → критик (не больше трёх кругов). Внутри цикла только кадры: рендер видео внутри цикла запрещён (ни layer render, ни automontage preview). При stop («Решение: остановиться») переходи к рендеру: preview рендерится один раз после stop. В сообщении пользователю назови оценки и причину остановки.
  4. automontage layer render – ждёт слот машинной очереди, проверяет длину слоя и голос в его звуке. Тяжёлые команды (layer render, layer import, preview, final и master) запускай в фоне; при ожидании смотри automontage queue. layer render --no-wait сразу отказывает, если очередь занята; это не обход ограничения.
  5. automontage layer import → automontage layer brief → automontage preview. Preview рендерится один раз после stop цикла критика; он проверяет баланс голоса и музыки; при стопе он не публикуется, в пульте остаётся прошлый.
  6. automontage layer sheet --project-dir projects/<папка> – контакт-лист текущего preview и кадры вокруг новых правок пульта к нему. Команда только предупреждает.

В пульт уходит только preview, у которого отчёты layer check, layer render и preview в qa/ без ❌. Каждое ⚠️ прочитай; исключения (waivers) – только с причиной.

Коридор G8 для аватара откалиброван по утверждённому эталону: под речью музыка примерно на 38 LU тише голоса, предупреждение вне 35–41 LU, стоп ниже 3 или выше 46 LU. layer brief --music <трек> по умолчанию собирает утверждённый рецепт (gainDb −16, ducking −40 dB, ratio 4), и он проходит G8. Попросили музыку слышнее – подними music.gainDb на 6–8 дБ: предупреждение G8 тогда ожидаемо. Против вкуса владельца музыку ради гейта не меняй: если G8 остановил preview, исправь микс по подсказке про music.gainDb или покажи число владельцу.

Правку из пульта вноси в тот же слой (новый слой – только при новом исходнике), затем снова layer check → цикл критика → layer render → layer import → layer brief → automontage preview и automontage inbox --accept. Утверждает только владелец: «Утверждаю» в пульте или «утверждаю» в чате.

Пульт роликов

  • В начале работы выполни automontage inbox и сначала обработай входящие этого ролика.
  • Создавая варианты одной темы (хуки, серию), положи в каждую папку pult-card.json с общим group и подписью variantLabel.
  • Показывая preview, напомни: его можно посмотреть и утвердить в «Пульте роликов» (automontage pult).
  • Выполненную правку из пульта отмечай: automontage inbox --accept <папка> <id> (имя папки без projects/).
  • Черновую нарезку подтверждает только автор: кнопкой «Нарезка готова» или явными словами в чате (automontage roughcut confirm). Никогда не вызывай /api/roughcut/confirm. Строку «Нарезка подтверждена» во входящих выполняй по references/rough-cut.md: правки, master, затем слой.

Когда остановиться

Остановись и сообщи конкретную причину, если:

  • исходник не найден или не декодируется;
  • выбор формата противоречит явному запросу;
  • запрошенная приватная тема не найдена;
  • музыка или логотипы не имеют понятного источника и лицензии;
  • Git-обновление конфликтует с незакоммиченными изменениями.

Не останавливайся из-за технического дефекта, который можно безопасно исправить внутри утверждённого замысла.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.