Communitygithub.com

AlessandroFare/fluxychat - Doutrina de Movimento (Gateway)

Leia isto ANTES de compor qualquer animação. Define a lei de movimento de alto nível que faz um vídeo com múltiplas cenas parecer UMA única tomada contínua da câmera, em vez de uma pilha de slides animados independentemente.

O que é fluxychat - Doutrina de Movimento (Gateway)?

O `fluxychat` Motion Doctrine (Gateway) é uma skill de sistema para agentes de IA (como Claude Code, Cursor, Codex) que serve como a lei de movimento mestre para animações HyperFrames. Ela estabelece que a saída de uma cena determina a entrada da próxima, através da **Lei Vetorial** (mesmo eixo, mesma direção, velocidade combinada, corte no meio do movimento em ambos os lados). A skill define um **vetor padrão** (esquerda) que representa progresso, e vetores reservados (cima, Z para frente/trás, explosão) que carregam significados narrativos específicos. Para evitar falhas comuns, ela introduz o **Ledger de Vetores** (`ledger.json`), um plano pré-escrito que deve ser verificado pelo script `seam-gate.mjs`. A skill também proíbe oscilações ociosas (como respiração ou flutuação), exigindo que cada momento entre entrada e saída seja preenchido com uma rota de movimento sustentado (revelações em etapas, câmera com intenção, vida de UI sequenciada). Por fim, ela inclui um catálogo de anti-padrões e uma pausa dramática obrigatória (0,3–0,75s) antes do clímax, garantindo que o movimento nunca seja meramente decorativo, mas sim uma ferramenta narrativa e de performance.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/AlessandroFare/fluxychat/tree/HEAD/.agents/skills/motion-doctrine

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Doutrina de Movimento (Gateway)

Leia isto ANTES de compor qualquer animação. Decide O QUE acontece em cada junta e como cada cena se comporta; as skills de técnica a implementam. Estas regras substituem as orientações de movimento genéricas/a montante. A falha que isso evita: cenas autoradas isoladamente — o momentum do olho morre a cada corte, e as cenas oscilam no lugar entre a entrada e a saída.

Mapa de rotas

Decisão (esta skill)Skill de implementação
Escolha de transição de junta + parâmetros + códigocut-the-curve §1–5 (o catálogo)
Cascatas de entrada de texto/elementocut-the-curve §6 (entrada cascata)
Reposicionamento de grupo em cena (sem corte)cut-the-curve §7 (curva de ajuste)
Ação liderada por cursor / início de cena / ignição de morphoversized-cursor
Mecânicas de renderização de junta / proteção contra flash brancoseam-craft
Trabalho de lançamento de produto / explicador / legendasobrepõe text-beat-economics, brand-faithful, captions-overlay no topo da skill a montante

Ordem de autoria: ledger de vetores (ledger.json) → CARIMBE as juntas mestre a partir dele (scripts/seam-stamp.mjs --ledger ledger.json --write index.html) → rota de movimento sustentado por fase → carriers e causas → comps de construção → VERIFIQUE (scripts/seam-gate.mjs). Autore manualmente apenas morphs de Tier A / match-cuts; juntas carimbadas passam pelo portal por construção.


Parte 1 — A Lei da Junta

A Lei Vetorial

Como a Cena A sai determina como a Cena B entra: mesmo eixo, mesma direção, velocidade combinada, corte no meio do movimento em ambos os lados.

  1. Eixo — x permanece x, y permanece y, Z permanece Z. Nunca troque eixos através de um corte.
  2. Direção — nunca espelhe. Em Z, direção = o SINAL da mudança de escala: crescer = empurrar (câmera para frente), encolher = puxar (câmera para trás). Uma saída que recua respondida por uma entrada que cresce do pequeno é um vetor espelhado — a violação mais comum, porque crescer-do-pequeno é a entrada padrão de elemento.
  3. Velocidade — velocidade inicial da entrada ≈ velocidade final da saída, através de eases espelhadas (saída power4.in + entrada power4.out, mesma distância e duração; o lado que entra pega ≥50% do caminho nocional). Mecânicas em cut-the-curve.
  4. Fase — o corte cai no meio do movimento em AMBOS os lados. Se acomodar antes do corte, ou começar do repouso depois dele, é um tempo morto.

A Corrente

Cada filme escolhe UMA direção dominante (padrão da casa: ESQUERDA). Cada junta comum a usa. Outros vetores são RESERVADOS — gastar um significa algo:

