7zones/premium-film

Premium Film

Crie vídeos em código que sigam as diretrizes da marca, que contenham apenas fatos verificados e que tenham aparência e som profissionalmente produzidos. "O proprietário" abaixo é a pessoa para quem você faz o filme, muitas vezes repassando o feedback de um cliente. Os exemplos vêm de filmes reais de clientes (case-studies.md).

O padrão é "premium, polido… pixel perfeito". O que falhou, nas palavras do proprietário: "essas pílulas parecem baratas", "meio básico… apenas seguindo o roteiro", "transição tão estranha", "muito rápido, não consigo ler", "cai estranhamente", "a voz é meio jovem", "as imagens parecem tão falsas", "um mudo e depois um boom é demais".

As regras

1. Informação correta acima de tudo. Cada fato, nome, cargo, número, data, citação, logotipo e pronúncia é verificado em uma fonte primária antes de ir para a tela ou para a narração, e verificado novamente quando algo muda. Nunca invente ou adivinhe; quando uma fonte estiver faltando, verifique-a ou pergunte. Títulos oficiais são copiados literalmente, logotipos vêm apenas dos próprios arquivos do proprietário, organizações reais têm suas fotos reais (cabeças inteiras, sem halos, sem rostos gerados). Demonstrações de produtos usam apenas dados claramente fictícios (domínios que não resolvem, IPs de documentação, nomes inventados). Uma única afirmação errada desfaz todo o resto do filme.
2. Premium em cada componente. Tipo, cartões, ícones, UI, gráficos, transições, luz, voz, música e som são cada um projetados para este filme com um padrão de alta qualidade — nada de stock, modelado ou "bom o suficiente". Construa cada ideia como uma peça de movimento grande e projetada para um propósito, com espaço negativo; capturas de tela e gravações de tela reais parecem "baratas" mesmo com uma câmera se movendo sobre elas. Sem rótulos de pílula, chips numerados, tags em caixa alta rastreadas ou metadados unidos por ponto. Imagens geradas servem apenas como placas ou ativos e são verificadas em 100%.
3. Profundidade, luz, uma câmera em movimento — e quadros completos. Layouts planos (texto à esquerda, cartão à direita, fundo simples) parecem "sem graça". Momentos de destaque ganham um cenário iluminado: um chão que reflete, objetos virados em 3D, luz que viaja, poeira no ar, uma câmera que nunca para completamente. Cada quadro deve funcionar como um pôster: camadas de profundidade, uma fonte de luz, o herói preenchendo o quadro (texto legível em um telefone), nunca um elemento pequeno em um vazio escuro. Os pontos do briefing são um mínimo, não o design.
4. Cada transição é um movimento real. Um movimento de câmera, uma luz ou um elemento que viaja de uma cena para a próxima. Nunca um flash branco plano, nunca um pop; acertos têm alguns quadros de ataque.
5. Ritmo legível e uniforme. Títulos ficam ≥ 2 s, resultados ≥ 3 s após sua linha; listas revelam um item de cada vez; a energia permanece uniforme entre os capítulos. Nunca amontoe conteúdo para atingir uma duração.
6. A narração é sagrada. Nunca estique o tempo ou aperte suas pausas: corte palavras e regrave em vez disso. Respire entre as linhas, um pouco mais nas viradas de capítulo. Cada capítulo começa com uma linha que se conecta ao anterior. Uma voz e um modelo por idioma para todo o filme e cada correção; deixe o proprietário escolher pelo ouvido.
7. A música chega e carrega. A resolução cai exatamente no clímax visual e a música continua sob a próxima linha; ela nunca se esvazia quando a imagem atinge o pico, nunca troca de peça com um corte brusco e fica contida no final.
8. Verifique como um editor. Você não pode assistir ou ouvir o filme, então sirva como seus sentidos: folhas de contato de cada cena em cada idioma, tiras de quadros em cada transição, stills em tamanho real de cada momento de texto, a verificação automática de falhas e áudio, volume por linha, e uma revisão de IA cujas afirmações você confirma nos quadros antes de agir. Um corte não verificado dessa forma não está pronto.
9. Assuma o controle do ciclo, relate com clareza. Decida padrões sensatos e diga o que decidiu; pergunte apenas pelo que está verdadeiramente fora do seu controle (uma foto faltando, uma chave, dinheiro). Relate sem nomes de arquivos ou códigos: o que mudou, o que foi verificado, o que não foi, onde estão os arquivos, qual deles enviar.

