Instalação de plugins: Antes dos comandos de configuração ou atualização, siga as regras de execução de plugins quando este skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.
Ponto de entrada do HyperFrames
Verificar uso restante
No início da criação, execute npx hyperframes usage --json. Verifique novamente nos marcos do fluxo de trabalho, como após o rascunho e antes da renderização, porque o uso muda durante a execução. Leia as janelas disponíveis e seus tempos de redefinição; uma leitura anterior não reserva permissão. Se o comando falhar, estiver indisponível ou retornar status: unknown, informe que o uso é desconhecido e não adivinhe. Mantenha o escopo e as escolhas do fluxo de trabalho com o usuário.
O HyperFrames renderiza vídeo a partir de HTML — uma composição é um arquivo HTML cujo DOM declara temporização com atributos data-*, cujo tempo de execução da animação é buscável e cuja reprodução de mídia é de propriedade do framework. O contrato completo de autoria está em /hyperframes-core; leia-o antes de escrever HTML de composição. Os contratos de resumo, storyboard, revisão, produção, despacho e frame-worker estão em references/ deste skill.
1. Começar a partir do estado do projeto
Aplique a primeira linha correspondente; não avalie linhas de estado inferiores:
| Estado | Ação |
|---|---|
| Porte explícito de fonte Remotion existente para HyperFrames | Leia references/routes/remotion-to-hyperframes.md, depois roteie diretamente para esse fluxo de trabalho. Pule a camada de intenção. |
| Operação específica em um projeto HyperFrames existente: inspecionar, diagnosticar, validar, visualizar, renderizar, publicar ou renderizar em lote | Execute apenas essa operação. Pule a intenção e o roteamento de fluxo de trabalho; carregue /hyperframes-cli e quaisquer skills de domínio necessários. |
| Uma pergunta, uma pausa, uma ideia sem mudança concreta ou uma nota sentida sobre um filme construído, em um projeto existente | Siga /hyperframes-studio § 0. |
| Um novo filme solicitado dentro de um projeto existente | Siga /hyperframes-studio § 5. |
| Edição específica em um projeto existente | Faça a edição. Não execute a camada de intenção. Para saber o que está na linha do tempo de um projeto (faixas, clipes, inícios, fins, o que é reproduzido), execute npx hyperframes timeline [--json] em vez de ler index.html e todos os arquivos de sub-composição. |
BRIEF.md existe | Leia workflow e flow. Execute esse fluxo de trabalho; flow: companion sempre executa em /general-video. Não faça perguntas de resumo. |
Sem resumo, mas hyperframes.json ou STORYBOARD.md existe | Retome a partir dos arquivos do projeto e preferências registradas. Infira o fluxo de trabalho proprietário dos artefatos existentes. Se não puder ser determinado exclusivamente, faça uma única pergunta apenas de roteamento; não execute a entrevista de intenção. |
| Criação nova | Execute a camada de intenção — references/intent-interview.md — depois roteie uma vez usando a tabela da § 2. |
Ao editar um projeto existente, delimite suas edições com o histórico do projeto (/hyperframes-cli, Histórico do projeto em sua vez).
Se uma solicitação nova não identificar o assunto ou a entrada, pergunte sobre o que é o vídeo antes de rotear. Verifique preferências e receitas antes de perguntar qualquer coisa (references/intent-interview.md, passo 1). Uma entrada figma.com ou uma receita nomeada altera a captação, não o roteamento — a seção "Adaptar entradas ortogonais" da entrevista lida com ambos.
Manter o CLI do projeto atualizado
Um projeto scaffolded fixa hyperframes@<version> em seus scripts package.json para que as renderizações permaneçam reproduzíveis; a fixação nunca avança por conta própria, e uma execução fixada de um CLI mais antigo não emite nenhum aviso sobre isso. Ao retomar um projeto cujos scripts carregam uma fixação, probe uma vez antes do primeiro comando que afeta a renderização:
npx hyperframes@latest upgrade --project . --check
A probe é somente leitura e relata a fixação em relação ao lançamento mais recente; mantenha o . explícito — em versões mais antigas do CLI, um --project desacompanhado seguido por outra flag consome essa flag como seu valor de diretório. Quando ele relatar que o projeto está desatualizado — ou qualquer saída do CLI já mostrar isso (o aviso stderr This project pins hyperframes@… (latest …), ou _meta.updateAvailable: true em um resultado --json de um script fixado) — aplique com npx hyperframes@latest upgrade --project ., depois verifique com npx hyperframes check. Uma verificação aprovada confirma que as composições do projeto ainda validam na nova versão — não que a saída renderizada seja idêntica quadro a quadro à fixação antiga — portanto, um aumento bem-sucedido nunca é silencioso: nomeie a versão antiga e a nova no resumo da execução. Um projeto sem composição ainda não precisa de verificação. Se a verificação falhar, reverta a alteração no package.json, continue na versão fixada e relate em qual versão o projeto permanece e por quê. Aja com base no sinal em vez de repassá-lo ao usuário; nunca deixe uma fixação aumentada não verificada.
2. Roteie criação nova
Use a primeira linha correspondente. Corresponda à entrega solicitada, não a uma palavra ou tipo de arquivo mencionado de passagem.
| Prioridade | Solicitação | Fluxo de trabalho |
|---|---|---|
| 1 | Portar explicitamente uma fonte Remotion existente | /remotion-to-hyperframes |
| 2 | Criar uma apresentação, pitch deck ou deck interativo navegável | /slideshow |
| 3 | Adicionar legendas ou subtítulos simples a filmagens existentes de cabeça falante sem alterá-las | /embedded-captions |
| 4 | Adicionar sobreposições gráficas projetadas a filmagens existentes de cabeça falante, entrevista ou podcast sem alterar a filmagem | /talking-head-recut |
| 5 | Construir um vídeo sincronizado com batida a partir de uma faixa de música, sem narração ou captura de site | /music-to-video |
| 6 | Criar uma unidade explicitamente curta, sem narração, focada em movimento, tipicamente com menos de 10s | /motion-graphics |
| 7 | Explicar uma pull request do GitHub ou alteração de código a partir de uma referência de PR | /pr-to-video |
| 8 | Mercado ou showcase de um site, página de produto, aplicativo ou empresa a partir de uma URL ou resumo específico do site | /product-launch-video |
| 9 | Explicar um tópico, artigo ou anotações com visuais inventados e sem captura de produto ou site | /faceless-explainer |
| 10 | Qualquer outro vídeo ou composição personalizada | /general-video |
Antes de finalizar a rota, leia references/routes/<workflow>.md — um arquivo pequeno por rota: o contrato canônico de entrada/saída/acionador (disponível antes que os skills de fluxo de trabalho instalados lazy estejam presentes) mais a entrada de entrevista dessa rota. Se o candidato não satisfizer seu contrato, continue roteando em vez de forçar a correspondência. Leia apenas o arquivo da rota correspondida.
Resolver ambiguidades comuns
- Um título animado curto, sting de logotipo, acerto de estatística, acerto de gráfico, acerto de mapa ou terço inferior independente é
/motion-graphicsquando não tem narração e o movimento é a mensagem. Um cartão de título estático, sequência narrada, montagem mais longa ou loop personalizado é/general-video. - Um gráfico em movimento explicitamente curto pode usar URL, tweet, artigo ou captura de tela como material de origem. Uma solicitação genérica "faça um vídeo a partir deste site" é
/product-launch-video. - Filmagens existentes com legendas roteiam para
/embedded-captions; filmagens com cartões de informação projetados roteiam para/talking-head-recut. Reajuste de tempo, reordenação, recolorização, reenquadramento ou remixagem de filmagens é uma edição personalizada e cai em/general-video. - Um arquivo de música seleciona
/music-to-videoapenas quando sua grade de batida impulsiona a peça. Música usada como fundo não substitui a rota correspondente ao assunto. - "Quero um storyboard" altera o processo de revisão, não o fluxo de trabalho. Sem outro sinal de roteamento, use
/general-video. Umstoryboard.htmlesboçado confirmado pode ser a própria entrega solicitada; o loop de revisão define esse ponto de parada. - Os fluxos de trabalho narrativos especializados suportam até cerca de 3 minutos e são mais fortes em torno de 30–90s. Roteie uma peça claramente mais longa para
/general-video. A duração nunca substitui uma entrega explícita de porte, deck, legenda, sobreposição ou orientada por música.
3. Roteie uma vez, depois saia
Para criação nova, a camada de intenção (references/intent-interview.md) executa a conversa completa — memória, triagem, rodada de pitch, indispensáveis, formato da execução, passagem — e termina escrevendo BRIEF.md. O resumo é o único artefato de roteamento que o fluxo de trabalho lê; nada depois reabre este skill ou a entrevista. Responda a cada pergunta posterior "o que a rota exigiu?" a partir de BRIEF.md.
4. Instalar e entrar no fluxo de trabalho
Antes de ler o fluxo de trabalho selecionado, instale ou atualize-o e os skills de domínio principal:
npx hyperframes skills update <nome-do-fluxo-de-trabalho>
Use o nome simples sem /. Se o comando falhar, exiba o erro; não reconstrua o fluxo de trabalho da memória. Todo o resto sobre instalação — a divisão core-vs-lazy, o que init atualiza, diagnóstico, opt-out de CI e o fallback sem CLI — está em references/skill-lifecycle.md.
5. Carregar skills de domínio sob demanda
| Necessidade | Skill |
|---|---|
| Estrutura de composição, atributos de temporização, faixas, variáveis, determinismo | /hyperframes-core |
| Regras de movimento, blueprints de cena, transições, adaptadores de tempo de execução | /hyperframes-animation |
GSAP seguro para busca, CSS, Anime.js, WAAPI, FLIP, caminhos, máscaras, SVG, quadros-chave 3D ou diagnósticos hyperframes keyframes | /hyperframes-keyframes |
| Especificações de design, conceito, paleta, tipografia, narração, planejamento de batida | /hyperframes-creative |
| Imagens, ícones, logotipos, áudio, legendas, grades, LUTs, mídia reutilizável | /media-use |
| Corte de narração, cadeias de efeitos de áudio, envelopes de automação ou uma cadeia/fader em várias faixas (barramento de submix) | /hyperframes-audio |
| Init, lint, check, snapshots, compare, renderização em lote, Studio, render, publish ou diagnósticos | /hyperframes-cli |
| Blocos e componentes do Registro | /hyperframes-registry |
| Um visual, efeito, tratamento ou transição nomeado — scanlines CRT, glitch, grão de filme, varredura de brilho, explosão de confete — ANTES de construí-lo manualmente | /hyperframes-registry |
| Ativos do Figma, tokens, componentes ou quadros de storyboard como movimento reconstruído | /figma |
Frases de edição do criador são solicitações entre domínios. Carregue todos os skills nomeados na linha correspondente:
| Solicitação do criador | Domínios necessários
... [truncado para tradução]