minara-video-skills (Regras de Vídeo Minara)

/minara-video

🅖 Regra de fonte: todo vídeo Minara usa Geist para todos os textos

Títulos / corpo / números / botões / tabelas - tudo usa font-family: 'Geist', system-ui, -apple-system, sans-serif. Sem Inter, sem serifa de nenhum tipo, e sem fonte padrão do sistema que recaia em serifa. Carregamento: @import url('https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700;800&display=swap'); emparelhe números com font-variant-numeric: tabular-nums. Escreva ambos os seletores CSS, #root, [data-composition-id="root"] {}, ou font-family não será aplicada e a página herdará a serifa padrão do navegador (veja o item 1 de "Armadilhas da estrutura de composição"). Não negociável e não opcional, a menos que o operador diga explicitamente "换字体" (mudar a fonte) para esse job. (Definido pelo operador em 2026-06-24; promovido a regra principal em 2026-06-26.)

Este é o procedimento operacional padrão do operador para vídeos Minara, destilado dos problemas encontrados durante a produção do vídeo de lançamento público do Strategy Studio em 26~27 de maio de 2026.

⚠️ Rota primeiro: este é o fluxo de trabalho para vídeos de motion compostos com HyperFrames (marketing / lançamento / demonstração, onde cada quadro é construído em código). Se a tarefa for um vídeo de guia / tutorial de produto - o operador grava a tela ele mesmo e você apenas adiciona narração + legendas e entrega - use a sub-skill minara-guide-video, não esta. Como diferenciar: existe uma gravação de tela existente / o pedido é "adicionar narração e legendas a esta gravação"? Os dois diferem em voz, legendas e entrega.

⛔️ Pré-requisito de inicialização: carregar HyperFrames + video-shotcraft (obrigatório)

Assim que esta skill for iniciada, use a ferramenta Skill para invocar a skill hyperframes para que todas as suas regras de composição estejam em contexto, então leia a biblioteca local de shots video-shotcraft na íntegra, e só então continue com o fluxo de trabalho abaixo.

• Este é um pré-requisito obrigatório, não opcional - minara-video é apenas um invólucro de fluxo de trabalho mais rigoroso; a sintaxe de composição real / timeline / regras de renderização estão todas em hyperframes. Escrever HTML de cena sem carregá-lo encontrará problemas conhecidos (timeline pausada, registro window.__timelines, ausência de Math.random() / repeat:-1, etc.).
• Mesmo que hyperframes já tenha sido usado anteriormente nesta sessão, invoque-o novamente ao iniciar /minara-video para que as regras estejam no contexto atual.
• Ordem de carregamento: Skill(hyperframes) primeiro → então leia $VIDEO_WORKSPACE/video-shotcraft/SKILL.md na íntegra → então Leia $BRAND_DIR/design.md (sistema visual Minara v2) → então leia as regras de estilo fixas → depois siga o fluxo de trabalho abaixo.
• Você deve ler $BRAND_DIR/design.md (obrigatório; lição de 2026-06-24): este é o sistema visual oficial Minara v2 e a fonte da verdade para valores de cor, escala tipográfica, espaçamento, raio de borda, cards e layout. As regras de estilo fixas desta skill são a "camada de clima do vídeo"; design.md é a "fonte da verdade dos tokens de design" - ambos devem estar em contexto. ⚠️ O gradiente da marca listado em design.md, #EB53FF/#FF538E/#FF9A32, não é usado em vídeos (removido pelo operador em 2026-09-02; veja as regras de estilo fixas abaixo). Pegue apenas seus tokens preto/branco/cinza, cores semânticas, escala tipográfica e espaçamento de 4pt.
• Carregue a pasta de ativos da marca $BRAND_DIR/logo/ por padrão (definido pelo operador, 2026-06-24): quando precisar de um logotipo / avatar / wordmark, use os ativos oficiais aqui primeiro; não desenhe seu próprio SVG como substituto. Inventário atual (execute ls primeiro para verificar; pode mudar):
  • Minara Avatar.png - Avatar pixel preto e branco da Minara (garota de óculos, meio-tom); o padrão para o logotipo redondo nos finais.
  • Minara Logo.png - Logotipo principal da Minara.
  • MInara Text Logo Light.png / MInara Text Logo Light Dark.png - wordmark de texto (versões clara / clara e escura).
  • Minara Avatar Japan.png - variante do avatar para o mercado japonês.
  • 128_128.png - ícone quadrado pequeno.
  • minara X banner.jpeg - banner do X.
  • Uso: cp os ativos necessários para a pasta assets/ do projeto e referencie-os em HTML com <img src="assets/xxx.png">; o HyperFrames incorpora imagens locais no momento da renderização. Ao verificar com capturas de tela, também copie uma cópia para /tmp/<test-dir>/assets/ (caminhos relativos só resolvem assim).

🎬 Regras de carregamento da biblioteca local de shots video-shotcraft (2026-07-21)

