multi-video-variants
Transforma UM mestre aprovado em N saídas sem perder o controle de qual arquivo veio de qual estado fonte. É dona da matriz de variantes, do congelamento do mestre, das cópias re-layout, do mix compartilhado, da nomenclatura, da fila de uma renderização por vez, das regras de supervisão de agentes e do portão do manifesto. Ela não projeta o mestre (a skill de tipo faz isso) e não substitui a QA por arquivo (render-qa-deliver).
Regras que estão acima do resto deste arquivo
- Mestre primeiro, depois congelado. Derivados são feitos apenas a partir de um mestre que passou sua própria QA completa e foi registrado com
manifest_check.py freeze. Uma correção necessária depois é feita no MESTRE, registrada comchange, levada para cada cópia na mesma rodada, e TODO derivado é re-renderizado e re-registrado. Corrigir apenas uma cópia é proibido. - Re-layout, nunca crop. Cada proporção é uma cópia da fonte mestre (
hf_9x16/,hf_1x1/...) com sua própria tela, zonas seguras, escala de tipo, trilho de legendas, chaves de câmera e centralização de rosto. Um crop ou escala FFmpeg de um mestre renderizado não é uma variante. - Um mix. Re-layouts e variantes de gancho usam o mesmo
cues.jse os mesmos bytes deassets/mix.wave são multiplexados a partir desse único arquivo; o áudio não é reconstruído por variante. Uma variante que realmente precisa de seu próprio mix (sem música, narração própria, corte de duração) declara isso no manifesto com um motivo. - Um trabalho pesado por vez em toda a máquina (render,
check, matte, ASR, Blender) sobrender_lock. Trabalho paralelo é limitado a tarefas não pesadas (layout, spec, leitura de QA). No máximo 4 agentes em paralelo, cada um com no máximo 2 sub-agentes. - "Pronto" é computado, não afirmado. A palavra é permitida apenas quando
manifest_check.py checksai com 0. Um timeout, pasta vazia, hash ausente,qa: not_runou evidência ausente éblocked/INSUFFICIENT_EVIDENCE, nuncapass. - Nenhuma ação paga sem
paid-generation-gate; nunca mensagem outra sessão Claude; restrições de usuário e projeto substituem este procedimento. Zonas seguras, -14 LUFS e telas são house preset v1 (decisão padrão Q5), não lei da plataforma.
Entradas -> Saídas
In: mestre aprovado (hf/, PROMPT.md, DESIGN.md, cues.js, assets/mix.wav) e a matriz de variantes da intake. Out: final/<nome>_<plataforma>_<gancho>_<proporcao>.mp4 x N, final/manifest.json (finals + manifesto apenas), relatórios de QA por arquivo sob _work/qa/<proporcao>/<rodada>/, _work/agents/<agent>.progress.md, _work/STATE.md (fila).
Nomeação: <nome>_<plataforma>_<gancho>_<proporcao>.mp4, <nome> um slug ASCII minúsculo (underscores permitidos), <plataforma> = meta|tiktok|yt|ig|linkedin|x|all, <gancho> = master | hookA | hookA-nomusic | hookA-nocaps, <proporcao> = 9x16|4x5|1x1|16x9. Também aceito: a forma curta por proporção <nome>_<proporcao>.mp4 (plataforma all, gancho master, como no playbook de entrega). Um nome que o usuário pediu no ledger substitui a convenção e é registrado com seu ledger id (record --name-ledger-id).
Procedimento
| # | Etapa | Faça | Artefato |
|---|---|---|---|
| 0 | Matriz na intake | uma linha de ledger por arquivo: proporção, plataforma, rota (orgânico / ad / spark), gancho, versão (completa, sem música, sem legendas, duração), proporção mestre. Proporções "talvez" tardias: escreva notas de layout agora para que um pedido tardio seja um agente, não uma reconstrução (references/variant-matrix-and-layout.md) | matriz em PROMPT.md <inputs>; lista matrix no manifesto |
| 1 | Portão do mestre | mestre aprovado, QA de todos os quadros do render-qa-deliver passou, manifest_check.py freeze <project> --hf hf --matrix ... | src_hash congelado + mix_sha256 |
| 2 | Cópias re-layout | um agente por proporção em uma CÓPIA; mesmos cues e mix; preencha a tabela de layout (o que mudou por elemento, references/variant-matrix-and-layout.md); preflight 0 erros; snapshot overlay no gancho, oferta, cartão final (--describe false, no máximo 5 timestamps por chamada) | hf_<proporcao>/, _work/qa/<proporcao>/layout.md |
| 3 | Variantes de gancho / versão | gancho = sub-composição vinculada a variáveis na cópia da proporção, uma linha por variante; teste UMA variação primeiro (variáveis de lote não são testadas em um projeto); multiplexe o mix compartilhado; sem música / sem legendas = mix declarado ou variantes de camada | rows.json, arquivos de variante |
| 4 | Fila | escreva a ordem de renderização em _work/STATE.md (mestre, depois cada proporção, depois variantes); manifest_check.py stamp ANTES de cada render; renders através de hf_deliver / render_lock run um de cada vez; um dono de render nunca inicia um segundo trabalho pesado | log de lock, stamps |
| 5 | Registro | após cada render: record (hashes, correções mestre aplicadas, variante de mix, estado QA, loudness medido no arquivo FINAL) | manifest.json |
| 6 | QA por saída | frame_qa, caption_qa --band <top>:1450 (9:16), motion_qa se layout mudou movimento, face_center audit para filmagem de locutor, qa delivery; eixos de revisão visual apenas 1 (composição/crop) e 4 (legibilidade); eixos 2-3 herdados a menos que movimento tenha mudado | relatórios + caminhos de evidência |
| 7 | Portão de pronto | manifest_check.py check <project> --json sai com 0; mostre ao usuário a lista de arquivos com hash fonte, estado QA, LUFS/TP; liste lacunas honestamente | Relatório PRONTO |
| 8 | Aprender | linhas de ledger de timing por arquivo, lições para a Inbox | _work/timing_ledger.jsonl |
Portões
Estados são pass | fail | blocked | n/a com um motivo. Um timeout, amostra vazia ou entrada ausente é blocked, nunca pass. Uma chamada de ferramenta bem-sucedida é evidência de execução; um render visualizado é evidência de aparência.
| Portão | Predicado | Evidência | Se falso | Dono | Revisar quando |
|---|---|---|---|---|---|
| G1 matriz | toda saída tem uma linha de ledger (proporção, plataforma, rota, gancho, versão) antes de qualquer construção | matrix em PROMPT.md e manifesto | pergunte o eixo ausente agora; não construa | esta skill + video-intake | qualquer novo pedido de proporção/variante |
| G2 mestre congelado | mestre passou QA completa; freeze registrado; nenhum derivado iniciado antes | manifesto master.src_hash, frozen_utc mais antigo que todo stamp | pare derivados; congele | esta skill | qualquer mudança na fonte mestre |
| G3 re-layout | cada derivado tem sua própria tela raiz, linha de layout por elemento, zonas seguras de sua proporção; nenhum render mestre cortado | linhas layout.md + snapshots overlay + preflight 0 E | re-layout do elemento falho; não escale o quadro inteiro | o agente da proporção | mudança no layout mestre, nova cópia |
| G4 ativos compartilhados | cues.* e assets/mix.wav idênticos ao mestre em toda cópia de re-layout/gancho; variantes de gancho multiplexam, não re-mixam | manifest_check.py check: sem M035/M041 | copie cues/mix do mestre de volta; re-renderize | esta skill | mudança de cue ou mix mestre |
| G5 QA por saída | cada arquivo qa: pass com um arquivo de evidência e LUFS -14 +/- 0.5, TP <= -1 no arquivo final (portão da casa) | caminho qa_evidence, números lufs, tp no manifesto | corrija e re-renderize APENAS aquele arquivo | render-qa-deliver | qualquer re-render |
| G6 disciplina de trabalho pesado | exatamente um trabalho pesado por vez; <= 4 agentes, cada um <= 2 sub-agentes, cada um com lista de arquivos, arquivo de saída, prazo, arquivo de progresso | log render_lock; mtimes de _work/agents/*.progress.md | enfileire, pare o trabalho extra (apenas sua própria árvore de processos) | esta skill | cada lançamento de agente |
| G7 manifesto pronto | desatualizado / órfão / ausente / alterado-após-render todos ausentes | manifest_check.py check sai com 0 | liste os arquivos falhos para o usuário; re-renderize os desatualizados | manifest_check.py | antes de dizer "pronto", após qualquer mudança |
Números (house preset v1, datado de 2026-10-02, detalhes em references/house-presets.md)
- Telas: 9:16 1080x1920, 4:5 1080x1350, 1:1 1080x1080, 16:9 1920x1080; H.264 SDR yuv420p, AAC 48 kHz, 30 fps padrão.
- Zonas seguras, texto-chave/CTA/logo/preço: 9:16 topo 300 / fundo 672 (y <= 1248) / esquerda 140 / direita 192, trilho de legendas fundo <= y 1450; 16:9 x <= 1824, topo 54, fundo 162; 4:5 e 1:1 54 px cada lado. Não verificado em dispositivos: execute o exercício de overlay.
- Loudness: -14 LUFS integrado +/- 0.5, pico verdadeiro <= -1 dBTP, medido no arquivo final; mix intermediário TP <= -1.5.
- Supervisão: verificação de batimento cardíaco a cada 15 min aproximadamente; silencioso ou além do prazo por 20 min = verifique, substitua ou pare; linha de status para o usuário a cada 10 min de silêncio aproximadamente; timeout de render 3x o ETA medido. (fonte: workflow destilado 02 §13.6, 2026-10-01)
Regras de decisão
| Se | Então |
|---|---|
| uma correção mestre é necessária após derivados existirem | corrija o MESTRE, change, leve o patch para toda cópia, re-renderize e re-registre todos |
| uma cópia precisa de timing ou cues diferentes | isso é uma mudança no mestre; ou uma nova edição (recut) com suas próprias linhas de ledger, nunca uma bifurcação silenciosa |
| um gancho precisa de uma linha falada diferente | declare own-vo com um motivo; toda outra variante permanece no mix compartilhado |
| uma proporção é solicitada tarde | escreva a tabela de layout, lance UM agente em uma cópia do mestre congelado; não toque no mestre |
| dois renders são solicitados de uma vez | enfileire-os; o lock decide; escreva a ordem em STATE.md |
| um agente está silencioso além do prazo | verifique seu arquivo de progresso, então substitua ou pare (apenas sua própria árvore de processos), depois render_lock status |
| a pasta finals contém um render antigo | mova para _work/delivered/v<N>/; "pronto" é bloqueado até que a pasta corresponda ao manifesto |
| o usuário nomeia os arquivos | o nome deles vence; registre com --name-ledger-id e mantenha campos de plataforma/gancho/proporção explícitos |
Estados bloqueados (relate-os, não os contorne)
manifest_check.py BLOQUEADO ou EVIDÊNCIA INSUFICIENTE; um derivado com from_master desatualizado ou uma correção mestre ausente; uma fonte alterada-após-render; desvio de cues ou mix compartilhados; qa não pass; uma variante prometida ausente; um arquivo não planejado presente. Diga qual arquivo, qual código e a correção.
Armadilhas que custam tempo real
Pedido tardio de 16:9 na entrega (um re-layout completo, descartado); uma correção mestre de 3.7 s não levada para o 1:1; um render antigo deixado ao lado dos novos e ninguém sinalizou; um agente derivado que encontrou um bug mestre e corrigiu apenas sua cópia; três agentes renderizando ao mesmo tempo (um job Blender paralelo dobrou um render, 11.5 para 21.5 min, laptop do dono); colisões de nomeação entre cortes do Meta e TikTok; uma variante de gancho carregando silenciosamente um mix diferente. Uma folha de contato visualizada de cada proporção ainda é necessária: hashes não podem ver uma legenda sobre um rosto.
Referências (carregue quando)
references/variant-matrix-and-layout.md- escrevendo a matriz, re-layout de uma proporção, variantes de gancho/sem música/sem legendas/duração.references/manifest-schema.md- registrando arquivos, lendo descobertas demanifest_check.py, o ciclo de vida de derivado desatualizado.references/parallel-and-agents.md- lançando agentes, fila, lock, batimentos cardíacos, parando, orçamento de token.references/house-presets.md- antes de citar qualquer tela, zona segura, loudness ou número de plataforma (módulo datado).agent-content/references/platform-specs.md(fatos canônicos de plataforma, de propriedade de outro lugar) eagent-content/playbooks/wf-08-deliver.md(playbook de entrega: nomeação, regras de manifesto) - predefinições de exportação e o playbook; se um número diferir, o arquivo canônico vence ereferences/house-presets.mdé atualizado.- Outras skills:
render-qa-deliver(QA por arquivo),hebrew-captions-asr(trilho de legendas),edit-ad-promo(ranqueamento de gancho),revision-round(notas entre proporções),paid-generation-gate. - Scripts:
scripts/manifest_check.py(--self-check29 casos, saída 0 PRONTO / 1 BLOQUEADO / 2 EVIDÊNCIA INSUFICIENTE) escripts/test_manifest_check.py(teste unitário).