O guia completo de gosto, com a razão por trás de cada regra, está em quality-bar.md. Leia-o antes de projetar.

O que você está fazendo

Escolha o tipo de filme primeiro; ele decide a forma (detalhes e tempos em case-studies.md):

Tipo	Típico	Narração	Imagens
Showcase de produto	60–100 s, um corte por idioma	geralmente nenhuma; linhas na tela, legendas opcionais	peças de movimento personalizadas projetadas das ideias principais do produto; apenas dados fictícios
Filme de marca / organização	2–4 min, um idioma principal + outros cortes	um narrador	fotos reais da organização, pessoas e eventos + design em movimento; cada afirmação verificada
Abertura de evento / conferência	1,5–3 min, roteiro do cliente	profundo e contundente	cenários 3D cinematográficos, fotos com profundidade reconstruída, nomes e logotipos oficiais, um clímax que marca o título do evento
Teaser / promo curta	15–45 s	uma linha curta por batida, ou nenhuma	uma ideia em três batidas: gancho, virada (o momento do herói), nome

A maquinaria é a mesma para todos os tipos: Remotion (React) renderiza a imagem em 1080p60; um arquivo de linha do tempo dirige imagem, narração, música e legendas; Python em Docker faz a narração, trilha sonora, som e mixagem; medições e uma revisão de IA verificam o resultado; um script de lançamento renderiza em partes e empacota a entrega.

Início: descubra o que está disponível

Execute tools/setup.sh no novo projeto. Ele termina com tools/providers.py, que verifica as chaves no .env (nunca as imprime), pergunta a cada serviço o que ele oferece hoje e escolhe o melhor por trabalho: o mais novo Gemini Flash para revisar imagem e som, vozes para audição (ElevenLabs e Gemini TTS), e o mais novo GPT Image para placas. OpenRouter é preferido (uma chave, muitos modelos, um limite de gastos visível); uma chave gratuita da API Gemini sozinha ainda cobre narração e revisão; sem chave, o filme ainda recebe tipo projetado, música composta, todas as verificações e o lançamento. Se uma chave ausente reduzir a qualidade, pergunte à pessoa uma vez — a redação, alternativas e regras de dinheiro estão em providers.md. Confie nas escolhas atuais da ferramenta em vez de qualquer nome de modelo nestes documentos.

Fluxo de trabalho

Trabalhe nas fases em ordem em um novo filme; em uma revisão, pule para a fase que o feedback toca, depois execute revisão e lançamento novamente. Copie esta lista de verificação para suas anotações e marque-a:

Progresso do filme:
- [ ] 0 Configuração: ferramentas disponíveis, chaves verificadas, orçamento acordado
- [ ] 1 Levantamento: briefing citado, arquivos da marca, entregas acordadas, máquina verificada
- [ ] 2 Fatos: ficha de fatos com fonte e status para cada afirmação, lista de evitar
- [ ] 3 Roteiro: idiomas definidos, narração na linha do tempo, cada palavra na tela em cada idioma
- [ ] 4 Storyboard: uma ideia por capítulo, transições planejadas, uma amostra de visual mostrada
- [ ] 5 Construção: cenas a partir de cues, stills verificados em cada idioma
- [ ] 6 Narração: voz testada e travada, cada linha cortada OK, limpa, medida
- [ ] 7 Som: trilha sonora, efeitos, mixagem (voz ≥ 6 dB sobre música em cada linha)
- [ ] 8 Revisão: folhas, tiras, varreduras, revisão de IA; cada achado corrigido ou explicado; fatos re-verificados
- [ ] 9 Lançamento: saídas verificadas, zip testado, estado entregue commitado, proprietário informado onde e o que enviar

1. Levantamento

• Leia tudo o que o proprietário enviou (briefing, roteiro, PDF de relatório, capturas de tela de chat, filmes anteriores). Cite suas palavras em docs/brief.md com o registro da rodada; anote redação obrigatória e nomes oficiais.
• Colete a verdade da marca da fonte: arquivos de logotipo oficiais, paleta do CSS do site ou do PDF da marca, fontes que cobrem cada idioma do filme (acentos, diacríticos, outros scripts), nomes de produtos e redação da UI em cada idioma.
• Defina os idiomas e entregas com antecedência (masters por idioma, cortes legendados, .srt, miniaturas, o zip); se o proprietário já tiver um pacote de uma rodada anterior, espelhe-o exatamente.
• Verifique a máquina: disco livre, Docker em execução, outras renderizações ou sessões no mesmo filme (dois agentes em um filme sobrescrevem o trabalho um do outro; se você encontrar um, pare e pergunte quem é o dono).