VetorSignificado
A corrente (ESQUERDA)"próxima batida" — progresso neutro para frente
Para cimaelevação — uma conclusão ou revelação se eleva acima do que veio
Z para frente (zoom-travessia)aprofundando no mesmo pensamento
Z para trás (zoom inverso)CHEGADA — algo maior pousa
Explosão de escala (explodir)saindo de um mundo — uma superfície explode em direção à câmera
  • Nunca execute juntas consecutivas em direções opostas — pingue-pongue soa como erro.
  • Uma mudança de direção precisa de uma causa visível (clique / ricochete / impacto) ou um limite de capítulo.

O Ledger de Vetores

Escreva-o antes de autorar qualquer linha do tempo mestre — como ledger.json na raiz do projeto (esquema: references/seam-gate.md). Uma linha por junta: tempo de corte, vetores de saída e entrada (eixo + direção sinalizada; linhas Z carregam o sinal de escala), seletores, técnica. Saída e entrada devem corresponder; se uma linha não corresponder, corrija o plano, não o easing. O verificador checa a consistência das linhas estaticamente antes de qualquer amostragem em tempo de execução.

Carriers

O olho segue objetos, não abstrações. As juntas mais fortes entregam um carrier concreto através do corte em posição E velocidade combinadas: um cursor no meio do caminho, um contêiner que encolhe/encaixa no próximo layout, uma marca que voa para seu lugar exato, o grupo de palavras de um corte cascata. Sem carrier natural, os heróis da cena o carregam (viagem parcial + fade precoce, entrada em pleno voo). Nunca um crossfade — ele não tem carrier algum.

Movimento Causal

Encadeie o movimento para que cada movimento seja visivelmente lançado pelo anterior: clique → compressão → liberação mola → voo → impacto → recuo → revelação.

  • Efeitos começam NO quadro causador — mesma posição na linha do tempo, nunca "logo depois."
  • Reações escalam com a massa implícita: elementos grandes recuam mais devagar, pequenos estalam.
  • Uma força é uma licença para mudar de direção; uma inversão sem causa é um pingue-pongue.

O Portal da Junta (portal de construção — execute o verificador, saia 0 ou a junta não está pronta)

node <SKILL_DIR>/scripts/seam-stamp.mjs --ledger ledger.json --write index.html  # gerar
node <SKILL_DIR>/scripts/seam-gate.mjs verify --ledger ledger.json --project .  # verificar

O script (uso + esquema do ledger: references/seam-gate.md) impõe numericamente, por junta: consistência da linha do ledger, saída ainda se movendo no corte, entrada em pleno voo (nunca do repouso), direção medida = direção do ledger, correspondência de velocidade de entrada/saída (AVISO), sobreposição zero (um lado visível por quadro — o corte não é um dissolve), a regra do sinal Z (d(escala)/dt mesmo sinal em ambos os lados; as entradas da cena que chega são escaneadas por conflito de sinal), e continuidade do retângulo carrier com escala ancestral incluída. Use seam-gate.mjs probe --t <corte> para encontrar os verdadeiros seletores carrier de cada junta ao autorar o ledger.

Regras que o script não pode verificar — ainda suas:

  1. Edições reabrem a junta. Qualquer mudança no primeiro/último ~1s de uma cena (incluindo re-timing para novo VO) invalida a auditoria daquele limite — execute o verificador novamente.
  2. Áudio é o relógio. Re-timing de cenas para os timestamps reais das palavras do VO; nunca apresse uma leitura para caber em um slot. Um VO regerado reabre suas juntas.
  3. Pegadinha do clip-gate (a causa usual de uma FALHA de sobreposição zero): um clip cujo data-start precede seu tween de entrada é desocultado em sua opacidade inicial — defina autoAlpha: 0 inicial E data-start = o tempo de corte, nunca antes.

Parte 2 — Performance (a cena continua performando)

Sem oscilação ociosa

Loops senoidais ociosos (respirar, flutuar, derivar, pulsar brilho) são PROIBIDOS como movimento sustentado — eles soam como "o vídeo está esperando." Uma cena que termina de entrar com segundos sobrando é um bug de planejamento: adicione história, não oscilação. Cada fase entre entrada e saída é propriedade de uma destas rotas (nomeie a rota no plano):

