general-video — fluxo de trabalho de vídeo geral
Confirme a rota antes de construir. Este é o fallback para criação de composições personalizadas. Se a entrada se encaixar claramente em um fluxo de trabalho especializado, prefira-o: explicador de tópico →
/faceless-explainer; PR do GitHub →/pr-to-video; filmagem existente →/embedded-captions·/talking-head-recut; motion graphic curto sem narração →/motion-graphics. Fora do escopo: dados ao vivo / no momento da 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 + legendas. Se cenas ou elementos extras realmente melhorarem 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 ("crie algo para nossa marca", "uma introdução legal") — entenda a intenção antes de escolher as cores:
- Público — quem assiste? desenvolvedores / executivos / consumidores em geral?
- Plataforma — onde será exibido? rede social (15s) / herói do site / demonstração de produto / interno?
- Prioridade — o que é mais importante? qualidade do movimento / precisão do conteúdo / fidelidade à marca / velocidade?
- Variações — uma melhor tentativa, 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-design
Estabeleça a identidade visual primeiro. Se o projeto tiver 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 TANTO hyperframes-design/references/house-style.md QUANTO hyperframes-design/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 fallback lazy e a receita de camadas; video-composition.md fornece as regras de densidade / escala / detalhamento de primeiro plano (barras de dados, marcas de registro, metadados monoespaçados, "8-10 elementos, dois que o usuário não pediu") que separam o "produzido" do "gerado". Ler apenas um é o erro mais comum — video-composition.md é aquele que os agentes pulam, e é exatamente o que evita uma saída plana, centralizada e com aparência de página da web. Não invente uma paleta do zero e pule estes; entrar em hyperframes-design é obrigatório aqui, não uma ramificação opcional. A partir daí, também extraia um estilo/mood nomeado → references/visual-styles.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 as cores, escreva UMA frase — o que este nome/palavra/tópico evoca, e qual mundo visual (metáfora, cenário, instrumento, motivo) o expressa? Ex.: uma ferramenta de segurança cibernética → portas de cofre / linhas de varredura de perímetro / tambores de fechadura; um aplicativo de meditação → maré, respiração, leve florescimento de luz. Leia o significado do assunto, não apenas suas letras; escolha um ângulo concreto em vez de uma reformulação literal. Este é o substituto barato para a expansão do prompt (Etapa 2) em peças de cena única, onde a expansão é corretamente ignorada — e é a diferença entre um conceito projetado e um logotipo genérico em um gradiente.
Etapa 2 — Expansão do prompt → hyperframes-design
Execute para toda composição com várias cenas (pule para peças de cena única e edições triviais). Fundamente a solicitação com base na especificação de design + estilo da casa em um intermediário consistente que o trabalho downstream leia da mesma maneira. Veja hyperframes-design/references/prompt-expansion.md.
Etapa 3 — Planejamento
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 trilhas carregam vídeo / sobreposições / legendas. Para a decisão entre arquivo único monolítico vs modular sub-comp, veja
/hyperframes/core/references/composition-patterns.md§ Duas Arquiteturas (regra prática: ≥3 cortes de cena duros, ou qualquer cena reutilizada → modularizar; uma peça curta de cena única permanece um arquivo). - Ritmo — nomeie o padrão antes de implementar (ex.:
fast-fast-SLOW-SHADER-hold); vejahyperframes-design/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-motion.
Layout Antes da Animação
Posicione cada elemento onde ele fica em seu momento mais visível — totalmente inserido, colocado corretamente, ainda não saindo. Escreva isso como HTML + CSS estático primeiro. Ainda sem GSAP.
Por quê: se você posicionar os elementos em seu estado inicial animado (fora da tela, dimensionados para 0, opacidade 0) e animar para onde você acha que eles pousam, 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 o maior número de elementos está simultaneamente visível. 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 preenchimento, não com deslocamentos absolutos:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* o preenchimento 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 todo ancestral tiver uma altura resolvida. A<div data-composition-id>raiz e qualquer invólucro entre ela e.scene-contentdevem ser dimensionados (position: relative; width: 1920px; height: 1080pxna raiz — veja/hyperframes/core→ "A raiz deve ser dimensionada"). Pule isso e o contêiner flexível colapsa para ~0, o conteúdo se acumula no canto superior esquerdo, e o primeiro glifo é cortado em x=0 — enquantolint/inspectainda relatam 0 problemas. E sempre mantenha opadding(≥80px) em.scene-content: é a margem de segurança do título. Nunca o substitua porgapsimples.
- 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; veja/hyperframes/core/references/sub-compositions.md). A posição CSS é a verdade fundamental; 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-motion/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 ordenação da linha do tempo os impede de coexistir, e a etapa de layout detecta sobreposição acidental. Brilhos e sombras em camadas e profundidade z-stacked são sobreposição intencional; a etapa é sobre detectar colisões não intencionais (dois títulos um em cima do outro, conteúdo vazando para fora do quadro).
Construção — delegue para os skills de domínio
Isso mapeia a superfície completa do skill (veja a description) para suas referências — não exaustivo; quando uma intenção não estiver listada, roteie por hyperframes-design (aparência/conceito), hyperframes-motion (movimento), /hyperframes/core (contrato). A primeira linha é ADITIVA — leia-a E 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-design/references/house-style.md + references/video-composition.md (também verificado na Etapa 1 / HARD-GATE; o detalhamento de primeiro plano "produzido, não gerado") |
| Tipografia cinética / com foco em texto | hyperframes-motion/techniques.md (tipo cinético) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| Cartão de título / terço inferior / sobreposição / PiP / texto atrás do sujeito | hyperframes-design/references/composition-patterns.md + (para o quadro centralizado/dimensionado) /hyperframes/core → "A raiz deve ser dimensionada" |
| Revelação de logotipo / marca | hyperframes-motion/rules/svg-path-draw.md (desenho) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| Dados / estatísticas / números | hyperframes-motion/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-design/references/data-in-motion.md |
| Demonstração de produto / aplicativo / interface do usuário | hyperframes-motion/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| Várias cenas / transições | hyperframes-motion/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 existir uma especificação (
frame.md/design.md) — checklist emhyperframes-design/references/design-adherence.md -
npx hyperframes inspectpassa, ou todo transbordamento é intencionalmente marcado - avisos de contraste tratados; para trabalho com várias cenas, revise o mapa de animação (
hyperframes-motion/scripts/animation-map.mjs) - entregue a prévia; renderize para MP4 apenas sob solicitação explícita
- exiba a prévia apenas na entrega (é a prévia final estável); não a mostre no meio da construção — as capturas instantâneas da fase de construção são headless