video-xoshaka

O que video-xoshaka faz?

Produção de vídeo ponta a ponta: entrevista, briefing, material, arquivo de design, roteiro, storyboard, voz, construção, música, verificação, entrega, com portões de aprovação ao longo do caminho. Começou como a habilidade para um tipo de vídeo, uma história xoshaka (Curdo: "o divertido") que narra como um minidocumentário e brinca como uma página de memes. Isso ainda está aqui como um estilo entre vários. O mesmo pipeline agora faz tributos sinceros, promos de produtos, explicadores, tutoriais, resumos e anúncios.

O que faz qualquer um deles parecer personalizado é o material real: o próprio clipe da pessoa, a foto do amigo, seus sites e aplicativos reais, suas próprias palavras de suas anotações, seu logotipo real. Um vídeo com aparência de banco de imagens é o modo de falha.

O que ler quando

• references/brief.md: a entrevista. As rodadas de perguntas, as perguntas de texto livre, anotações de idioma e texto da direita para a esquerda, o formato do resumo e como salvar brief.md. Leia no início de cada novo vídeo.
• references/storyboard-and-gates.md: os modelos design.md e STORYBOARD.md, os portões de aprovação, workers de cena paralelos e verificações de atualização. Leia antes de escrever o roteiro.
• references/styles.md: os estilos (história engraçada, tributo sincero, promo, explicador, tutorial, resumo, anúncio, apenas legendas), a forma, o tom, a duração e o clima musical de cada um, e os formatos e zonas seguras da plataforma. Leia logo após o briefing.
• references/story-and-comedy.md: encontrando material e o que manter privado, escrevendo story.json, sincronizando visuais com palavras e o manual de comédia (para o estilo engraçado).
• references/production.md: configuração do projeto, componentes, formatos, capturas de tela, verificação e as armadilhas já encontradas. Leia antes de construir.
• references/music.md: configuração de música do HeyGen (incluindo o login no Windows/WSL), escolha de uma faixa, ducking e silêncio.
• references/toolbox.md: todas as ferramentas, habilidades e CLI que este fluxo de trabalho usa e quando usá-las: as habilidades Remotion, media-use, HeyGen, Kokoro, ElevenLabs, ffmpeg, Chrome headless e os scripts incluídos.

Fluxo de trabalho

1. Entreviste a pessoa e depois salve o briefing

As respostas da pessoa decidem o que você constrói, então pergunte antes de fazer qualquer outra coisa. Siga references/brief.md:

1. Rodada 1, o básico (AskUserQuestion, até 4 perguntas): estilo, onde será postado (o que define o formato), duração, voz.
2. Rodada 2, aparência e sensação: tom, o que está na tela (fotos e clipes, capturas de tela em maquetes, texto em negrito e gráficos, mapas ou diagramas), cores e marca, música.
3. Rodada 3, material e segurança: nomes reais ou não, capturas de tela com nomes ou não, legendas, o final.
4. Rodada de texto livre, no chat: o ponto em uma frase, os momentos reais e fatos a incluir, a frase sincera ou a chamada para ação exata, o que evitar ou nunca mostrar, quem é quem, referências de que gostam e onde estão os arquivos.
5. Idioma: se o vídeo não for apenas em inglês, pergunte qual idioma e verifique se a voz e a renderização de texto o suportam (brief.md, "Idioma e texto da direita para a esquerda").
6. Resumo e confirmação: reafirme o briefing como uma lista curta nas palavras deles, pergunte "Algo para mudar?", depois salve como brief.md na raiz do projeto.

Pule qualquer coisa que a pessoa já disse, recomende um padrão para cada pergunta, adapte as opções ao estilo e pergunte apenas o que for necessário. Se eles disserem "apenas faça", pergunte apenas a rodada 1, liste suas suposições no resumo e ainda deixe a voz, quem pode ser nomeado ou mostrado e o que é privado para eles decidirem. Crie public/photos/ e diga a eles os nomes dos arquivos: me mais um por pessoa na história. Clipes de vídeo e GIFs também funcionam.

brief.md é o contrato. Cada etapa posterior segue ele. Quando a pessoa mudar de ideia, atualize brief.md primeiro, depois o trabalho. Na mensagem de entrega, diga como o resultado corresponde ao briefing e nomeie qualquer coisa que não corresponda.

Se eles deram uma história ("X me disse para comprar, fiz com meu amigo Y") ou uma mensagem ("lançar nosso novo cardápio"), essa é a espinha dorsal. Todo o resto vem do material deles.

2. Reúna o material

• Anotações deles (cofre, diário, pastas de projeto, histórico do git): envie um subagente de pesquisa para uma linha do tempo datada, as pessoas e pontos de virada, e uma lista de coisas privadas a serem mantidas de fora (story-and-comedy.md). Não coloque nada privado no vídeo.
• Mídia deles: veja cada clipe e foto você mesmo. Verifique vários quadros por clipe em busca de placas de licença, crachás e telas, e decida o corte (focusY). Pergunte quem é quem se um clipe mostrar mais de uma pessoa.
• Trabalho deles: capturas de tela de sites ativos (Chrome headless, desktop e celular) e capturas de tela de aplicativos existentes em seus repositórios.
• Ativos da marca: o logotipo real deles, nunca redesenhado (media-use resolve --type logo encontra marcas oficiais), suas cores e fontes.
• Fatos para uma promo ou tutorial: cada número, preço, recurso e passo vem da pessoa ou de algo que você verificou. Não invente alegações.

3. Arquivo de design, roteiro e storyboard