RotaO que é
Revelações em etapasSegure conteúdo de volta; libere-o nas batidas da narração — o quadro continua ganhando informação (padrão para ≥2 grupos de conteúdo)
Câmera com intençãoUm caminho mapeado de escala+pan: estabelecer amplo → viajar → chegar no sujeito
Vida de UI sequenciadaO produto se comporta ao longo do tempo: progresso avança, destaque de etapa, contadores marcam
Sequências animadasElementos encenam uma batida: um cartão é arquivado em uma pilha, um item é arrastado, um resultado se monta
Ação liderada por cursorUm cursor grande guia o olho para um gatilho; seu CLIQUE acende a próxima batida (oversized-cursor)

Teste: pause em qualquer segundo — algo significativo deve estar em pleno voo (uma revelação pousando, a câmera viajando, a UI fazendo o que a narração diz).

Pausa antes do clímax

Agende uma pausa de 0,3–0,75s entre a ação principal e seu resultado — a vírgula dramática. Uma cena que salta diretamente da ação para o resultado a perde.

Intenções de timing

  • Entrada única ≤ ~800ms; buildup mais longo = escalonamento de múltiplos elementos, não um elemento lento.
  • Saída ≈ 75% da entrada. Exceção: cut-the-curve inverte isso (entrada ~127% da saída).
  • Escalonamento total ≤ 500ms; com 8+ elementos, aperte o atraso por item ou escalone os primeiros.
  • Eases proibidos: bounce.out / elastic.out. Overshoot de entrada back.out(1.4–1.7) é aceitável.
  • Elementos semelhantes compartilham uma intenção de ease + duração — nunca um par único por elemento.

Vocabulário de transição

Use apenas 2–3 transições entre cenas por filme e repita-as; o limite padrão é cut-the-curve na direção da corrente. Morphs de elemento compartilhado escritos à mão (intent: morph) não contam para o orçamento.


Anti-Padrões

Não façaEm vez disso
Autore a entrada de cada cena isoladamenteEscreva o ledger de vetores primeiro
Crossfade entre cenasCut-the-curve na direção da corrente
Saída completa, DEPOIS a cena mudaCorte no meio do movimento em ambos os lados
Entrada começa do repouso após um corteEntre ≥50% através do caminho nocional
Saída com zoom inverso → entrada crescendo-do-pequeno (ou push → retração exagerada)Corresponda o sinal da velocidade de escala (Portal da Junta 7)
Introdução pop-in da própria cena que chega sob uma passagem ZSegure seu quadro de abertura composto, ou corresponda o sinal
Oscilação ociosa / respirar / flutuar para preencher tempoAtribua uma rota de movimento sustentado; ou adicione história
Inversão de direção sem causaGaste uma força, ou mantenha a corrente
Vetores reservados usados como variedadePadrão para a corrente; gaste-os com significado
Reação alguns quadros após sua causaIgnição no mesmo quadro
Ação salta diretamente para o resultadoAgende pausa antes do clímax (0,3–0,75s)

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

AlessandroFare/fluxychat

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.\n

AlessandroFare/fluxychat

Use when audio already placed in a HyperFrames composition needs to be mixed: a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.\n

AlessandroFare/fluxychat

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.\n

AlessandroFare/fluxychat

Install, discover, and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

AlessandroFare/fluxychat

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.\n

AlessandroFare/fluxychat

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

AlessandroFare/fluxychat

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

AlessandroFare/fluxychat

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

AlessandroFare/fluxychat

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

AlessandroFare/fluxychat

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

AlessandroFare/fluxychat

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

AlessandroFare/fluxychat

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

AlessandroFare/fluxychat

Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP timelines, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

AlessandroFare/fluxychat

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

AlessandroFare/fluxychat

Design and improve user interfaces using the concrete rules from Refactoring UI (Wathan & Schoger) — constrained spacing/type/color/shadow scales, visual hierarchy through weight and color rather than size, and depth through emulated light. Use when building or styling any UI (web, app, dashboard, landing page, component), when picking font sizes, spacing, colors, shadows or border radius, when designing a color palette or design tokens, and whenever someone says a UI "looks off", "looks amateur", "feels cluttered/plain/unfinished", or asks to "make this look better".

AlessandroFare/fluxychat

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

AlessandroFare/fluxychat

Use before UI-related work to select the smallest useful UI Skills context through the ui-skills CLI.

Habilidades Relacionadas