Микширует голосовую дорожку и амбиент через sidechaincompress в ffmpeg. Ambient автоматически уходит на -10dB пока говорит voice. Используй для всех voice-over видео (Mystic, MViC, Travel, Tutorial). Корень типичной проблемы «голос тонет в музыке» или «музыка перебивает голос» — это решает.
Пока нет рефлексий. Запиши через ~/.claude/bin/append-reflection.py после следующего вызова.
## 🔴 ЖЕЛЕЗНОЕ ПРАВИЛО: Read ЗАПРЕЩЁН для PDF, изображений и офисных документов
Инструмент Read НЕ извлекает текст из этих форматов — он возвращает только размер файла,
а агент решает, что прочитал, и выдумывает содержимое. Проверено измерением 2026-08-25.
- PDF: `pdftotext "файл.pdf" - | head -300`
- PDF-скан (pdftotext дал пусто): `pdftoppm -r 150 -png "файл.pdf" /tmp/p`, затем `tesseract /tmp/p-1.png stdout -l rus+eng`
- PNG/JPG/скриншот: `tesseract "файл.png" stdout -l rus+eng`
- DOCX/ODT: `pandoc "файл.docx" -t plain | head -300`
- XLSX: `libreoffice --headless --convert-to csv --outdir /tmp "файл.xlsx"`, затем `cat /tmp/*.csv`
- Read допустим ТОЛЬКО для txt, md, кода, DXF, json, yaml
Конвертер вернул пусто или ошибку — ОСТАНОВИСЬ и скажи честно «файл технически не прочитал».
НЕ выдумывай ни одной цифры, реквизита, адреса или позиции сметы. Полные правила: ~/.claude/RULES.md §0.
## КРИТИЧЕСКОЕ ПРАВИЛО: Реквизиты и документы
При работе с юридическими данными (реквизиты, адреса, ИНН, ОГРН, договоры):
1. **НИКОГДА не генерируй реквизиты самостоятельно**
2. **ВСЕГДА читай существующие файлы проекта**:
- `state_dir/company_info.md` или `.json`
- `state_dir/contracts/` (предыдущие договоры)
- `state_dir/documents/requisites.md`
- Спроси Макса где лежат актуальные данные
3. **Если файла нет — ОСТАНОВИ работу и спроси Макса**, не выдумывай:
> "Нужны реквизиты компании. Где найти актуальные данные?"
4. **Проверь ВСЕ реквизиты перед отправкой**:
- ИНН: ровно 10 или 12 цифр
- ОГРН: ровно 13 или 15 цифр
- Адрес: полный, с индексом
- Название: точное совпадение с учредительными документами
Галлюцинация реквизитов = юридические проблемы для Макса.
## INVARIANTS — never override
1. Только через `sidechaincompress` ffmpeg-фильтр. Не ручной volume-keyframing.
2. Дефолтные параметры: `threshold=0.02:ratio=10:attack=50:release=500`. Менять только при явной необходимости.
3. Ambient громкость в финальном миксе: -10 до -15 dB (volume=0.18-0.32).
4. НЕ обрезать концы ambient до тишины — пусть растекается за voice (естественнее).
5. Финальный output: stereo (2 channel), 44100 Hz, AAC 160k.
6. Если voice отсутствует (только музыка) — НЕ применять sidechaincompress, просто amix.
## Назначение
Соединить voice-over и ambient так, чтобы голос всегда был выше музыки автоматически. Источник техники: `SecondBrain/4-KNOWLEDGE/topics/sound-design-mystery-shorts.md`.
## Когда вызывать
- При сборке voice-over видео (Mystic, Travel, MViC tutorials)
- Когда нужно подложить музыку под подкаст/интервью
- При финальной сборке short-form с voiceover
## Когда НЕ вызывать
- Чистый music video (без voice) → просто amix
- Если voice уже смикширован с музыкой в исходнике
- Для голосовых сообщений / коротких уведомлений без музыки
## Команда (template)
```bash
ffmpeg -i voice.wav -stream_loop -1 -i ambient.wav \
-filter_complex "
[1:a]volume=0.18[amb];
[amb][0:a]sidechaincompress=threshold=0.02:ratio=10:attack=50:release=500[duck];
[duck][0:a]amix=inputs=2:duration=first:normalize=0[mix]
" \
-map "[mix]" -ac 2 -ar 44100 -c:a pcm_s16le \
output.wav
```
Объяснение filter_complex:
1. `[1:a]volume=0.18[amb]` — ambient на ~-15dB (база)
2. `[amb][0:a]sidechaincompress=...[duck]` — compressor с side-chain от голоса. Когда голос громче threshold — ambient давится с ratio:10
3. `[duck][0:a]amix=...[mix]` — финальный микс ducked-ambient + raw voice
## Параметры (если нужно тонкая настройка)
| Параметр | Дефолт | Когда менять |
|---|---|---|
| `threshold` | 0.02 | Если голос тихий — снизить до 0.01 |
| `ratio` | 10 | Если ambient слишком давится — снизить до 6 |
| `attack` | 50 (ms) | Если ducking слышно резко — поднять до 100 |
| `release` | 500 (ms) | Если ambient медленно возвращается — снизить до 300 |
| `ambient volume` | 0.18 | Для драмы — 0.12, для тёплого фона — 0.25 |