# TOOLS.md — Video Producer

## Пути

- Workspace: `/home/kira/.openclaw/workspace-video-producer`
- Skill: `/home/kira/.openclaw/workspace-video-producer/skills/video-producer`
- **Canonical projects root: `/home/kira/videoproduction`**
- Project template: `/home/kira/videoproduction/_template`

## Хранение проектов

- Все project data, библии, scene packets, refs, shot logs и production notes хранить в `/home/kira/videoproduction`, чтобы они были доступны из единого производственного каталога.
- Workspace хранит агентные файлы, навыки и служебный контекст.
- Если создаётся новый video project — заводить его сразу внутри `/home/kira/videoproduction/<project-slug>/`.
- Все сгенерённые ассеты (refs, stills, video tests, approved variations, промежуточные generation results) не только сохранять в проекте, но и обязательно приносить в чат Дмитрию. Файл на диске без показа в чате не считается доставленным результатом.
- Каждый запуск генерации обязан сопровождаться временным follow-up / cron-style task.
- Если генерация ещё не готова, follow-up нужно повторять до завершения.
- Если генерация готова, follow-up обязан не только сообщить об этом, но и отправить сам результат в чат.
- Снимать follow-up можно только после доставки ассета.

## Модели и маршруты

- Still default: Nano Banana 2 для сложных сцен, персонажей, постановки, связности.
- Still alternative: Wan 2.7 только по явной причине или просьбе Дмитрия.
- Video default: Atlas → Kling O3 PRO reference-to-video / image-to-video от утверждённого still. Не Together, не Veo, не Seedance как основной путь без отдельного решения Дмитрия.

## Правило прикладываемых референсов

- Если в Atlas / Wan / Kling / still generation запрос прикладываются ref-изображения, их нужно явно назвать в самом промпте.
- В тексте промта указывать либо имя персонажа/локации с reference image, либо прямой URL / имя файла рефа.
- Недостаточно просто передать `images[]`; модель должна получить явную текстовую привязку, что это за refs и как их использовать.

## Правило 6 location views

- Для location packs `view_01`–`view_06` — это не 6 разных интерпретаций пространства.
- Это directional coverage одной и той же утверждённой локации: Восток, Юг, Запад, Север, верх, низ.
- Меняться должны только направление камеры и высота точки.
- Геометрия, двери, окна, мебель, материалы и световая семья должны оставаться теми же.
- Если модель выдаёт 6 разных пространств, это failure, а не валидный pack.

## Запреты

- **ИГНОРИРОВАТЬ `image_generate action=list`** — это встроенные модели OpenClaw (gpt-image-2, Gemini, fal, comfy и т.д.). Они НЕ являются нашим production pipeline.
- **Использовать ТОЛЬКО Atlas Cloud API** (`https://api.atlascloud.ai/api/v1`) для all still и video generation.
- Музыкальный слой не считать готовым production workflow.
- Не запускать «сразу видео» для связного проекта без утверждённого still.
- Не смешивать слои `corporate`, `dorama`, `cinema`, `advertisement` без явного решения.