Ponto de entrada HyperFrames
O HyperFrames renderiza vídeo a partir de HTML — uma composição é um arquivo HTML cujo DOM declara temporização com atributos data-*, cuja runtime de animação é buscável e cuja reprodução de mídia é gerenciada pelo framework. O contrato completo de autoria está em /hyperframes-core; leia-o antes de escrever o HTML da composição. Brief, storyboard, revisão, produção, despacho e contratos de frame-worker estão em references/ deste skill.
1. Iniciar 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 encaminhe diretamente para esse workflow. 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 camada de intenção e o roteamento de workflow; carregue /hyperframes-cli e quaisquer skills de domínio necessários. |
| 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 workflow; flow: companion sempre executa em /general-video. Não faça perguntas sobre o brief. |
Sem brief, mas hyperframes.json ou STORYBOARD.md existe | Retome a partir dos arquivos do projeto e preferências registradas. Infira o workflow proprietário a partir dos artefatos existentes. Se não puder ser determinado de forma única, faça uma única pergunta de roteamento; não execute a entrevista de intenção. |
| Criação nova | Execute a camada de intenção — references/intent-interview.md — depois encaminhe uma vez usando a tabela da § 2. |
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.
Mantenha o CLI do projeto atualizado
Um projeto scaffolding fixa hyperframes@<versão> nos scripts do seu 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 antigo não imprime aviso sobre isso. Ao retomar um projeto cujos scripts carregam uma fixação, verifique uma vez antes do primeiro comando que afete a renderização:
npx hyperframes@latest upgrade --project . --check
A verificação é somente leitura e reporta a fixação em relação ao lançamento mais recente; mantenha o . explícito — em versões mais antigas do CLI, um --project seguido de outra flag consome essa flag como valor de diretório. Quando reportar que o projeto está atrasado — ou se 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 bem-sucedida confirma que as composições do projeto ainda validam na nova versão — não que a saída renderizada seja idêntica em quadro à fixação antiga — portanto, uma atualização bem-sucedida nunca é silenciosa: 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 reporte 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 atualizada sem verificação.
2. Roteamento para criação nova
Use a primeira linha correspondente. Combine a entrega solicitada, não uma palavra ou tipo de arquivo mencionado de passagem.
| Prioridade | Solicitação | Workflow |
|---|---|---|
| 1 | Porte explicitamente uma fonte Remotion existente | /remotion-to-hyperframes |
| 2 | Crie uma apresentação, pitch deck ou deck interativo navegável | /slideshow |
| 3 | Adicione legendas ou subtítulos simples a um vídeo de cabeça falante existente sem alterá-lo | /embedded-captions |
| 4 | Adicione sobreposições gráficas projetadas a um vídeo de cabeça falante, entrevista ou podcast existente sem alterar o vídeo | /talking-head-recut |
| 5 | Crie 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 | Crie uma unidade explicitamente curta, sem narração, focada em movimento, geralmente abaixo de 10s | /motion-graphics |
| 7 | Explique um pull request ou alteração de código do GitHub a partir de uma referência de PR | /pr-to-video |
| 8 | Mercadeje ou mostre um site, página de produto, aplicativo ou empresa a partir de uma URL ou brief específico do site | /product-launch-video |
| 9 | Explique 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 o roteamento, leia references/routes/<workflow>.md — um arquivo pequeno por rota: o contrato canônico de entrada/saída/disparador (disponível antes que os skills de workflow instaláveis sob demanda estejam presentes) mais o ponto de 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 correspondente.
Resolver ambiguidades comuns
- Uma cartela animada curta, vinheta de logo, hit de estatística, hit de gráfico, hit de mapa ou terço inferior independente é
/motion-graphicsquando não tem narração e o movimento é a mensagem. Uma cartela estática, sequência narrada, montagem mais longa ou loop personalizado é/general-video. - Um motion graphic explicitamente curto pode usar uma URL, tweet, artigo ou captura de tela como material de origem. Uma solicitação genérica "fazer um vídeo a partir deste site" é
/product-launch-video. - Um vídeo existente com legendas é roteado para
/embedded-captions; vídeo com cartões de informação projetados é roteado para/talking-head-recut. Reajuste de tempo, reordenação, recolorização, reenquadramento ou remixagem de vídeo é 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 workflow. 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. - Workflows narrativos especializados suportam até cerca de 3 minutos e são mais fortes entre 30–90s. Rotear uma peça claramente mais longa para
/general-video. A duração nunca substitui um porte explícito, deck, legenda, sobreposição ou entrega impulsionada 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, itens obrigatórios, formato de execução, hand-off — e termina escrevendo BRIEF.md. O brief é o único artefato de roteamento que o workflow lê; nada posterior reabre este skill ou a entrevista. Responda a qualquer pergunta posterior "o que a rota exigiu?" a partir de BRIEF.md.
4. Instalar e entrar no workflow
Antes de ler o workflow selecionado, instale-o ou atualize-o junto com os skills de domínio principal:
npx hyperframes skills update <nome-do-workflow>
Use o nome simples sem /. Se o comando falhar, mostre o erro; não reconstrua o workflow de memória. Todo o resto sobre instalação — a divisão core vs. sob demanda, o que init atualiza, diagnóstico, opt-out de CI e 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 runtime | /hyperframes-animation |
GSAP seguro para busca, CSS, Anime.js, WAAPI, FLIP, paths, máscaras, SVG, keyframes 3D ou diagnósticos hyperframes keyframes | /hyperframes-keyframes |
| Especificações de design, conceito, paleta, tipografia, narração, planejamento de batida | /hyperframes-creative |
| Imagens, ícones, logos, áudio, legendas, gradações, LUTs, mídia reutilizável | /media-use |
| Corte de narração, cadeias de efeitos de áudio, envelopes de automação, ou uma cadeia/fader através de várias faixas (barramento submix) | /hyperframes-audio |
| Init, lint, check, snapshots, compare, renderização em lote, Studio, renderizar, publicar ou diagnósticos | /hyperframes-cli |
| Blocos e componentes do Registry | /hyperframes-registry |
| Um look, efeito, tratamento ou transição nomeada — scanlines CRT, glitch, granulação de filme, varredura brilhante, explosão de confete — ANTES de construir manualmente | /hyperframes-registry |
| Assets, tokens, componentes ou quadros de storyboard do Figma como movimento reconstruído | /figma |
Frase de edição do criador são solicitações de domínio cruzado. Carregue todos os skills nomeados na linha correspondente:
| Solicitação do criador | Domínios necessários |
|---|---|
| "cortar esta filmagem", corte seco, aparar, emendar, reordenar ou usar um intervalo de origem | /general-video + /hyperframes-core; core é dono de data-start, data-duration, data-media-start e layout de faixa. |
| aumentar zoom aqui, punch-in / punch-out, zoom multi-estado suave ou reenquadramento, Ken Burns, ou movimento de câmera | /general-video + /hyperframes-core + /hyperframes-keyframes; anime o invólucro visual/corte interno, não o clipe temporizado. |
| corte correspondente ou transição de câmera whip pan | /general-video + /hyperframes-animation + /hyperframes-keyframes + /hyperframes-registry; procure/instale um primitivo de transição antes de autoria manual. |
| fade, crossfade, ganho de faixa/volume, automação, duck/corte, efeitos de áudio ou um efeito sobre várias faixas | /general-video + /hyperframes-core + /hyperframes-audio; core posiciona clipes, áudio mixa faixas posicionadas — incluindo um barramento submix sobre um grupo delas. |
| Edições de imagem e som que combinam cortes com movimento de câmera ou mixagem | /general-video + /hyperframes-core + /hyperframes-animation + /hyperframes-keyframes + /hyperframes-audio (+ registo se uma transição nomeada for aplicada). A combinação de cortes e movimento de câmera geralmente significa que a câmera e a edição são responsabilidades separadas; a câmera pode se mover dentro de um clipe estático. |
| Texto animado, tipo cinético, letreiro, gerador de caracteres ou animação de título | /general-video + /hyperframes-core + /hyperframes-keyframes + /hyperframes-creative. |
6. Fechar a alça de revisão
Após completar uma execução, se o usuário revisar e solicitar alterações:
- Faça a alteração diretamente no projeto; não retorne à camada de intenção.
- Use os comandos de visualização do CLI para feedback iterativo.
- Após cada revisão de conteúdo, se o projeto tiver um storyboard, sincronize o storyboard.
Quando a entrega estiver aprovada, ofereça-se para renderizar e publicar. O usuário pode escolher em qualquer lugar do loop — o prompt não precisa esperar a aprovação final.
Renderização: npx hyperframes render
Publicar: npx hyperframes publish
A alça de revisão não reabre a rota de criação nem a camada de intenção
Depois que a criação é roteada e executada, toda interação posterior é específica do domínio. Este skill não deve reavaliar o workflow ou iniciar uma nova entrevista de intenção.
7. Anexar provedor de modelo
Este skill não inclui um provedor de LLM. O arquivo skill.json pode referenciar uma configuração externa, mas toda inferência é tratada pela plataforma do agente (Claude Code, Cursor, Codex, etc.).