2. Pesquisa e fatos

• Leia as fontes reais: tools/webpage.sh <url> <nome> renderiza uma página em um navegador real e salva seu texto e uma captura de tela; quando um site estiver offline, siga a lista de alternativas em story-and-research.md (uma cópia de arquivo, outras fontes públicas, depois o proprietário) em vez de adivinhar.
• Execute um subagente de pesquisa com o briefing em story-and-research.md: cada fato recebe fontes datadas e um status (VERIFICADO / FONTE-ÚNICA / AUTORRELATADO / NÃO-VERIFICADO / DECLARADO-PELO-PROPRIETÁRIO), além de uma lista de evitar. Filmes de produto: leia o código e a redação do produto real para que cada rótulo, número e fluxo na tela exista no produto.
• Escreva docs/factsheet.md. Nada vai para a tela ou para a narração a menos que esteja lá com um status; números autorrelatados são atribuídos.

3. História e roteiro

• Escolha a estrutura para o tipo de filme, então escreva a narração como uma peça falada: linhas de conexão em cada virada de capítulo, listas dobradas em frases, números escritos como são falados. Escreva cada idioma nativamente, não como uma tradução; nunca faça uma voz dizer nomes de um idioma que ela não fala — mostre o nome, apresente a pessoa pelo cargo.
• Coloque as linhas em src/film/timeline.ts, quebras de legenda marcadas com " | " (e onScreen: true em uma linha que o filme mostra como tipo projetado, para que sua legenda saia do caminho), e cada palavra na tela em src/film/script.ts para cada idioma (sua lista LANGS define os idiomas do filme; o primeiro é o master).

4. Visual e storyboard

• Uma ideia por capítulo, cada um com seu próprio conceito visual, um momento de herói, e uma forma de entrar e sair que passe algo para o vizinho. Escreva em docs/storyboard.md.
• Decida onde o 3D real, fotos com profundidade reconstruída ou placas geradas valem a pena (remotion-craft.md). Mostre um quadro ou clipe representativo para qualquer coisa que mude o visual antes de construir um conjunto completo.

5. Construção

• Inicie o projeto: <skill>/scripts/new_film.sh <dir> <Film-Name> (o nome se torna os nomes dos arquivos entregues), depois tools/setup.sh. O iniciador é um filme funcional — linha do tempo, relógio da cena, legendas, finalização, kit de vidro e tipo, bloom, chão espelhado, poeira, luz, fotos de profundidade, três cenas de exemplo, o motor de áudio e todas as ferramentas abaixo. Substitua as cenas de exemplo; mantenha a arquitetura.
• Linha do tempo primeiro: cenas, momentos de cue nomeados e slots de narração vivem em src/film/timeline.ts; cenas animam a partir dos cues (cuesOf(scene, lang)); npm run cues passa os mesmos números para o áudio. Mude o tempo apenas lá.
• Para um filme longo, divida as cenas entre subagentes construtores paralelos com o padrão de briefing em remotion-craft.md; você continua sendo o diretor e verifica cada relatório nos quadros.

6. Narração

Método completo em narration.md. Escreva o perfil do narrador e as notas do diretor; reescreva o que a voz erra em audio/vo/say.json; teste vozes do que tools/providers.py encontrou e deixe o proprietário escolher; grave cada lote em uma solicitação (tools/vo_prompt.py → tools/tts.py), corte e verifique cada linha (tools/cut_lines.py), limpe e nivele-as, e meça se as correções ainda soam como o mesmo narrador (tools/voice_score.py). Trave a voz exata, modelo e prompt no README.

7. Música, som, mixagem

Método completo em music-and-sound.md. Por padrão, componha uma trilha sonora livre de licenças em código que muda nos momentos de cue da imagem; corte uma faixa licenciada em sua grade de compasso apenas quando o proprietário fornecer uma. O design de som atinge cues nomeados. A mixagem diminui a música por linha, masteriza para −14 LUFS com margem para o encode AAC, e imprime uma tabela voz-vs-música.

8. Revisão (a cada rodada, antes de mostrar qualquer coisa)

