HyperFrames — leia isso primeiro
Comece aqui para qualquer tarefa do HyperFrames — especialmente quando não houver configuração de agente de projeto (CLAUDE.md / AGENTS.md / .cursorrules). Mapa de capacidades + roteador de vídeo abaixo.
Mapa de capacidades — qual skill para qual intenção
| Você quer… | Vá para |
|---|---|
| Fazer um vídeo (a partir de uma URL, briefing, tópico, PR do GitHub, filmagem existente ou um único elemento para animar) | o roteador de vídeo abaixo (§ Roteamento de vídeo) |
Criar / editar uma composição HTML — o contrato data-*, clipes, trilhas, subcomposições, variáveis | /hyperframes-core |
| Animar — regras de movimento atômicas, blueprints de cena, transições, adaptadores de runtime (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
Direção criativa — design.md, paletas, tipografia, narração, planejamento de batidas, áudio-reativo | /hyperframes-creative |
| Pré-processamento de mídia — narração TTS, música de fundo, transcrição, remoção de fundo, legendas | /hyperframes-media |
| Loop de desenvolvimento CLI — init, lint, validar, inspecionar, pré-visualizar, renderizar, publicar, doctor | /hyperframes-cli |
Instalar blocos / componentes do registro (hyperframes add) | /hyperframes-registry |
O contrato de criação de composição (todo elemento temporizado precisa de
data-start/data-duration/data-track-index; elementos temporizados precisam declass="clip"; timelines GSAP são pausadas e registradas emwindow.__timelines; apenas lógica determinística — semDate.now()/Math.random()/ rede) não é duplicado aqui — ele reside em/hyperframes-core. Leia isso antes de escrever HTML de composição.
O que o HyperFrames não pode fazer — verifique isso primeiro
O HyperFrames cria uma composição HTML e a renderiza em MP4 a partir de código. Esse modelo tem limites rígidos. Uma solicitação que ultrapasse um deles não é uma escolha de roteamento — está fora do escopo, então recuse (ou aponte para a ferramenta certa) em vez de tentar um fluxo de trabalho. Isso decorre da arquitetura, não de qualquer solicitação isolada:
- A renderização é determinística e autocontida. Cada valor, ativo e parte do texto é inserido durante a criação; a renderização não faz chamada de rede nem puxa dados ao vivo em tempo de renderização (regra central: sem
Date.now()/Math.random()/ rede). "Atualizar os números ao vivo no momento da renderização" está fora — busque os dados uma vez durante a criação e insira-os, ou recuse. - Vídeo existente é sobreposto, nunca editado. O HyperFrames compõe quadros sobre um clipe de origem —
/embedded-captionsadiciona uma camada de legenda,/graphic-overlaysadiciona cartelas gráficas projetadas (terços inferiores, chamadas de dados, títulos) — e o clipe é reproduzido inalterado por baixo, mas nenhum deles pós-processa o fluxo de vídeo codificado. Alterar a filmagem em si (sua temporização, cor, enquadramento, ordem ou áudio) é edição no estilo NLE e está fora do escopo. - A importação do Remotion é unidirecional.
/remotion-to-hyperframestraduz o código-fonte do framework Remotion para HyperFrames. Não há reverso (HyperFrames → Remotion, ou → qualquer outro framework — fora do escopo), e uma fonte de animação React / web não-Remotion não tem fonte Remotion para traduzir — recrie-a via/general-video. - Não pode produzir entradas que não possui. Sem gravação de tela / sessão, sem captura de câmera, sem geração de avatar com IA talking-head / sincronização labial. Se a filmagem ou o ativo ainda não existir, o HyperFrames não pode criá-lo do nada — peça ao usuário para fornecê-lo (ou use a ferramenta de captura correta) primeiro.
Todo o resto — um vídeo a partir de uma URL, briefing, tópico, PR, filmagem para anotar ou um único elemento para animar — está no escopo; roteie abaixo.
Roteamento de vídeo
Esta seção conhece APENAS fluxos de trabalho de alto nível. Ela não carrega fases internas do fluxo de trabalho, skills de domínio (hyperframes-* — veja o mapa de capacidades acima) ou referências técnicas.
Tabela de decisão
O TIPO de ENTRADA (intenção) é o eixo principal; o comprimento da SAÍDA é apenas um teto, não um portão. Para uma entrada correspondente, os fluxos de trabalho especializados lidam com qualquer coisa até ~3 min — qual fluxo de trabalho você entra é decidido pela intenção (o tipo de entrada e, para texto, o assunto), não pelo comprimento. O comprimento importa apenas no limite superior: uma peça genuinamente mais longa (um tutorial de 3-5 min, um mergulho profundo de 5 min+) é um registro diferente e é roteada para /general-video. Dentro da faixa ≤~3 min, um terceiro eixo divide os dois fluxos de trabalho alimentados por texto — o assunto: um produto sendo comercializado vs um tópico sendo explicado (veja a regra de desambiguação na etapa 3 abaixo).
| Comprimento / Entrada | Lançamento de produto (URL / briefing / roteiro) | Site geral / URL | PR do GitHub / alteração de código | Tópico / artigo / anotações (sem produto, sem URL) | Vídeo existente (talking-head) † |
|---|---|---|---|---|---|
| ≤ ~3 min | /product-launch-video | /website-to-video | /pr-to-video | /faceless-explainer | /embedded-captions · /graphic-overlays † |
| Tutorial de 3-5 min | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| Mergulho profundo 5min+ | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| Estático / loop | /general-video | /general-video | /general-video | /general-video | /general-video |
Cobertura atual: a faixa ≤ ~3 min tem fluxos de trabalho dedicados para entradas de lançamento de produto / site geral / PR do GitHub / tópico (uma URL se divide por tipo depois intenção — veja a etapa 3), e a coluna vídeo existente é coberta em qualquer comprimento — por /embedded-captions (legendas / subtítulos) ou /graphic-overlays (sobreposições gráficas projetadas), divididos por intenção (veja a etapa 2). Todas as outras células são /general-video — o fluxo geral de criação de composição HTML (agnóstico a entrada e comprimento): tudo mais longo que ~3 min (as linhas de 3-5 min / 5 min+) e cada formato estático / loop. O roteador nunca termina em um beco sem saída para um vídeo criável; a única resposta verdadeira "geral / nenhum" é uma solicitação fora do próprio HyperFrames (por exemplo, edição no estilo NLE de um arquivo de vídeo finalizado — re-temporização, recolorir, reenquadrar, reordenar, áudio).
† Filmagem existente se divide por intenção, não por comprimento. Legendas / subtítulos → /embedded-captions; sobreposições gráficas / empacotamento projetados — terços inferiores, chamadas de dados, cartelas intituladas, citações em destaque — → /graphic-overlays. Ambos sobrepõem o clipe, que é reproduzido inalterado por baixo; nenhum edita a filmagem em si.
Curto-circuito de gênero (precede a tabela). Um gráfico em movimento curto (~menos de 10s), sem narração, focado em design — tipo cinético, um impacto de estatística/gráfico, uma vinheta de logotipo, um terço inferior / sobreposição, ou um tweet animado / manchete / destaque de página capturada — roteia para /motion-graphics independentemente da entrada. É um GÊNERO de SAÍDA, não um tipo de entrada, portanto tem precedência sobre a tabela de tipo de entrada acima quando o pedido é claramente focado em movimento sem narração (veja a etapa 2). Um tratamento mais longo ou narrado roteia por tipo de entrada, ou /general-video.
Migrando uma composição existente (caso especial)
A tabela acima é para criar um vídeo a partir de uma entrada. Um fluxo de trabalho fica fora dela: se o usuário pedir explicitamente para portar / converter / migrar uma composição existente do Remotion (React) para HyperFrames → /remotion-to-hyperframes. Isso é tradução de código-fonte, não criação a partir de entrada, portanto não tem célula de ENTRADA × COMPRIMENTO. Roteie aqui APENAS em linguagem explícita de migração ("portar meu projeto Remotion", "converter esta composição Remotion", "reescrever isto como HyperFrames") — uma menção passageira ao Remotion não é um gatilho; use como padrão a tabela de criação ou /hyperframes-core.
Procedimento de roteamento
- Determine o tipo de ENTRADA + comprimento alvo. O roteamento precisa saber sobre o que é o vídeo — seu assunto e entrada. Se o assunto em si não for especificado (por exemplo, "faça um vídeo sobre nossa coisa" sem URL, produto nomeado, tópico ou ativo para trabalhar), ou o tipo de entrada for desconhecido, pergunte antes de entrar em qualquer fluxo de trabalho — esclareça primeiro; não invoque uma Skill de fluxo de trabalho e depois pergunte, pois comprometer-se com um fluxo de trabalho é em si a decisão de roteamento. Faça no máximo 2 perguntas esclarecedoras:
- "Qual é sua entrada — um produto (URL ou briefing), um site geral / URL, um PR do GitHub / alteração de código, um tópico ou artigo para explicar, ou um vídeo existente de talking-head para legendar?"
- "Comprimento alvo — cerca de 3 minutos ou menos, ou mais longo (um tutorial de 3-5 min / mergulho profundo de 5 min+)?"
- Padrões de especificação — declare, não pergunte (estes NÃO afetam a rota, então nunca bloqueie o roteamento neles): proporção 16:9 (o mecanismo também suporta 9:16 vertical — mude apenas se o usuário nomear um destino vertical como TikTok / Reels / Shorts); idioma da narração / legenda = o do usuário. Confirme apenas se o usuário contestar; o fluxo de trabalho escolhido reconfirma suas próprias especificações na Etapa 0.
- Escolha pelo tipo de ENTRADA (intenção) primeiro; o comprimento é apenas um teto, não um portão.
- Gráfico em movimento curto focado em design (curto-circuito de gênero, precede a tabela de entrada) — o movimento em si é a mensagem: tipo cinético, uma contagem de estatística/número, um impacto de gráfico, uma vinheta de logotipo, um terço inferior / sobreposição, ou um tweet animado / manchete / destaque de página capturada; tipicamente abaixo de ~10s, sem narração / voz sobreposta →
/motion-graphics. Isso é um GÊNERO de SAÍDA, não um tipo de entrada — quando o pedido for claramente uma peça de movimento rápida, sem narração, focada em design, roteie aqui independentemente da entrada. Um tratamento mais longo ou narrado do mesmo material NÃO é isso (roteie por tipo de entrada, ou/general-video). - Vídeo existente de talking-head (o usuário tem um clipe e quer algo adicionado sobre ele) → divida por intenção, em qualquer comprimento (o tipo de entrada vence sobre o comprimento): legendas / subtítulos (as palavras faladas como texto legível) →
/embedded-captions; sobreposições gráficas projetadas — terços inferiores, chamadas de dados, cartões de informação intitulados, citações em destaque, uma edição empacotada com gráficos →/graphic-overlays. (Editar a filmagem em si — re-temporização, recolorir, reenquadrar, reordenar, áudio — é estilo NLE e está fora do escopo; veja § O que o HyperFrames não pode fazer.) - PR do GitHub / alteração de código (um link
github.com/<dono>/<repo>/pull/<N>, uma refdono/repo#Nou "este PR") →/pr-to-video(até ~3 min). - Caso contrário (URL de produto / briefing / texto de tópico): a intenção escolhe o fluxo de trabalho via etapa 3, e ele lida com qualquer coisa até ~3 min — um promo curto de 15-30 s e um explicador de ~100 s ambos roteiam por intenção, não por comprimento. Roteie para
/general-video(o fallback agnóstico a comprimento — veja a etapa 4) apenas quando o alvo for claramente mais longo que ~3 min (um tutorial de 3-5 min, um mergulho profundo de 5 min+). Nunca force uma peça genuinamente longa em um fluxo de trabalho de ≤~3 min — a intenção decide dentro da faixa,/general-videocobre o resto.
- Gráfico em movimento curto focado em design (curto-circuito de gênero, precede a tabela de entrada) — o movimento em si é a mensagem: tipo cinético, uma contagem de estatística/número, um impacto de gráfico, uma vinheta de logotipo, um terço inferior / sobreposição, ou um tweet animado / manchete / destaque de página capturada; tipicamente abaixo de ~10s, sem narração / voz sobreposta →
- Desambigue as entradas de URL / texto de ≤~3 min (a divisão de intenção). Duas divisões:
- Tipo de URL + intenção — uma URL não ganha mais automaticamente para PLV; seu tipo depois intenção decide: um link de PR do GitHub (
.../pull/<N>,dono/repo#N, "este PR") →/pr-to-video; caso contrário, uma URL de site se divide por intenção — marketing / lançamento / promoção de um produto ou SaaS específico →/product-launch-video; um site geral → vídeo (tour do site, portfólio / blog / vitrine de landing page, um clipe social dos próprios visuais do site, ou apenas "transforme este site em um vídeo") →/website-to-video. Ambos rastreiam com Chrome headless; URLs de PR são lidas viagh. Quando não estiver claro se uma URL de site é um lançamento de produto ou um vídeo de site geral, faça uma pergunta. - Produto vs tópico (texto, sem URL) — a pergunta decisiva é sobre o que é o vídeo, não o formato da entrada:
- Um produto / empresa / SaaS / aplicativo / site específico sendo comercializado, lançado ou promovido →
/product-launch-video. - Um conceito / tópico / artigo / como-algo-funciona sendo explicado, com nenhum produto e nenhuma URL →
/faceless-explainer. - Desempates: redação "Promover / lançar / vender / nosso produto" → PLV. "Explicar / ensinar / como X funciona / o que é X" sem produto → faceless. O estilo padrão para faceless é sempre
pin-and-paper. - Um site nomeado sem URL colada ainda é PLV. Um roteiro que menciona um produto ou seu site ("nosso site é acme.io", "promova ") roteia para PLV mesmo sem link clicável — PLV pode pesquisar o site na web e rastreá-lo em busca de ativos da marca (a menos que o usuário opte por não fazer isso, → modo de predefinição sem captura). Não colar a URL não o torna um trabalho faceless / sem captura. A escolha de transcrever-ao-pé-da-letra-vs-reestruturar para um roteiro fornecido é interna ao PLV e nunca altera a rota.
- Pistas conflitantes → pergunte, não adivinhe. Se a fonte fornecida for o próprio marketing de um produto (sua landing page, um blog promocional sobre a plataforma deles) mas o usuário pedir explicitamente para remover a promoção — um explicador neutro do conceito subjacente, não um anúncio — trate como genuinamente ambíguo (o vídeo é...
- Um produto / empresa / SaaS / aplicativo / site específico sendo comercializado, lançado ou promovido →
- Tipo de URL + intenção — uma URL não ganha mais automaticamente para PLV; seu tipo depois intenção decide: um link de PR do GitHub (
[O conteúdo foi truncado para tradução — o texto acima é a representação fiel da SKILL.md original fornecida.]