• Caminho fixo da biblioteca local: $VIDEO_WORKSPACE/video-shotcraft/. Toda vez que /minara-video for iniciado, leia seu SKILL.md na íntegra. Não o use apenas com base em nomes de cartas ou memória.
• O método fixo para traduzir cartas está na seção "Lições de shots do cliente 'crescente / autoescritor' § B" abaixo (quadros de carta × TEMPO, clip-path em vez de máscaras de cor de papel, PageCam2D incorporado em keyframes, zoom ≥ 1, foco limitado ao canvas).
• Seu papel padrão é uma biblioteca de referência; ele não muda a pilha de tecnologia automaticamente: minara-video ainda se concentra nas composições seguras para busca do HyperFrames, pré-visualizações por cena e fluxo de renderização; video-shotcraft fornece linguagem de shot, receitas de movimento de câmera, estruturas de ritmo, design de som, demonstrações aprovadas e ativos. Ao adotar uma de suas implementações Remotion, primeiro traduza o método para uma timeline determinística e buscável do HyperFrames. Não copie Date.now(), Math.random() ou animações não seguras para busca diretamente.
• Não acione os prompts de template da skill independente: ao carregar esta biblioteca dentro de /minara-video, não pergunte a cada vez se deve usar Ink Press, e não interrompa o fluxo de trabalho Minara bloqueado por causa disso. Apenas quando o operador nomear explicitamente Ink Press ou Remotion, ou pedir para replicar aquele template, leia template/TEMPLATE.md na íntegra e mude para a rota do template.
• Leia a fonte da verdade para qualquer carta de shot que você usar: quando decidir usar uma carta de shot, leia references/shots/<card-name>.md e a implementação fonte correspondente de demos/<card-name>/ na íntegra; leia references/sequences/ quando precisar de estrutura de filme completo, e references/sound-design.md e assets/audio/ATTRIBUTION.md quando precisar de som. Não carregue todas as 106 cartas no contexto de uma vez.
• Copie apenas os ativos que você precisa: copie de assets/lib/, assets/audio/, ou demos/ para o projeto de vídeo atual; não deixe o projeto depender dos caminhos relativos desta biblioteca em tempo de execução. Ao usar áudio, mantenha e verifique a atribuição de licença.

🧰 Regras da biblioteca de componentes Remotion local Remocn (2026-08-13)

• Caminho fixo da biblioteca local: $VIDEO_WORKSPACE/remocn/. É uma biblioteca de componentes copia-e-cola no estilo shadcn para Remotion, não um plugin HyperFrames e não uma dependência de tempo de execução de projetos de vídeo.
• Carregue sob demanda; não faz parte de toda inicialização: apenas quando o storyboard precisar de um motion / transição / simulação de UI pronta do Remocn, ou o operador nomear explicitamente Remocn / Remotion, leia o skills/remocn/SKILL.md local na íntegra. Para um filme completo, leia então skills/remocn/references/anatomy.md e os references/archetypes/<type>.md correspondentes; não carregue todos os arquétipos de uma vez.
• HyperFrames continua sendo a pilha padrão: em jobs /minara-video comuns, trate o Remocn apenas como uma referência de shot / motion, e traduza a lógica de motion do componente escolhido para uma timeline determinística e buscável do HyperFrames GSAP/DOM. Não coloque React/Remotion TSX diretamente no HTML da cena, e não troque de pilha só porque existe um componente pronto.
• Use diretamente apenas quando Remotion for explicitamente escolhido: em um projeto Remotion existente, se components.json estiver faltando, execute npx shadcn@latest init primeiro; depois instale apenas os componentes selecionados pelo storyboard: npx shadcn@latest add @remocn/<nome>. shadcn resolve dependências recursivamente; modifique o código depois que ele for copiado para o projeto atual. Não instale tudo, e não deixe o filme final referenciar o caminho do repositório Remocn local.
• Parâmetros dos componentes seguem a documentação ao vivo: primeiro leia https://remocn.dev/llms-components.txt para filtrar, depois leia a página específica .../<component>.md para a qual a tabela aponta; não adivinhe props, padrões ou durações. Para investigar uma implementação, volte para a fonte registry/ da biblioteca local e content/docs/.
• Adapte às regras Minara; não copie a aparência padrão: a estrutura do shot, o motion e o timing do Remocn podem ser reutilizados, mas a fonte deve ser alterada para Geist, e cor, tamanho de tipo, densidade de informação, a easing característica e transições ≤0.5s ainda seguem as regras desta skill. Length na documentação do Remocn é o quadro onde a própria ação do componente termina, não a duração total da cena; adicione tempo de espera conforme o script por segundo. Seu padrão 1280×720 @ 30fps também não substitui a especificação de saída do projeto Minara atual.
• Distinga os dois tipos de API: o nível de animação é orientado a quadros e aceita speed; os primitivos remocn-ui são orientados ao estado da timeline e não têm prop speed. Ambos devem ser reproduzíveis quadro a quadro, e Math.random() / Date.now() / animação orientada a intervalos ainda é proibida.

📸 Regras da biblioteca de componentes de demonstração de produto Remotion local snapcn (2026-09-04)

