general-video — autoria de composição geral
Confirme a rota antes de construir. Este é o fallback para autoria de composição personalizada. Se a entrada claramente se encaixa em um fluxo de trabalho especializado, prefira-o: produto comercializado →
/product-launch-video; site geral →/website-to-video; explicador de tópico →/faceless-explainer; PR do GitHub →/pr-to-video; filmagem existente →/embedded-captions·/graphic-overlays; motion graphic curto sem narração →/motion-graphics; porte do Remotion →/remotion-to-hyperframes. Fora do escopo: dados ao vivo / em tempo de renderização, edição estilo NLE de um vídeo finalizado ou produção de filmagens que o HyperFrames não pode capturar. Não tem certeza? Leia/hyperframesprimeiro.
Construa exatamente o que foi solicitado. Um cartão de título é um cartão de título — não um cartão de título + três cenas de apoio + música ambiente + legendas. Se cenas ou elementos extras melhorariam genuinamente a peça, proponha-os; não os adicione silenciosamente. Para pequenas edições (corrigir uma cor, ajustar uma duração, adicionar um elemento), pule as etapas de planejamento e vá direto para a construção.
Abordagem
Descoberta — apenas para solicitações abertas
Para solicitações vagas e exploratórias ("faça algo para nossa marca", "uma introdução legal") — entenda a intenção antes de escolher cores:
- Público — quem assiste? desenvolvedores / executivos / consumidores gerais?
- Plataforma — onde é reproduzido? social (15s) / hero do site / demo de produto / interno?
- Prioridade — o que mais importa? qualidade do movimento / precisão do conteúdo / fidelidade à marca / velocidade?
- Variações — uma melhor versão, ou 2-3 opções significativamente diferentes (ritmo, energia ou estrutura diferentes — não apenas trocas de cor)?
Para solicitações específicas ("adicione um cartão de título", "corrija o tempo da cena 3"), pule a descoberta.
Etapa 1 — Sistema de design → hyperframes-creative
Estabeleça a identidade visual primeiro. Se o projeto tem uma especificação de design, leia-a (precedência frame.md → design.md → DESIGN.md; trate-a como verdade da marca — cores, fontes, restrições exatas).
Se não houver especificação, você DEVE ler AMBOS hyperframes-creative/references/house-style.md E hyperframes-creative/references/video-composition.md antes de escolher qualquer cor ou fonte. house-style.md fornece a abertura "interpretar o prompt / gerar conteúdo real", a lista de padrões preguiçosos e a receita de camadas; video-composition.md fornece a densidade / escala / detalhamento do primeiro plano (barras de dados, marcas de registro, metadados monoespaçados, "8-10 elementos, dois que o usuário não pediu") que separa "produzido" de "gerado". Ler apenas um é o erro mais comum — video-composition.md é o que os agentes pulam, e é exatamente o que impede uma saída plana, centralizada e com aparência de página da web. Não invente uma paleta e pule estes; cruzar para hyperframes-creative é obrigatório aqui, não um ramo opcional. A partir daí, também extraia um estilo/clima nomeado → references/visual-styles.md, ou o seletor interativo → references/design-picker.md, conforme necessário. A especificação/estilo define a marca, não as regras de composição.
Encontre o ângulo (briefing vago, sem especificação): antes de escolher cores, escreva UMA frase — o que este nome/palavra/tópico evoca, e que mundo visual (metáfora, cenário, instrumento, motivo) o expressa? Ex.: uma ferramenta de cybersecurity → portas de cofre / linhas de varredura de perímetro / tambores de fechadura; um app de meditação → maré, respiração, bloom de luz lenta. Leia o significado do assunto, não apenas suas letras; escolha um ângulo concreto em vez de uma reformulação estilística literal. Este é o substituto barato para a expansão de prompt (Etapa 2) em peças de cena única, onde a expansão é corretamente pulada — e é a diferença entre um conceito projetado e um logotipo genérico em um gradiente.
Etapa 2 — Expansão de prompt → hyperframes-creative
Execute para toda composição de várias cenas (pule para peças de cena única e edições triviais). Fundamente a solicitação contra a especificação de design + estilo da casa em um intermediário consistente que o trabalho downstream leia da mesma forma. Veja hyperframes-creative/references/prompt-expansion.md.
Etapa 3 — Plano
Antes de escrever HTML, pense em alto nível:
- O quê — a experiência do espectador: arco narrativo, momentos-chave, batidas emocionais.
- Estrutura — quantas composições, sub-comp vs inline, quais faixas carregam vídeo / áudio / sobreposições / legendas. Para a decisão entre arquivo único monolítico vs sub-composições modulares, veja
hyperframes-core/references/composition-patterns.md§ Duas Arquiteturas (regra prática: ≥3 cortes de cena fortes, ou qualquer cena reutilizada → modularize; uma peça curta de cena única permanece em um arquivo). - Ritmo — nomeie o padrão antes de implementar (ex.:
rápido-rápido-LENTO-SHADER-pausa); vejahyperframes-creative/references/beat-direction.md. - Tempo — quais clipes determinam a duração, onde as transições ocorrem, o ritmo.
- Layout — construa o estado final primeiro (veja abaixo).
- Animar — depois adicione movimento via
hyperframes-animation.
Layout Antes da Animação
Posicione cada elemento onde ele fica em seu momento mais visível — totalmente entrado, colocado corretamente, ainda não saindo. Escreva isso como HTML + CSS estático primeiro. Sem GSAP ainda.
Por quê: se você posicionar elementos em seu estado inicial animado (fora da tela, escalados para 0, opacidade 0) e animar para onde você acha que eles vão parar, você está adivinhando o layout final — sobreposições permanecem invisíveis até a renderização. Construa o estado final primeiro e você verá e corrigirá problemas de layout antes de adicionar movimento.
- Identifique o quadro herói para cada cena — o momento em que mais elementos estão simultaneamente visíveis. Esse é o layout que você constrói.
- Escreva CSS estático para esse quadro. O contêiner de conteúdo deve preencher a cena com padding, não com deslocamentos absolutos:
.conteudo-cena {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* padding posiciona o conteúdo; preenche qualquer tamanho de cena */
gap: 24px;
box-sizing: border-box;
}
Nunca use position: absolute; top: Npx em um contêiner de conteúdo — ele transborda quando o conteúdo é mais alto que o espaço. Reserve o posicionamento absoluto para elementos decorativos.
⚠ O
width/height: 100%acima só funciona se cada ancestral tiver uma altura definida. A<div data-composition-id>raiz e qualquer wrapper entre ela e.conteudo-cenadevem ser dimensionados (position: relative; width: 1920px; height: 1080pxna raiz — vejahyperframes-core→ "Raiz deve ser dimensionada"). Pule isso e o contêiner flex colapsa para ~0, o conteúdo se acumula no canto superior esquerdo, e o primeiro glifo corta em x=0 — enquantolint/inspectainda relatam 0 problemas. E sempre mantenha opadding(≥80px) no.conteudo-cena: é a margem de segurança do título. Nunca o substitua porgappuro.
- Adicione entradas — anime DE fora da tela/invisível PARA a posição CSS com
gsap.from()(em sub-composições prefiragsap.fromTo()para que o estado inicial seja explícito; vejahyperframes-core/references/sub-compositions.md). A posição CSS é a verdade absoluta; o tween é a jornada até ela. - Saídas são tratadas por transição — de acordo com as regras de transição de cena em
hyperframes-animation/transitions/, apenas a cena final anima os elementos para fora; entre cenas, a transição É a saída.
Espaço compartilhado ao longo do tempo: se o elemento A sai antes do elemento B entrar na mesma área, ambos ainda precisam de posições CSS corretas para seus respectivos quadros herói — a ordem da linha do tempo impede que coexistam, e a etapa de layout captura sobreposições acidentais. Brilhos/sombras em camadas e profundidade empilhada em z são sobreposições intencionais; a etapa é sobre capturar colisões não intencionais (dois títulos um em cima do outro, conteúdo vazando para fora do quadro).
Construir — delegue para as skills de domínio
Isso mapeia a superfície completa da skill (veja a descrição) para suas referências — não exaustivo; quando uma intenção não está listada, roteie através de hyperframes-creative (aparência/conceito), hyperframes-animation (movimento), hyperframes-core (contrato), hyperframes-media (áudio/legendas). A primeira linha é ADITIVA — leia-a E a sua linha de intenção, não uma ou outra.
| Construindo… | Leia primeiro (em ordem) |
|---|---|
| SEMPRE — toda peça não trivial, além da sua linha de intenção abaixo | hyperframes-creative/references/house-style.md + references/video-composition.md (também verificado na Etapa 1 / HARD-GATE; os detalhes de primeiro plano "produzido, não gerado") |
| Tipografia cinética / foco em texto | hyperframes-animation/techniques.md (tipo cinético) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| Cartão de título / barra inferior / sobreposição / PiP / texto-atrás-do-sujeito | hyperframes-creative/references/composition-patterns.md + (para o quadro centralizado/dimensionado) hyperframes-core → "Raiz deve ser dimensionada" |
| Revelação de logotipo / marca | hyperframes-animation/rules/svg-path-draw.md (desenhar) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| Dados / estatísticas / números | hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md |
| Produto / aplicativo / demonstração de UI | hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| Audio-reativo / musical | hyperframes-creative/references/audio-reactive.md (pré-extrair bandas; mapear para movimento) |
| Narrado / voz-sobreposta / legendas / subtítulos | hyperframes-media (tts, transcribe, autoria de legendas) → colocar ativos via hyperframes-core |
| Multi-cena / transições | hyperframes-animation/transitions/overview.md depois transitions/catalog.md (você não terminou após a visão geral — a receita GSAP está no catálogo) |
| Modular / sub-composições | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
Checklist de saída → hyperframes-cli
-
npx hyperframes lintenpx hyperframes validatepassam (bloqueie nos resultados) - adesão ao design verificada se uma especificação (
frame.md/design.md) existir — checklist emhyperframes-creative/references/design-adherence.md -
npx hyperframes inspectpassa, ou cada estouro está intencionalmente marcado - avisos de contraste resolvidos; para trabalho multi-cena, revise o mapa de animação (
hyperframes-animation/scripts/animation-map.mjs) - entregue a pré-visualização; renderize para MP4 apenas mediante solicitação explícita
- exiba a pré-visualização apenas na entrega (é a prévia final estável); não a exiba no meio da construção — snapshots em fase de construção são headless
Não é este fluxo de trabalho
- Um produto / empresa / SaaS / site específico sendo comercializado, lançado ou promovido →
/product-launch-video - Um conceito / tópico / artigo / como-X-funciona sendo explicado, sem produto →
/faceless-explainer - Uma PR do GitHub / mudança de código →
/pr-to-video - Uma filmagem existente de pessoa falando para adicionar legendas →
/embedded-captions - Portar uma composição Remotion existente →
/remotion-to-hyperframes - Cortar / editar um arquivo de vídeo finalizado como um NLE → fora do escopo (HyperFrames compõe HTML e mídia em uma linha do tempo determinística; ele não edita filmagens)