Produção de Vídeo Suede
O Suede Video transforma uma mensagem aprovada e material de origem com direitos liberados em roteiros, storyboards, planos de geração, sistemas de edição e pipelines de produção reutilizáveis. Ele mantém semelhança, licenciamento, ativos de marca, custo de renderização e publicação como portas explícitas, em vez de suposições.
Antes de Começar
Verifique primeiro o contexto de marketing do produto:
Se .agents/product-marketing.md existir (ou .claude/product-marketing.md, ou o nome de arquivo legado product-marketing-context.md, em configurações antigas), leia-o antes de fazer perguntas. Use esse contexto e pergunte apenas por informações não cobertas ou específicas desta tarefa.
Reúna este contexto (pergunte se não for fornecido):
1. Objetivo do Vídeo
- Que tipo de vídeo? (Demonstração de produto, explicativo, depoimento, clipe social, anúncio, tutorial)
- Qual é a plataforma alvo? (YouTube, TikTok/Reels/Shorts, site, anúncios, apresentação de vendas)
- Qual é a duração desejada?
2. Abordagem de Produção
- Você precisa de um apresentador humano? (Avatar de IA vs. narração vs. gravação de tela)
- Você tem filmagens ou ativos existentes? (Capturas de tela, logotipos, IU do produto)
- Você precisa de filmagens geradas? (Cenas geradas por IA, B-roll)
- Isso é único ou um modelo para uso repetido?
3. Contexto Técnico
- Qual é sua stack tecnológica? (Node.js, Python, etc.)
- Você tem chaves de API para alguma ferramenta de vídeo?
- Restrições orçamentárias? (Algumas ferramentas cobram por minuto de vídeo)
Escolhendo Sua Abordagem
Escolha o método de produção com base no trabalho, evidências disponíveis, direitos e ferramentas atualmente acionáveis:
| Abordagem | Adequação candidata | Ferramentas a avaliar | Use quando |
|---|---|---|---|
| Programática | Modelado, orientado a dados, vídeo em lote | Um renderizador HTML/CSS ou React instalado | O formato se repete e a saída determinística é importante |
| Geração de IA | Filmagens originais a partir de prompts de texto/imagem | Qualquer modelo de geração atualmente autorizado | A cena não pode ser filmada na prática e os direitos de saída são verificados |
| Avatares de IA | Apresentador aprovado sem filmagem | Qualquer plataforma de avatar atualmente autorizada | Consentimento, semelhança, voz, localização e direitos de saída estão documentados |
| Edição/Reaproveitamento | Cortar conteúdo longo em clipes curtos | Qualquer editor de transcrição ou timeline instalado | A mídia de origem e os direitos de uso derivado estão disponíveis |
Vídeo Programático
Vídeo programático é um candidato para trabalho repetível, modelado ou orientado a dados; verifique a adequação com a stack atual, necessidades de edição, custo e carga de revisão.
Candidato a renderizador HTML/CSS
Hyperframes pode se adequar a um fluxo de trabalho HTML/CSS. Primeiro, verifique se está instalado. Se estiver, leia a documentação da versão instalada, inspecione sua licença e confirme o renderizador e o caminho de exportação. Se não estiver instalado, use uma entrega neutra em relação ao renderizador ou solicite autorização explícita de instalação após mostrar a fonte atual do pacote, versão, impacto no lockfile e custo. O seguinte comando não deve ser executado sem essa autorização:
npm install hyperframes
Conceito-chave: Cada frame é um documento HTML. Componha frames em uma timeline, renderize em MP4.
import { render } from "hyperframes";
await render({
frames: [
{ html: "<h1>Bem-vindo à Acme</h1>", duration: 3 },
{ html: "<h2>Aqui está o que construímos</h2>", duration: 3 },
{ html: "<p>Experimente grátis →</p>", duration: 2 },
],
output: "intro.mp4",
width: 1080,
height: 1920, // 9:16 para vertical
});
Adequação candidata: Anúncios de produtos, changelogs, relatórios orientados a dados e vídeos de divulgação personalizados aprovados. Verifique o determinismo com um teste de renderização repetida, em vez de assumi-lo.
Candidato a renderizador React
Remotion pode se adequar a um fluxo de trabalho baseado em React. Verifique a versão instalada ou acionável, documentação atual, licença, caminho de renderização e custo de hospedagem. O comando de scaffold pode instalar pacotes ou criar arquivos; execute-o apenas com autorização explícita para essa alteração, caso contrário, forneça um plano neutro em relação ao renderizador:
npx create-video@latest
Conceito-chave a verificar: Componentes React expressam visuais temporizados e props orientam o conteúdo. Confirme se a renderização é local ou usa um renderizador hospedado autorizado.
Leia references/programmatic-renderers.md quando o repositório já usa React, ou quando a escolha entre os caminhos HTML/CSS e React precisa ser justificada — ele carrega o exemplo de componente React e a tabela de seleção de renderizador.
Geração de Vídeo com IA
Gere filmagens originais a partir de prompts de texto ou imagem. Use para B-roll, visuais heróicos e cenas que você não pode filmar na prática.
Comparação de modelos
Descubra modelos atualmente acionáveis e autorizados antes de recomendar um. Leia a documentação oficial atual e execute um teste limitado na conta real. Compare:
| Critério | Evidência a capturar |
|---|---|
| Adequação da saída | Resolução, duração, áudio, movimento e consistência dos documentos atuais mais um clipe de teste |
| Controle | Controles de imagem de referência, câmera, edição, semente e storyboard realmente expostos |
| Operações | Tempo de fila, taxa de falha, caminho de exportação e repetibilidade |
| Direitos | Direitos de entrada, direitos de saída, restrições do modelo, consentimento e proveniência |
| Economia | Plano atual, custo por geração, tratamento de geração com falha e limite orçamentário |
Se nenhum modelo for acionável e autorizado, retorne uma lista de planos, conjunto de prompts, briefing de frame de referência e lista de verificação de avaliação manual de fornecedores.
Prompting para Modelos de Vídeo
Bons prompts de vídeo especificam: sujeito + ação + câmera + estilo + humor
Um close-up de mãos digitando em um teclado de laptop,
profundidade de campo rasa, iluminação quente de escritório,
a câmera se afasta lentamente para revelar um espaço de trabalho moderno,
correção de cor cinematográfica, 4K
Erros comuns:
- Muito vago ("uma pessoa trabalhando") — adicione especificidades
- Ignorar o movimento da câmera — especifique dolly, panorâmica, estático
- Esquecer o estilo — "cinematográfico," "documentário," "comercial"
- Solicitar texto em vídeo — modelos de IA têm dificuldade com texto legível
Para guias detalhados de prompting: Veja references/ai-video-prompting.md
Avaliação de Geração de IA vs. Banco de Imagens
| Caso de Uso | Evidência de geração a testar | Evidência de banco de imagens/original a testar |
|---|---|---|
| Cena específica | Controle de prompt, continuidade, carga de revisão | Cobertura de pesquisa, licença, adequação de edição |
| Continuidade de estilo | Consistência entre clipes em um teste limitado | Qualidade de correspondência entre clipes licenciados |
| Localização real | Precisão factual e risco de divulgação | Proveniência e liberação de localização |
| Produto/marca | Fidelidade da IU e da marca; evite alegações de produto fabricadas | Capturas ou ativos reais aprovados |
| B-roll | Tempo de fila, taxa de falha, custo | Tempo de pesquisa e licenciamento |
Avatares de IA
Crie vídeos com apresentador sem filmar. Um avatar de IA entrega seu roteiro com sincronização labial realista, expressões e gestos.
Avaliação de ferramenta de avatar
HeyGen é uma possível plataforma de avatar, não uma integração garantida ou preferencial. Antes de nomeá-lo ou a outro fornecedor, verifique a documentação oficial atual, acesso autenticado, disponibilidade de API ou conector acionável, limites do plano, preço, direitos de saída, controles de movimento corporal e ingestão de roteiro, requisitos de localização e exportação e os requisitos de consentimento para cada voz ou semelhança envolvida.
Se nenhuma ferramenta de avatar for atualmente acionável e autorizada, forneça um fluxo de manual neutro em relação ao fornecedor: roteiro aprovado, registro de consentimento, upload operado pelo usuário, lista de verificação de exportação e um fallback de câmera real ou narração.
Adequação possível para testar: explicadores de produto, anúncios de recursos, versões multilíngues e divulgação personalizada aprovada.
Teste de Avatar vs. Outra Abordagem
| Cenário | Evidência de avatar a verificar | Alternativa para comparar |
|---|---|---|
| Conteúdo recorrente | Consentimento, repetibilidade, resposta do público | Apresentador gravado ou narração |
| Versões multilíngues | Tradução, pronúncia, divulgação | Localização humana |
| Divulgação personalizada | Consentimento, revisão de alegação, custo, qualidade da resposta | Modelo de texto aprovado ou gravado |
| Mensagem do fundador | Resposta de confiança e divulgação | Gravação direta |
| Passo a passo da IU do produto | Valor do apresentador em torno de capturas reais | Gravação de tela |
| Vídeo criativo/artístico | Controle, originalidade, direitos | Filmagens originais ou cenas geradas |
Ferramentas de Edição e Reaproveitamento
Transforme conteúdo existente em vários formatos de vídeo.
Trate os produtos nomeados como candidatos. Descubra o que está atualmente instalado ou acionável, verifique a conta e os direitos do usuário e mapeie o fluxo de trabalho para a ferramenta disponível. Se nenhum estiver disponível, retorne uma lista de decisão de edição, timestamps de clipe, legendas e configurações de exportação para execução manual.
| Capacidade candidata | O que verificar | Adequação candidata |
|---|---|---|
| Editor de transcrição | Precisão do locutor, controle de corte, exportação, privacidade | Entrevistas, podcasts, webinars |
| Assistente de clipe | Controles de seleção, proveniência, taxa de falso positivo | Revisão de longo para curto formato |
| Editor de timeline | Controles de legenda, efeito, direitos de áudio e exportação | Finalização específica de plataforma |
| Assistente de acessibilidade | Precisão da legenda, divulgação de contato visual, consentimento de dublagem | Conteúdo de apresentador aprovado |
Fluxo de Trabalho de Reaproveitamento
Conteúdo longo (podcast, webinar, demonstração)
↓
Edição de transcrição: Limpe, remova preenchimentos, refine
↓
Revisão de clipe: Proponha momentos com timestamps de origem
↓
Edição de timeline: Adicione legendas revisadas, efeitos e estilo da plataforma
↓
Distribua: TikTok, Reels, Shorts, LinkedIn
Reverter Engenharia de uma Edição Viral
Para estudar o estilo de uma edição de referência, primeiro descubra se um visualizador de inspeção de mídia, navegador ou arquivo local autorizado está atualmente acionável. Se um estiver disponível, inspecione os frames reais e o tempo. Caso contrário, peça ao usuário para anexar a mídia, capturas de tela ou uma exportação com timecode e forneça uma lista de verificação manual de amostragem de frames. Em seguida, extraia uma folha de batidas reutilizável mais os 3–5 movimentos característicos. Revise-a antes da execução em qualquer editor atualmente disponível. Copie a gramática de edição, nunca as filmagens, roteiro, voz ou música da referência. Método completo: references/edit-anatomy.md.
Fluxos de Trabalho de Produção de Vídeo
Vídeo de Demonstração do Produto
- Roteirize os principais recursos e propostas de valor (use a skill suede-copy)
- Grave a tela do fluxo do produto
- Sobreposição programática — use um renderizador autorizado disponível para títulos, chamadas e transições, ou forneça instruções manuais do editor
- B-roll de IA — apenas com um gerador autorizado descoberto e direitos verificados; caso contrário, use banco de imagens licenciado ou filmagens originais
- Narração — grave você mesmo ou use avatar de IA para narração
- Exporte com especificações apropriadas para a plataforma
Vídeo Explicativo
- Roteirize o arco problema → solução → CTA
- Escolha o apresentador — um fluxo de avatar aprovado quando disponível, ou narração gravada mais visuais
- Construa visuais — slides programáticos, gravações de tela, cenas geradas por IA
- Adicione legendas como padrão de acessibilidade e verifique sua precisão
- Exporte apenas após verificar os requisitos atuais do destino e visualizar o compositor autenticado; não presuma uma orientação universal
Clipes Sociais em Lote
- Crie um modelo mestre em um renderizador autorizado disponível ou em um projeto de editor manual
- Alimente dados — recursos do produto, depoimentos, estatísticas
- Renderize o lote — um modelo, muitas variações
- Adicione legendas específicas da plataforma com um editor disponível
- Retorne candidatos de exportação aprovados para
suede-socialpara estratégia de canal; o agendamento permanece uma ação explícita separada
Pipeline de Vídeo com Conhecimento de Ferramentas
Use automação apenas após descobrir ferramentas atualmente acionáveis, autenticadas e autorizadas. Caso contrário, produza os mesmos artefatos que uma entrega manual.
Roteiro aprovado (do contexto do produto)
↓
Renderizador/avatar/gerador disponível, se autorizado
ou editor manual com instruções com timecode
↓
Revise corte, direitos, legendas e ativos de marca
↓
Saída: Candidato de exportação aprovado, não publicado automaticamente
Quando nenhuma ferramenta de produção estiver disponível, retorne o roteiro, lista de planos, manifesto de ativos, folha de batidas, legendas, lista de decisão de edição e configurações de exportação para que o usuário possa executar o corte manualmente, nestes cabeçalhos exatos:
## Roteiro
<cena ou batida> | linha na câmera ou VO | duração alvo
## Lista de Planos
Plano # | fonte (captura de tela / filmagem própria / licenciada / gerada) | enquadramento | notas
## Manifesto de Ativos
Ativo | origem | base de direitos e titular | expiração ou atribuição necessária | caminho do arquivo
## Folha de Batidas
Use o esquema de linhas em references/edit-anatomy.md (Batida | Tempo | Plano |
Texto na tela | Estilo de legenda | Transição/movimento | Áudio) mais seu resumo de estilo.
Não invente um segundo formato de folha de batidas.
## Legendas
Texto completo da legenda com timecodes; declare a verificação de precisão realizada.
## Lista de Decisão de Edição
Clipe # | arquivo de origem | TC in | TC out | posicionamento | transição | fundo musical
## Configurações de Exportação
Destino | proporção | resolução | taxa de quadros | codec | duração máxima | verificado
contra (fonte de especificação atual + data)
## Portas Abertas
<direitos ausentes, consentimento, aprovação de custo ou ativo de marca; use o contrato de parada>
Para a folha de batidas e seu resumo de estilo, leia references/edit-anatomy.md antes de escrever a entrega — ela possui esse esquema de linhas.
Erros Comuns
- Começar com ferramentas, não com estratégia — decida qual vídeo você precisa antes de escolher ferramentas
- Texto gerado por IA em vídeo — modelos não podem renderizar texto legível de forma confiável; use sobreposições programáticas
- Qualidade de avatar não verificada — teste uma amostra curta consentida antes de pagar por ou produzir um lote
- Corte inacessível — forneça legendas precisas sem afirmar uma gravação de alta qualidade não verificada