Linguagem de Movimento
Herda de skills/00-house-rules/SKILL.md. A implementação está em scripts/stingers.py; a
galeria que renderiza tudo está em scripts/build_stinger_gallery.py.
A única distinção que importa
Uma cena explica. Um stinger gestualiza.
| cena | stinger | |
|---|---|---|
| duração | 8–15s | 2–4s |
| carrega | um argumento que precisa ser lido | uma ideia que você já ouviu |
| face | oculta ou PiP | oculta — você corta PARA ele |
| quantidade | 3–6 em um vídeo de 10 minutos | um a cada 20–40s |
| se removê-lo | o ponto deixa de ser compreendido | o vídeo fica mais chato, não errado |
Errar isso é a falha comum. Uma lista de três itens com conteúdo real é uma cena compare;
a mesma lista como steps é decoração. Se o espectador precisar ler, não é um stinger.
Stingers são cortados para, não sobrepostos. Eles dominam o quadro por seus poucos segundos. Um gráfico em tela cheia com o orador ainda visível atrás parece um erro, e 3 segundos sem o rosto dele não custam nada.
O vocabulário
Cinco elementos. Tudo na biblioteca é uma combinação deles, que é o que faz animações não relacionadas serem lidas como um sistema único.
| ground | Quase preto com uma elevação radial suave. Nunca #000 puro — um quadro preto verdadeiro parece uma falha, não um design. |
| glass | Preenchimento translúcido ~4.5% de tinta, borda de 1px ~14%, raio 26. A profundidade vem da borda e de um destaque interno, nunca uma sombra projetada no cartão. |
| sheen | Um brilho especular de baixo ângulo sobre um cartão quando ele se estabiliza. Este é o movimento característico — é o que faz um retângulo plano parecer um objeto físico. |
| path | Curvas tracejadas finas com ~10% de tinta. As coisas viajam ao longo dos caminhos. Nada teletransporta. |
| state | Uma linha de pequenos pontos carregando o estado do sistema. Mudança de cor nessa linha diz "e então quebrou" sem uma palavra de texto. |
O escalonamento de entrada é de 120–160ms. Abaixo de 100ms, os elementos irmãos são lidos como um único objeto; acima de 200ms, o espectador começa a esperar.
Cada stinger mantém seu último quadro. Ele é cortado contra a fala, portanto terminar em qualquer quadro após o payoff deve ser seguro. Nada faz loop; nada termina em um palco vazio.
A biblioteca
{ "kind": "converge", "from": "tudo alimenta um único lugar", "dur": 3.4,
"chips": ["skill.md", "prompt", "context", "tool", "rule", "doc"] }
| kind | a frase à qual pertence | dur |
|---|---|---|
converge | "Tudo isso alimenta um único lugar." Chips viajam por caminhos tracejados até um núcleo brilhante; os pontos de estado se preenchem conforme ele assume a carga. | 3.0–3.6 |
overload | "E então parou de funcionar." O mesmo núcleo racha em vermelho. Compartilha a geometria de converge para que os dois sejam cortados juntos como uma única história. | 2.4–3.0 |
steps | "Existem três desses." Cartões de vidro numerados, escalonados, brilho em cada um. O mais reutilizável e o mais usado em excesso. | 2.6–3.2 |
swap | "Isso, não aquilo." A é riscado e se aposenta para cima; B chega abaixo dele. Ambos permanecem legíveis. | 3.0–3.6 |
countup | "Era quarenta e três por cento." Um número sobe, o tamanho crescendo com o valor, sobre uma linha de origem visível. | 2.6–3.4 |
beats | Três frases curtas, percussivas. Cada uma recebe uma entrada diferente em uma grade de batidas compartilhada. | 2.4–3.2 |
surround | "Você está enterrado em ferramentas." Chips rotulados circundam um centro mantido e depois se fecham. O centro nunca se move. | 3.2–4.0 |
photo | Uma imagem encontrada, tratada. Cartão de vidro, Ken Burns lento, legenda, linha de crédito. | 2.8–4.0 |
clip | O mesmo cartão segurando filmagem em vez de uma imagem estática. Sem Ken Burns — ela já se move. | 2.4–3.0 |
Use-os em composition.json exatamente como uma cena — mesma ancoragem from / at / dur, mesmo
erro grave se a frase não resolver.
B-roll: o stinger photo / clip
Dois tratamentos, e full escolhe entre eles. full é opt-in; omita-o e você obtém o cartão.
full: true — B-ROLL | full: false — CITAÇÃO | |
|---|---|---|
| quadro | sangria total, sem cartão | cartão de vidro, brilho, deriva lenta |
| texto no quadro | um terço inferior nomeando o que é a imagem | legenda e linha de crédito |
| origem no quadro | nunca | obrigatório |
| uso para | filmagens e imagens estáticas que carregam um momento | uma captura de tela, um gráfico, uma página de preços, um documento |
B-roll é tela cheia e não carrega referência de origem. Instrução permanente do humano,
14/08/2026. Ele ocupa todo o quadro da mesma forma que o B-roll faz em qualquer edição que alguém já assistiu. O
único texto permitido sobre ele é um terço inferior dizendo o que a imagem é, nunca de onde
veio. A atribuição ainda acontece — no _FINAL/ATTRIBUTION.md do drop, que fetch_stock.py
escreve no momento do download e nenhuma edição pode pular. O Pexels e o Pixabay tornam o crédito
no quadro opcional, portanto o ledger satisfaz a licença por si só e o quadro permanece limpo.
Isso substitui o parágrafo que costumava viver aqui para B-roll, que dizia que um clipe de
sangria total "parece um vídeo diferente" e colocava tudo em um cartão. Esse raciocínio ainda
vale para o caso de citação e apenas para ele: quando o espectador deve ler o ativo como
evidência que você está citando, full: false e a linha de origem volta ao quadro.
O construtor ainda usa o cartão como padrão, e isso é deliberado. Inverter o padrão
reataria silenciosamente cada cena photo já escrita contra ele — o working/stingers/plan.json
do drop-005 entre elas — e uma especificação que renderizava um cartão ontem deve renderizar
o mesmo cartão hoje. Trabalhos novos pedem "full": true; skills/executive-animator sempre
faz. A mudança de uma palavra em st_photo é tudo o que é necessário se o cartão for um dia
aposentado definitivamente.
Uma nota de geometria: sangria total usa object-fit: cover, então forneça uma origem que já
seja 16:9. Um corte 2.19:1 mostrado em tela cheia perde 221px de cada lado, que é como um
diagrama termina com sua primeira e última coluna cortadas enquanto cada porta reporta uma caixa
correta.
Um construtor, dois nomes. photo para uma imagem estática, clip para filmagem; ele ramifica
com base na extensão do arquivo, então o nome só existe para tornar uma especificação legível. O que
realmente muda:
photo | clip | |
|---|---|---|
| elemento | <img> | <video muted playsinline> com temporização do framework |
| Ken Burns | sim, 1.00 → 1.07 sobre o cartão | nenhum |
A filmagem não recebe Ken Burns. O clipe fornece seu próprio movimento, e uma rampa de escala sobre movimento real é precisamente o que faz um estoque parecer estoque. Uma imagem estática é imóvel e precisa da deriva para permanecer viva; um clipe não precisa.
// B-roll. Tela cheia, terço inferior diz o que é, sem origem no quadro.
{ "kind": "clip", "from": "tudo está se movendo ao mesmo tempo", "dur": 3.0,
"src": "broll/cut-data-flow.mp4", "caption": "Tudo se movendo ao mesmo tempo" }
// Citação. Um documento que o espectador lê como evidência, então o cartão e o crédito voltam.
{ "kind": "photo", "full": false, "from": "a página de preços mudou", "dur": 3.2,
"src": "assets/pricing.png", "caption": "Preços da Anthropic, ago 2026",
"credit": "ANTHROPIC.COM · BUSCADO 2026-08-13" }
O terço inferior fica em cap_left / cap_bottom, padrão de 96 / 186 — paisagem, que
limpa os 96 à esquerda e 132 embaixo do youtube_long. Um chamador 9:16 deve passar seu próprio cap_bottom:
reels reserva 520 na parte inferior e a banda de karaokê ocupa y 1150-1400, então o padrão
paisagem coloca uma legenda sob a barra de progresso. Não há par que esteja certo em ambos os quadros.
src resolve relativo ao arquivo de especificação e o construtor o copia para o assets/
do projeto, portanto um caminho errado falha ruidosamente na construção em vez de como um
cartão vazio. Obtenha ambos de scripts/fetch_stock.py, que imprime o bloco pronto para colar.
A atribuição é uma obrigação do ledger, não uma obrigação do quadro. Cada ativo de nível 3
recebe sua linha no _FINAL/ATTRIBUTION.md do drop, escrita por fetch_stock.py no momento
do download — é o que config/broll-policy.md exige e não é opcional. Se o crédito também
aparece no quadro é uma decisão de design, e para B-roll a resposta é não. Em um cartão de
citação ele permanece, renderiza em WCAG AA, e uma atribuição que ninguém pode ler não é uma
atribuição.
Resolva cada imagem na ordem de nível primeiro. Uma foto é nível 3: recorra a ela apenas
quando sua própria filmagem e uma sobreposição de nível 2 genuinamente não tiverem nada. O Ken
Burns é executado no <img> dentro do cartão de recorte, nunca no próprio cartão.
⚠ Não copie o padrão longo de inserção de vídeo de terceiros. A referência da qual esta
linguagem veio tem 50 segundos de filmagem de entrevista de outra pessoa. config/broll-policy.md
proíbe isso explicitamente, e nenhuma quantidade de bom design de movimento torna isso nosso.
Fotos com atribuição são aceitáveis; pegar metade de um vídeo não é.
O menu mais amplo — o que usar quando nada acima se encaixa
Dois corpora upstream existem e ambos são maiores que esta biblioteca. Leia deles em vez de inventar movimentos.
Skill hyperframes-animation — 48 regras atômicas + 22 blueprints de cena. Carregue-a com
Skill(hyperframes-animation), depois abra rules-index.md e leia a regra que você precisa em
rules/<name>.md. O padrão da casa é compor 2–4 regras atômicas em uma linha do tempo pausada;
um blueprint é para quando você quer uma tomada completa de 4 a 5 fases.
O registro de blocos — 373 blocos instaláveis: npx hyperframes catalog --query "<conceito>",
depois npx hyperframes add <bloco>.
Situação → regra
Curado para um explicador de cabeça falante. Estas são as regras que sobrevivem ao nosso formato; o restante das 48 pressupõem principalmente uma UI de produto ou um cursor dirigido que não temos.
| quando a frase é… | regra | por que se encaixa |
|---|---|---|
| um número, uma estatística, uma porcentagem | counting-dynamic-scale, stat-bars-and-fills | já implementado como countup; use as regras diretamente para barras, anéis, preenchimentos de estrela |
| uma lista incisiva, de ritmo rápido | kinetic-beat-slam, waterfall-entry | implementado como beats; waterfall-entry é a cascata mais suave |
| uma definição ou um termo sendo apresentado | gradient-text-sweep, depth-scatter-assemble | os glifos nunca se movem na primeira; a segunda os monta a partir da profundidade |
| "aqui está o formato disso" (um diagrama) | svg-path-draw | o contorno se desenha sozinho. Meça com getTotalLength() na configuração |
| "está cercado / enterrado / conectado" | radial-surround, avatar-cloud-network, orbit-3d-entry | implementado como surround; os outros dois adicionam linhas de conexão e entrada 3D |
| uma ideia substituindo outra | scale-swap-transition, card-morph-anchor, morph-swap | implementado como swap; card-morph-anchor transforma o próprio contêiner |
| "olhe mais de perto para isso" | depth-of-field-blur, coordinate-target-zoom, viewport-change | foco seletivo, ou uma câmera virtual em um wrapper .world |
| ênfase em uma palavra falada | asr-keyword-glow, css-marker-patterns | brilho sincronizado com timestamps de palavras — já temos tempos de palavras medidos |
| um acento percussivo forte | chromatic-glitch, particle-burst, motion-blur-streak | use com moderação; no máximo um por vídeo |
| uma batida de aterrissagem calma | titlecard-reveal (blueprint), ambient-glow-bloom | movimento baixo é o payload, não uma deficiência |
| qualquer entrada | spring-pop-entrance | o pop canônico. Em caso de dúvida, este |
Blueprints que valem a pena conhecer
A maioria dos 22 são formas de anúncio de lançamento de produto. Quatro mapeiam o que realmente fazemos:
kinetic-type-beats— o cavalo de batalha. As palavras carregam a tomada, sem cenário, sem superfície.dataviz-countup— quando os dados carregam o argumento.comparison-split— duas capacidades pesadas ao mesmo tempo (nossa cenacompareé uma prima simplificada).titlecard-reveal— a batida de respiro, exatamente um movimento contido.
Pule cursor-ui-demo, device-surface-showcase, cta-morph-press, prompt-type-submit-generate
e o resto da família de demonstração, a menos que estejamos realmente mostrando uma UI de
produto. Eles são excelentes e não são nosso formato — um explicador de cabeça falante que de
repente performa uma demo de aplicativo falsa parece um anúncio.
O contrato que toda regra upstream assume
Vale a pena saber antes de copiar uma, porque quebrar isso não falha na verificação — falha na renderização:
- UMA linha do tempo GSAP pausada em
window.__timelines. Nunca reprodução automática, nunca uma segunda linha do tempo. - Seguro para busca em ambas as direções —
fromTocom estados from explícitos, valores absolutos, nunca+=relativo. O estado deve ser uma função pura do tempo da linha do tempo. - Determinístico — sem
Math.random(), semDate.now(). Apenas pseudo-aleatório derivado de índice. Repetições finitas, nuncarepeat: -1. - Apenas transformações e pintura. Tweens de
width/height/top/leftsão proibidos; use proxies de escala/translado ou máscaras. - Escalonamentos de grupo limitados para que uma chegada seja lida como uma única batida —
itens × escalonamento ≤ ~0.5s. - Pré-calcular constantes de layout. Nunca derivar uma posição no momento do tween; o renderizador amostra em paralelo e a medição dessincroniza.
Adicionando um novo conceito
- Pesquise o registro primeiro —
npx hyperframes catalog --query "<conceito>". 373 blocos existem.radial-surround,morph-swap,split-tilt-cardseparticle-image-revealsão primos próximos de coisas nesta biblioteca e podem ser um ponto de partida melhor do que código novo. - Construa-o a partir dos cinco elementos acima. Um conceito que precisa de um sexto elemento é ou uma cena, ou um sinal de que o vocabulário precisa de uma extensão deliberada — não uma exceção.
- Adicione-o a
KINDSemscripts/stingers.py. - Renderize a galeria e olhe para todos juntos. Essa é a única maneira de saber se um novo se juntou à família ou apenas pousou ao lado dela.
python3 scripts/build_stinger_gallery.py <out> --photo <image>
cd <out> && npx hyperframes check
python3 scripts/probe_frames.py <out> --plan --grid sheet.png
Três defeitos que esta biblioteca já pegou
Cada um passou por uma verificação hyperframes check limpa antes de alguém olhar para um quadro:
- GSAP não consegue animar
::after. Ele resolve alvos comquerySelector, que nunca retorna um pseudo-elemento, então todo brilho silenciosamente não fazia nada. O brilho agora é um elemento filho real (SHEEN_EL). Se você adicionar um cartão, coloque-o dentro. - GSAP r…
… [truncado para tradução]