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 habilidade para qual intenção
| Você quer... | Vá para |
|---|---|
| Criar 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 tempo de execução (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 (cada elemento temporizado precisa de
data-start/data-duration/data-track-index; elementos temporizados precisam declass="clip"; as linhas do tempo do GSAP são pausadas e registradas emwindow.__timelines; apenas lógica determinística — semDate.now()/Math.random()/ rede) não está duplicado aqui — ele está 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 para MP4 a partir do código. Esse modelo tem limites externos rígidos. Uma solicitação que ultrapasse um deles não é uma escolha de roteamento — está fora do escopo, portanto recuse (ou aponte para a ferramenta correta) em vez de tentar um workflow. Estes decorrem da arquitetura, não de uma solicitação única:
- A renderização é determinística e autocontida. Cada valor, ativo e texto é gravado na criação; a renderização não faz chamadas de rede e nenhuma captura de 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 — obtenha os dados uma vez no momento da criação e grave-os, ou recuse. - O vídeo existente é sobreposto, nunca editado. O HyperFrames compõe quadros sobre um clipe de origem —
/embedded-captionsadiciona uma camada de legenda,/graphic-overlaysadiciona cartões gráficos projetados (terços inferiores, chamadas de dados, títulos) — e o clipe é reproduzido inalterado por baixo, mas nenhum dos dois pós-processa o fluxo de vídeo codificado. Alterar a filmagem em si (sua duração, cor, enquadramento, ordem ou áudio) é edição 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 web / React que não seja 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 de fala/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 workflows de nível superior. Ela não carrega fases internas de workflow, habilidades 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; a duração da SAÍDA é apenas um teto, não uma barreira. Para uma entrada correspondente, os workflows especializados lidam com qualquer coisa até ~3 min — qual workflow você entra é decidido pela intenção (o tipo de entrada e, para texto, o assunto), não pela duração. A duração importa apenas no extremo 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 de ≤~3 min, um terceiro eixo divide os dois workflows 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).
| Duração / 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 † |
| 3-5min tutorial | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| 5min+ mergulho profundo | /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 workflows 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 duração — por /embedded-captions (legendas / subtítulos) ou /graphic-overlays (sobreposições gráficas projetadas), divididas 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 (independente de entrada e duração): tudo mais longo que ~3 min (as linhas de 3-5 min / 5 min+) e todo 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 estilo NLE de um arquivo de vídeo finalizado — reajuste de tempo, recolorir, reenquadrar, reordenar, áudio).
† Filmagem existente se divide por intenção, não por duração. Legendas / subtítulos → /embedded-captions; sobreposições gráficas projetadas / empacotamento — terços inferiores, chamadas de dados, cartões com títulos, 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 motion graphic curto (~abaixo de 10s), sem narração, focado em design — tipo cinético, um destaque 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 — é roteado 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 motion-first sem narração (veja a etapa 2). Um tratamento mais longo ou narrado é roteado 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 workflow está 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 ENTRADA × DURAÇÃO. 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 por padrão a tabela de criação ou /hyperframes-core.
Procedimento de roteamento
- Determine o tipo de ENTRADA + duração 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 workflow — esclareça primeiro; não invoque um Workflow Skill e então pergunte, já que se comprometer com um workflow é em si a decisão de roteamento. Faça no máximo 2 perguntas de esclarecimento:
- "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 pessoa falando para legendar?"
- "Duração alvo — cerca de 3 minutos ou menos, ou mais longa (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, portanto 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 workflow escolhido reconfirma suas próprias especificidades na Etapa 0.
- Escolha pelo tipo de ENTRADA (intenção) primeiro; duração é apenas um teto, não uma barreira.
- Motion graphic curto focado em design (curto-circuito de gênero, precede a tabela de entrada) — o motion em si é a mensagem: tipo cinético, uma contagem de estatística/número, um destaque de gráfico, uma vinheta de logotipo, um terço inferior / sobreposição, ou uma animação de tweet / manchete / destaque de página capturada; tipicamente abaixo de ~10s, sem narração / voz over →
/motion-graphics. Isso é um gênero de SAÍDA, não um tipo de entrada — quando o pedido é claramente uma peça motion rápida, sem narração e 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 pessoa falando (o usuário tem um clipe e quer algo adicionado sobre ele) → divida por intenção, em qualquer duração (tipo de entrada vence sobre duração): 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 com título, citações em destaque, uma edição com pacote gráfico →/graphic-overlays. (Editar a filmagem em si — reajustar tempo, 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 referênciadono/repo#N, ou "este PR") →/pr-to-video(até ~3 min). - Caso contrário (URL / briefing / texto de tópico de produto): a intenção escolhe o workflow 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 duração. Roteie para
/general-video(o fallback independente de duração — veja a etapa 4) apenas quando o alvo estiver 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 workflow de ≤~3 min — a intenção decide dentro da faixa,/general-videocobre o resto.
- Motion graphic curto focado em design (curto-circuito de gênero, precede a tabela de entrada) — o motion em si é a mensagem: tipo cinético, uma contagem de estatística/número, um destaque de gráfico, uma vinheta de logotipo, um terço inferior / sobreposição, ou uma animação de tweet / manchete / destaque de página capturada; tipicamente abaixo de ~10s, sem narração / voz over →
- Desambigue as entradas de URL / texto para ≤~3 min (a divisão de intenção). Duas divisões:
- Tipo de URL + intenção — uma URL não vence 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, showcase de portfólio / blog / 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 de 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, sem produto e sem 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 final 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", "promover ") roteia para PLV mesmo sem um link clicável — PLV pode pesquisar o site na web e rastreá-lo para ativos da marca (a menos que o usuário opte por não participar, → modo de predefinição sem captura). Não colar a URL não torna isso um trabalho faceless / sem captura. A escolha verbatim-vs-reestruturação para um roteiro fornecido é interna ao PLV e nunca muda a rota.
- Pistas conflitantes → pergunte, não adivinhe. Se a fonte fornecida é o próprio marketing de um produto (sua landing page, um blog promocional sobre a plataforma deles) mas o usuário pede 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 vence mais automaticamente para PLV; seu tipo depois intenção decide: um link de PR do GitHub (
...
[truncado para tradução]