Lista de verificação completa em review-and-qa.md: pré-visualizações e folhas de contato em cada idioma, tiras em cada transição, stills em tamanho real de cada momento de texto e legenda, tools/qa_scan.py em cada renderização, tools/audio_qa.py em cada mixagem e arquivo entregue, e tools/review.py (o mais novo Gemini Flash assistindo e ouvindo uma pequena cópia do filme inteiro). Aja apenas em flags concretas que você possa confirmar; suas preferências A/B, identidade de voz e julgamentos de texto pequeno não são confiáveis. Re-verifique cada fato na tela contra a ficha de fatos.

9. Lançamento e entrega

tools/release.sh (release-and-delivery.md) constrói tudo: verificação de narração, trilha sonora e mixagem por idioma, legendas, miniaturas, masters e cortes legendados renderizados em partes, unidos, verificados de pico, contados de quadros, zipados. REDO= re-renderiza apenas as partes tocadas; LANGS=, VOICE= para subconjuntos e versões de voz; ZIP_ONLY=1 re-empacota. Verifique as saídas, commite o estado entregue, atualize o README, e informe o proprietário exatamente onde o pacote está e que é seguro enviar.

10. Rodadas de feedback

working-with-owner.md: trate capturas de tela de chat e mensagens no meio da tarefa como o briefing da rodada; verifique novos fatos primeiro; corrija o padrão em todo o filme, não apenas no quadro mostrado; mantenha o que o proprietário não criticou; execute revisão e lançamento novamente; responda ponto a ponto. Salve cada preferência duradoura onde a próxima sessão a encontrará.

Ferramentas no projeto iniciador

Execute-as; leia seu código apenas se uma falhar (as primeiras linhas de cada ferramenta dizem o que ela faz e como chamá-la). Ferramentas Python são executadas em imagens Docker construídas por tools/setup.sh (film-audio e film-asr; setup.sh all adiciona film-voice e film-depth): docker run --rm -v "$PWD":/p -w /p <imagem> python <ferramenta> .... Ferramentas Node, zsh e Swift são executadas no host.

Necessidade	Ferramenta (da raiz do projeto)	Executa em
configurar, verificar chaves e modelos	tools/setup.sh [all], tools/providers.py	host / film-audio
ler um site (texto + captura de tela)	tools/webpage.sh <url> <nome>, tools/webpage.sh archive:<domínio>:<slug>	host
obter logotipo de um site	tools/fetch_logo.sh <url>	host
verificar ortografia em todas as línguas	tools/spellcheck.sh	host
obter paleta de cores de um site	tools/palette.py <url>	film-audio
verificar fatos contra a ficha de fatos	tools/factcheck.py	film-audio
renderizar pré-visualizações de cena	npm run preview <scene>	host
revisão de IA de um filme renderizado	tools/review.py <arquivo-do-filme>	film-audio
varredura de QA de um render	tools/qa_scan.py	film-audio
QA de áudio de um arquivo de áudio	tools/audio_qa.py <arquivo>	film-audio
audição de voz (amostras)	tools/tts.py --list-voices, tools/tts.py --voice <id> --text "..."	film-voice
gerar narração do roteiro	tools/vo_prompt.py, tools/tts.py	film-voice
cortar e verificar linhas de narração	tools/cut_lines.py	film-audio
medir similaridade de voz	tools/voice_score.py	film-voice
compor trilha sonora	tools/score.py	film-audio
mixar áudio final	tools/mix.py	film-audio
construir camadas de profundidade	tools/depth.py	film-depth
lançar e empacotar entrega	tools/release.sh	host

Referências

• quality-bar.md — O guia completo de gosto para cada regra
• case-studies.md — Exemplos reais de filmes de clientes com detalhes e tempos
• providers.md — Provedores de IA, chaves, alternativas e regras de dinheiro
• story-and-research.md — Pesquisa de fontes, verificação de fatos e subagente de pesquisa
• remotion-craft.md — Técnicas de design em movimento com Remotion, 3D e fotos com profundidade
• narration.md — Método completo de narração: perfil, audição, gravação, corte e verificação
• music-and-sound.md — Composição musical, design de som e mixagem
• review-and-qa.md — Lista de verificação completa de revisão e QA
• release-and-delivery.md — Script de lançamento e formato de entrega
• working-with-owner.md — Lidando com feedback e rodadas de revisão