video-director-previs
Tome decisões criativas caras no estágio mais barato. Esta skill é responsável pela pré-produção: direção, história, roteiro, storyboard, styleframes, animatic, música, SFX, voz, escolha do motor, QA, revisão, versões e aprovação. Os motores (HyperFrames, video-shotcraft, Remotion, motion-reel, bang-motion, Diffusion Studio) só constroem o que o proprietário aprovou.
Exemplo prático: examples/crumb-previs/ (um aplicativo fictício de divisão de contas). Seu pacote de dados é o filme de demonstração no Previs Studio (_shared/previs/studio/films/011-crumb/).
O aplicativo nunca muda por filme. O Previs Studio é um aplicativo React + TypeScript fixo (fonte _shared/previs/app/, veja seu README). npm run build lá faz type-check, empacota e incorpora em _shared/previs/studio/index.html e _shared/previs/page/index.html (template); adicione um destino em scripts/inline.mjs para cada página por filme. npm run smoke testa a página construída no Chrome real em desktop, tablet, celular e tela cheia (capturas de tela com --out). Nunca edite manualmente o index.html construído.
O que o proprietário recebe: Assistir (player estilo vídeo com tela cheia verdadeira, pré-visualização por hover-scrub, cartão final; modo de comentário que nomeia a menor parte sob o ponteiro, role para maior ou menor, arraste uma caixa em torno de várias partes, caneta e seta, arraste pela linha de cenas para um intervalo de tempo; faixas de som com formas de onda, batidas, curva de duck, solo/mute/volume e SFX arrastáveis que se encaixam na batida), escolhas que reproduzem seu momento no lugar com som, comparação lado a lado, segure para ouvir o original, Storyboard (cartões que reproduzem sua cena no lugar, Reproduzir tudo, escolhas por cena, uma folha de cenas), Plano (diretor chefe, história, equipe de direção, visual, som, ativos, produção, verificações, versões com "pedir para desfazer", exportação de especificação), uma revisão guiada, Pergunte ao diretor, busca ⌘K, desfazer/refazer, temas claro e escuro, dicas de ferramentas em cada controle. Os filmes chegam apenas como pacotes de dados.
Dois lares, mesmo aplicativo
- Previs Studio (todos os filmes):
_shared/previs/studio/. Adicionar um filme = adicionarfilms/<id>/previs.json+films/<id>/audio/...e uma linha emfilms.json. Localmente:python3 -m http.server --directory _shared/previs/studio(ou a entradaprevis-studioem.claude/launch.json). - Página por filme:
projects/NNN/previs/page/contém uma cópia do mesmoindex.html(título<Product> Previs),films.jsoncom uma linha cujopathé"",previs.jsoneaudio/. - Como um Artefato do claude.ai (apenas Claude): publique a página com
capabilities: {"db": {}, "user": {}, "sample": {}, "comments": {}, "downloads": true}.dbarmazena notas e escolhas,samplealimenta Pergunte ao diretor,commentscarrega "Enviar para Claude Code",downloadsa exportação da especificação. Sem elas, a página ainda funciona e salva no navegador. - Caminhos do banco de dados: comentários (solicitações de alteração fixadas no filme; a coleção mantém o nome antigo)
films/<id>/notes(kindframe, region, range, sound, shot, revert ou request;target,targets,box,strokes,quickchips,t/t2,pickseversionno momento); escolhas e ajustes de somfilms/<id>/state/picks(tweaks:<scene>.<sfx>{dt, db},lane.vo|music|sfx{db},mix.duck{on}); opções adicionadasfilms/<id>/state/custom; aprovaçãofilms/<id>/state/approval; status do Claudefilms/<id>/state/claude; atividadefilms/<id>/activity; notas (pensamentos livres sobre o filme como um todo: leia-as como contexto, nunca como tarefas)films/<id>/pad.
Bibliotecas: mais de três opções sob demanda
Cada decisão fornece três opções de diretor; D['libraries'] adiciona mais que o revisor (ou a aba Pergunte) pode puxar: direction (visuais: conjuntos de tokens + fonts_url), music (bases CC0 com bpm, phase, tags, level), motion (ease, spring {f,d} ou bezier), pacing, camera, transition, sfx (cada som no filme) e voice (vozes Fish: dir, durs, texts para outros idiomas, intro, sample). A decisão global voice escolhe o narrador; uma voz resolve cada linha para <dir><scene>-<A|B|C>.mp3, e uma voz com needs e sem dir é reproduzida como legendas até ser gravada. As opções adicionadas vivem no banco de dados da página, são desfazíveis e vão para a especificação aprovada. Construa bibliotecas com examples/crumb-previs/libraries.py como modelo:
- Música: pesquise Freesound CC0 (
freesound.py search ... --min-dur 20),freesound.py get, depoispython3 _shared/previs/music_lib.py <page>/audio/music/lib <oggs>(excertos de 24 s alinhados à batida, BPM medido); escreva tags e um porquê por base; linhas de registro em_shared/ASSETS.md. - Vozes: escolha vozes públicas Fish com
search_voices(sem clones de pessoas reais ou personagens), liste-as emvoices/voices.tsv, escrevavoices/lines-<lang>.txt, executevoices/make_voices.sh(modelo gratuito), depois verifique takes com whisper-cli e regenere qualquer um que perca palavras. - O diretor de IA (aba Pergunte,
lib/director.ts) também pode projetar visuais (verificado por contraste, fontes Google permitidas), sensações de movimento e novas redações de linhas (que precisam de gravação: ele emite uma nota de solicitação para o Claude Code).
O lado do Claude Code nas notas (faça isso a cada rodada)
O proprietário envia notas da página ("Enviar para Claude Code": um comentário ao vivo que acorda uma sessão de observação, ou uma mensagem copiada). Então:
0. Puxe antes de mudar. O Claude no claude.ai pode responder a um thread "Enviar para Claude Code" por conta própria, editar o arquivo de dados e publicar uma nova versão. Antes de construir, leia o previs.json publicado, compare-o com sua construção local e porte qualquer alteração para build_previs.py para que a próxima construção a mantenha.
- Defina
films/<id>/state/claude {state:"reading"|"working"|"publishing"|"idle", at, message, version, open}para que a página mostre o que você está fazendo. - Para cada nota aberta:
update-a comclaude: {state:"seen"}quando lida,{state:"working"}enquanto altera, depoisstatus:"done",claude:{state:"done", at, msg}e anexe{by:"claude", text, at}areplies(fixeif_version). Usestate:"question"(com a pergunta emmsg) quando precisar do proprietário,"wontfix"quando recomendar mantê-la. Notas comkind:"request"são trabalhos da aba Pergunte (gravar uma nova linha, encontrar um som);preferaponta para a opção que o proprietário gosta;intent:"question"quer uma resposta, não uma alteração. Cadaaté o tempo real: tire-o dedate -u +%Y-%m-%dT%H:%M:%SZ, nunca um palpite. - Adicione linhas a
films/<id>/activity({at, by:"claude", kind:"seen"|"applied"|"published"|"question", text, version}): o que você leu, o que mudou, o que publicou. - Responda no thread de comentários da página se o proprietário usou Enviar para Claude Code, depois resolva-o.
Regras
- Um diretor, sem comitê. Trabalhe através da lista de verificação especializada abaixo você mesmo, em ordem. Sem fluxos de trabalho ou subagentes, a menos que o proprietário peça (regra de custo).
- Infira agressivamente; pergunte apenas verdadeiros bloqueadores (verdade do produto, um ativo faltando, uma questão de licença). Nunca um longo questionário antes de o proprietário ver algo.
- Três opções em cada decisão, por padrão. Direção, música, sensação de movimento, ritmo e por cena: transição, câmera, linha de voz, cada evento SFX. As opções devem ser genuinamente diferentes. Marque a escolha do diretor e dê a cada opção uma frase simples do porquê ou trade-off. "Nada" é uma opção SFX válida.
- Verdade do produto. Cada cena é rotulada
real_ui,conceptual_ui,conceptual_visualouexternal_footage; qualquer coisa que não seja real mostra um rótulo no player. - As regras da casa ainda se aplicam (AGENTS.md, OWNER.md): clichês proibidos, carries, dois níveis de texto, foley gravado, a voz padrão, licenças. A página só reproduz áudio CC0 ou auto-fabricado; Mixkit (apenas renderização) aparece apenas pelo nome.
- Reduza a escala. Um sting de 6 s pode ser um cartão de direção, 3 opções de música e um animatic de 6 s. Um filme de produto de 40 s recebe o conjunto completo.
- Travamentos. Assim que o proprietário aprovar, história, cópia, ordem, tempo e escolhas são travados. Uma nota posterior altera apenas seu alvo; liste o que você preservou.
Lista de verificação especializada (o diretor cobre cada um, brevemente)
História (gancho aos 2 s, um estado por batida) · roteiro e linhas de voz (palavras por segundo ≤ 3,4) · ritmo editorial (varie a duração dos takes, pausas, nem todo corte na batida) · direção de arte (3 direções como conjuntos de tokens: bg, on-bg, card, on-card, muted, line, paper, on-paper, accent, on-accent, frame, display, ui, mono) · tipografia · referências (emprestar / evitar / onde usado; gramática, nunca conteúdo) · câmera (cada movimento tem uma razão) · movimento (propósito, ease, overshoot ≤ 4% na UI, nenhum no tipo) · transições (um corte simples é válido) · ativos (existente / novo / gerado / placeholder, com licença) · música (BPM e fase medidos, curva de energia, onde o drop cai) · SFX (ativo, tempo, gatilho, ganho, porquê) · mix (voz lidera, duck 8 dB, impacto mais alto) · motor (escolhido, porquê, alternativa, fallback) · QA.
Arquivos (uma pasta por filme)
projects/NNN-name/previs/
build_previs.py # escreve page/previs.json; copie examples/crumb-previs/build_previs.py e edite (cenas = styleframe HTML + anim tweens)
vo-lines.txt # 3 redações por linha, para fish_tts.py
page/index.html # construído por _shared/previs/app (npm run build; adicione esta página como um destino em scripts/inline.mjs)
page/films.json # [{"id": "NNN-name", "name": "Product", "path": ""}]
page/previs.json # o plano completo
page/audio/{music,vo,sfx}/
changes.jsonl # log de alterações somente anexação, uma operação por linha
approved-video-spec.json # escrito por _shared/previs/freeze_spec.py após aprovação
Passos
- Leia o briefing ou pedido de uma linha e a fonte do produto (UI real, tokens, cópia). Escreva
BRIEF.mdcom as decisões inferidas. - Áudio (barato, local):
- Bases: meça tempo e fase por comb fit sobre 85–150 BPM em um envelope de onset de baixa banda (
AGENTS-tooling.md, "Previs"); corte excertos de 24 s começando em uma batida, loudnorm para −18 LUFS:ffmpeg -ss <phase> -t 24 -i bed.wav -af "loudnorm=I=-18:TP=-2,afade=t=out:st=22.5:d=1.5" page/audio/music/A.mp3. - Voz:
python3 _shared/tools/fish_tts.py --lines previs/vo-lines.txt --out-dir previs/vo-wav(modelo gratuito), depois corte silêncio empage/audio/vo/sN-{A,B,C}.mp3. - Foley: copie prévias CC0 de
_guide/prompt-studio/media/foley/ou busque comfreesound.py.
- Bases: meça tempo e fase por comb fit sobre 85–150 BPM em um envelope de onset de baixa banda (
- Planeje em
build_previs.py(veja o exemplo para cada campo):project,summary,chief,story(beats → scenes),directors,assets,gates,pipeline,changes,directions(3),global.music|motion|pacing|voice(3 cada),engine,references,style_rules,audio_notes,qa,versions,film_css(todas as cores via tokens, classes prefixadasf-),fonts_url, escenes[]comhtml,anim(tweens{s, t:[a,b], f, to, e}em x, y, s, sx, sy, r, o, clip, w, blur;{s, set, at, until}alternâncias de classe;{s, count:[from,to], t, p, d}contadores;e:'m'segue a escolha de Movimento),decisions(tipos de transição cut, push, slide, zoom, iris; camera{s,x,y,origin}; vo{text, src, dur, at, copy}),sfx(atpode ser uma lista para execuções),key(o momento do still do storyboard). Dê a cada elemento que o proprietário possa apontar um simplesdata-name("Total do recibo", "Botão de solicitação"). - Verifique localmente: sirva a pasta da página, veja um still de cada cena e um no meio da transição, alterne todas as três direções uma vez, confirme que não há erros no console. Uma passada, sem loop.
- Compartilhe a página (localmente, ou como um Artefato do claude.ai com as capabilities acima) e adicione o filme ao Previs Studio. Dê ao proprietário o link e um resumo de cinco linhas. Pare para revisão.
- Loop de revisão (cada rodada é uma republicação):
- Leia notas, escolhas e aprovação.
- Para cada nota aberta: altere apenas seu alvo, anexe uma operação a
changes.jsonl({"v","target","t","change","from","to","reason","preserve":[...]}), depois marque a nota como concluída com uma resposta de uma linha (protocolo acima). Uma notarevertpede para desfazer uma alteração listada. - Aumente
versionse adicione aschangesda rodada embuild_previs.py, execute-o novamente, copieprevis.jsonpara a cópia do Studio, republique. O player mostra um banner "o que mudou" e o Plano lista cada alteração com um pedido de Desfazer.
- Aprovação: quando
state/approvaltiverapproved: true(carregapicks,tweaksecustom), salve-o, executepython3 _shared/previs/freeze_spec.py projects/NNN-name/previs --approval <file>(resolve opções adicionadas e a voz, e listaneeds_before_buildcomo linhas não gravadas), escrevaSHOTLIST.mda partir da especificação, depois passe para a skill de motor nomeada na especificação. O motor constrói exatamente a especificação (polimento permitido, decisões não).
Custo
Apenas trabalho solo. Uma pré-visualização de 20 s leva algumas horas de uma sessão (aproximadamente $30–60 equivalente API), com Fish no modelo gratuito e sem renderizações. A renderização de produção e suas verificações vêm após a aprovação.