Primeiro escreva design.md (paleta, fontes, logotipo, regras de movimento e texto, a partir do briefing e dos ativos reais da marca da pessoa; modelo em storyboard-and-gates.md). Depois escreva story.json seguindo story-and-comedy.md e a forma para o estilo escolhido em styles.md. Em seguida, escreva STORYBOARD.md: uma linha por cena com a fala, o que está na tela, o som e a palavra em que cada visual cai. Abra com um gancho nos primeiros dois ou três segundos. Portão: mostre à pessoa as falas e a tabela do storyboard e espere um sim antes de construir. Mudar palavras é barato agora e caro depois. Peça à pessoa as histórias reais por trás de qualquer piada e a frase sincera em suas próprias palavras, em vez de inventá-las. Anote onde será postado: Reels, TikTok e Shorts precisam de legendas colocadas mais acima (styles.md, "Zonas seguras").

4. Voz

Pule esta etapa para um vídeo sem narração (então as legendas carregam as palavras). Caso contrário, gere amostras com scripts/voice-samples.mjs, abra a pasta e deixe a pessoa escolher pelo ouvido (bm_george funcionou bem para comédia na velocidade 1.1; vozes mais calmas combinam com tributos e tutoriais). Depois execute scripts/make-voice.mjs. Ele imprime a duração de cada cena e uma linha de alinhamento "breaks". Imprima os tempos das palavras e verifique se nenhuma palavra dura mais de um segundo (production.md, "Armadilhas"). Outras fontes de voz estão em toolbox.md.

5. Abra a prévia cedo

Assim que o projeto rodar, inicie o Remotion Studio (npx remotion studio) e abra a prévia, para que a pessoa possa assistir e direcionar enquanto você constrói. Renderize um MP4 quando eles pedirem o arquivo ou ao entregar um vídeo para postar; enquanto eles ainda estão iterando, a prévia é a entrega.

6. Construa

Scaffold e copie o modelo e scripts (production.md). Para cada cena, escreva um componente, geralmente um BeatScene com visuais, adaptado de assets/template/src/story/scenes/ (e de assets/examples/scenes/ quando essa pasta existir). Tempo cada visual para uma palavra com wordAt(...). Mantenha a linha do tempo em StoryVideo.tsx: transições de fade, um slide mais whoosh em mudanças de capítulo. Defina o tamanho da composição a partir do formato escolhido. Construa a partir de STORYBOARD.md e design.md, não da memória. Com cerca de cinco ou mais cenas independentes, construa-as em paralelo com um subagente por cena (storyboard-and-gates.md), depois monte e verifique as junções você mesmo. Use as habilidades Remotion para o próprio Remotion (toolbox.md). Se a pessoa editou o código fora do chat, não o sobrescreva; presuma que foi intencional ou pergunte.

7. Música e som

Use música real (music.md), no clima que o estilo pede (styles.md). Instale media-use e a CLI do HeyGen se necessário, faça a pessoa fazer login, pesquise alguns climas, baixe uma faixa principal mais duas alternativas, meça-a, defina MUSIC_GAIN, e planeje em torno do final natural da faixa. Efeitos sonoros apenas onde o estilo os deseja.

8. Verifique e depois obtenha aprovação para renderizar

• Veja as imagens estáticas de cada visual chave e de cada final de cena (scripts/stills.mjs).
• Verifique fatos em promos e tutoriais: cada número, nome e passo em relação à sua fonte.
• Portão de prévia: mostre a prévia do Studio ou as imagens estáticas chave e pergunte o que mudar. Renderize o MP4 final apenas após a pessoa aprovar a prévia, ou quando solicitarem explicitamente o arquivo.
• Renderize em um novo nome de arquivo versionado.
• Meça o áudio (scripts/check-audio.mjs).
• Verifique quadros do MP4 final em busca de algo sensível ao tempo.
• Abra o vídeo para eles.

9. Entregue

Relate de volta:

• o caminho do arquivo, duração e tamanho
• o que mudou, se esta é uma atualização
• o que você verificou e que não conseguiu ouvir o áudio
• as perguntas em aberto: quem é quem, clima musical, se deve cortar a duração

Princípios

• Real em vez de genérico. O clipe deles, o amigo deles, suas telas e logotipo reais.
• Tom se adequa ao propósito. Engraçado é uma opção. Uma despedida, um lançamento de produto e um tutorial cada um precisa de seu próprio tom; não force piadas onde elas não pertencem.
• Gancho cedo, uma ideia por cena. O ponto é visível nos primeiros dois ou três segundos, e cada cena merece seu lugar.
• Visuais caem nas palavras. Um visual chegando em sua palavra supera qualquer número de efeitos extras. Quando pedirem "melhor" ou "mais engraçado", aperte o tempo e as palavras antes de aumentar o volume.
• Uma batida chave. A frase sincera, a chamada para ação ou a conclusão, declarada claramente e deixada espaço para impactar.
• Privacidade é um recurso. As anotações deles contêm coisas que outras pessoas não deveriam ver. A pessoa confia em você para deixá-las de fora sem ser solicitado.
• Não adivinhe sobre as pessoas. Deixe-os escolher a voz do narrador pelo ouvido, nunca pelo nome. Confirme quem é quem em clipes de grupo. Não invente citações, sentimentos ou alegações que o material não suporta.
• Entrega honesta. Diga o que você verificou e o que não pôde (áudio pelo ouvido). Se a duração cresceu além do que foi solicitado, diga e nomeie o corte mais fácil.