• Caminho fixo da biblioteca local: $VIDEO_WORKSPACE/snapcn/ (GitHub snapcndev/snapcn, MIT). Mesmo tipo de coisa que o Remocn - uma biblioteca de componentes copia-e-cola no estilo shadcn para Remotion - mas focada em shots de demonstração de produto de software: fluxos de chat de IA, entrada de prompt, terminais, molduras de dispositivos, legendas. Não é um plugin HyperFrames e não é uma dependência de tempo de execução de projetos de vídeo.
• Divisão de trabalho com Remocn: Remocn tende a motion / transições / arquétipos gerais; snapcn tende a "colocar a UI do produto no shot". Minara é um copiloto de negociação de IA, então o grupo AI Chat Input do snapcn (search-typing / prompt-zoom / answer-stream / prompt-send / answer-highlight / agent-steps) e Screens & Devices (phone-frame / laptop-frame / terminal-simulator / screen-recording / cursor-track) são as referências preferidas. Para cenas como "Defina Sua Estratégia", respostas do Copilot, ou etapas de execução do Autopilot, olhe aqui primeiro.
• Carregue sob demanda; não faz parte de toda inicialização: apenas quando o storyboard precisar dos shots de demonstração de produto acima, ou o operador nomear explicitamente snapcn / Remotion, leia o skills/snapcn/SKILL.md local. Escolha os componentes através da tabela de roteamento em skills/snapcn/references/components/index.md (com Use para / Evite para / Duração / Vibração), e abra apenas o references/components/<nome>.md selecionado; não leia todos. Para estrutura de filme, consulte references/anatomy.md (Gancho → Posicionamento → Revelação do Produto → Recursos → Prova → CTA) e references/archetypes/.
• HyperFrames continua sendo a pilha padrão: em jobs /minara-video comuns, trate o snapcn apenas como uma referência de shot / motion / timing, e traduza a lógica de motion do componente escolhido para uma timeline determinística e buscável do HyperFrames GSAP/DOM; para detalhes de implementação, olhe a fonte registry/snap-cn/<nome>/. Não coloque React/Remotion TSX diretamente no HTML da cena, e não troque de pilha só porque existe um componente pronto.
• Use diretamente apenas quando Remotion for explicitamente escolhido: npx shadcn@latest add @snapcn/<nome> (@snapcn já está no diretório de registro shadcn, então nenhuma configuração de registries é necessária). O projeto Remotion precisa de um components.json primeiro, e o alias @/ configurado tanto em tsconfig.json quanto em remotion.config.ts - o bundler do Remotion não lê caminhos do tsconfig. Instale apenas os componentes selecionados pelo storyboard; não instale tudo; o filme final não deve referenciar o caminho do repositório snapcn local.
• Parâmetros dos componentes seguem a documentação: documentação ao vivo em https://snapcn.dev/llms.txt (versão completa llms-full.txt); não adivinhe props / padrões / durações. Length é a duração natural em quadros da própria ação do componente (ex. answer-stream 150f, search-typing 420f), não a duração total da cena; adicione tempo de espera conforme o script por segundo. Abaixo do orçamento é truncado; acima do orçamento é tempo morto.
• Três regras que vale a pena adotar diretamente (elas já apontam na mesma direção que as regras desta skill): ① o modelo de câmera em MOTION.md - shots não são cortes, mas uma câmera virtual que se move / gira pelo mesmo mundo: movimento de saída rápido 8–14f + assentamento de spring na chegada 10–16f + espera de texto 30–45f, a mesma origem da receita "camera push-in follow" desta skill; ② os padrões anti-AI-slop em skills/snapcn/references/design.md - sem letter-spacing decorativo, sem tudo em maiúsculas, sem texto gradiente, sem sombras de brilho, consistente com a remoção de gradiente de 2026-09-02; ③ escalonar texto com a linha de base como pivô + text-rendering: geometricPrecision, que reduziu o tremor de 0.284px para 0.014px (a regra motion-quality); use-o para animações de escalonamento de textos grandes.
• Adapte às regras Minara; não copie a aparência padrão: a fonte deve ser alterada para Geist; cor, tamanho de tipo (UI grande legível em telefones), densidade de informação, a easing elástica característica e transições ≤0.5s ainda seguem as regras desta skill. Seu padrão 1280×720 @ 30fps não substitui a especificação de saída do projeto Minara atual.
• Distinga os dois tipos de API: o nível de animação snapcn é orientado a quadros e tem speed; os primitivos snap-cn-ui (input / caret) são orientados ao estado da timeline e não têm speed. Ambos devem ser reproduzíveis quadro a quadro; a piscada do cursor usa Math.floor(frame/15) % 2, passos de terminal com rolagem em vez de eases, e Math.random() / Date.now() / intervalos ainda são proibidos.

🎵 Toda música e efeitos sonoros passam por /minara-music (2026-10-14)

Após a confirmação do script por segundo, use a skill minara-music para escrever o clima de cada seção e as ações na tela em cues.json. Mostre a folha de cues ao operador primeiro; após a confirmação, renderize BGM + SFX localmente (quando houver narração, também produza uma versão com volume reduzido). Não baixe música da web por capricho.

📱 Regra de cena de UI - UI grande, minimalista, não copie o produto (definido pelo operador

…

[truncado para tradução]