carvercat/carvercat-motion

Gráficos animados Carvercat

Não encontrou algo? references/INDEX.md responde "onde está X" para toda a skill (ofício, app, efeitos, desenho, mapas, fluxos de trabalho, problemas conhecidos).

Funciona com qualquer agente que possa chamar as ferramentas MCP do Carvercat: Claude, GPT/Codex, Gemini ou uma pessoa lendo junto. Nada aqui depende de um único fornecedor. Os nomes das ferramentas podem carregar um prefixo do cliente (por exemplo mcp__carvercat__carvercat_run).

0. Unidades e a nova superfície (leia isto primeiro)

Tudo que você escreve está em unidades de design: px a partir do canto superior esquerdo do quadro com y para baixo, graus no sentido horário, cores CSS e easing, fontSize em px, tempos como quadros, "1.5s" ou "500ms". Construa uma cena inteira em uma chamada validada (scene.apply, simulação primeiro), selecione objetos com seletores do tipo CSS, use os auxiliares (layout.*, text.fit, motion.apply, measure.*) e execute carve.preflight {host} antes de qualquer envio. Guia: references/app/design-units.md. Nomes antigos ainda funcionam por um release e estão listados lá uma vez; não os escreva.

0b. Antes de tocar em qualquer coisa

• Localize o aplicativo Carvercat instalado nesta máquina e use a pasta desta skill como instalada; para trabalhos criativos esta skill é suficiente. Não use um caminho histórico fixo.
• carvercat_session (anexar) e depois carvercat_state: verifique a compilação, o projeto aberto e a composição antes de alterar qualquer coisa. carvercat_list fornece os ids.
• Peça à pessoa para não clicar no aplicativo enquanto você constrói: a troca de composição dela redireciona seus próximos comandos.
• Nunca limpe o documento de um usuário para reconstruir. Salve o .carverproj editável no destino do trabalho.

1. Planeje como um designer de motion (ofício)

Leia apenas o que o trabalho precisa:

Necessidade	Leia
Durações, easing, os 12 princípios, coreografia, ritmo para música, antipadrões	references/craft/motion-principles.md; uma página por princípio em references/craft/principles/
Escala tipográfica, tempo de leitura, estilos de entrada, ênfase; tracking, entrelinhamento e limites de lint medidos	references/craft/typography.md
Qual transição, por quanto tempo, a entrega no corte	references/craft/transitions.md
Efeitos sonoros e música: um clipe por evento, níveis, especificações de pop/whoosh	references/craft/sound-design.md
9:16 / áreas seguras sociais, convertendo uma peça 16:9	references/craft/vertical-and-safe-areas.md
Funções da paleta, contraste, gradientes, valores de cor	references/craft/colour.md
Sistema de movimento de uma marca: família de easing, durações, movimento característico, pacotes de marca	references/craft/brand-systems.md
Ponto focal, ordem de leitura, grades, hierarquia, áreas seguras	references/craft/composition-and-layout.md
Lendo um briefing: fatos, orçamento de quadros, estilo, receita	references/craft/reading-a-brief.md
Qual pacote de estilo para um briefing	references/craft/style-families.md
Contagens de quadros medidas por estilo; a lista de revisão do estilo	references/craft/timing-by-style.md, references/craft/review-by-style.md
Por que um movimento funciona: os 12 princípios e além, fundamentos de design, técnicas, gêneros, temporização, fluxo de trabalho, acessibilidade, história (cada página termina com como fazer no Carvercat)	../wiki/README.md, índice da máquina ../wiki/index.json

Regras que valem em todos os lugares:

• Um herói por cena.
• Itens de suporte entram com expo-out ou desaceleração.
• Saídas aceleram e levam cerca de 70% do tempo de entrada.
• Vizinhos escalonados por 3–6 q.
• Cada cena tem uma entrada, algum movimento no meio e uma saída (nunca uma pausa congelada).
• Texto mantido por pelo menos max(25 q, 10 q por palavra) + 10 q. O lint do Carvercat pede 17 caracteres por segundo (espaços não contados), pelo menos 25 quadros totalmente opacos.

2. Construa a partir da biblioteca de padrões primeiro

patterns/README.md contém 25 predefinições e 5 modelos, todos verificados no 0.0.72 com quadros de overshoot e estabilização medidos, além de receitas para push, zoom-through, pilha de cartões e varredura de destaque. O pacote é ../library/templates/motion-patterns/. Verifique se está instalado com library.list {query:"expo"}; se não, instale na pasta Library do usuário (Help > Library Folder ou library.folder, copie para templates/, depois library.reload; precisa do Carvercat 0.1.8+; veja patterns/README.md). Antes do 0.1.8 um aplicativo instalado não pode carregá-lo. Um modelo colocado se torna uma composição aninhada — veja o README de patterns.

• Um objeto: preset.apply {name, id}, por exemplo Rise - expo, Pop - spring, Stamp, Exit up - accelerate.
• Texto: Words rise - expo, Letters cascade - spring, Lines reveal - decelerate, e outros.
• Vários objetos: library.place {name, frame} depois template.apply {id}. Por exemplo Two-tone wipe, Colour iris, Lower third - accent bar, Logo - stamp reveal, Bar chart - grow.
• Uma peça inteira de múltiplos beats em uma composição: patterns/promo-assembly.md.
• Pacotes de estilo (mesma instalação que Motion Patterns): SaaS UI, Kinetic Typography, Data Viz, Corporate Brand, Minimal Luxury, Social Short-form 9:16, Cartoon Bounce, Funky, Futuristic HUD, Retro, Glitch, Sports, Explainer; escolha um com references/craft/style-families.md. Eles precisam do Rethink Sans instalado (texto não pode usar fontes incluídas no app, KI-136). Cada um tem um laboratório e um projeto de demonstração em ../categories/.
• Receitas para briefings comuns (lançamento SaaS, atualização de placar esportivo, reel de dicas 9:16, abertura de relatório anual, resultados trimestrais, teaser de luxo, aula explicativa, reel de citações cinéticas, explicativo infantil, promoção de venda, trailer de tecnologia, noite retrô, teaser musical): listas de tomadas com quadros e projetos de amostra verificados construídos apenas a partir de modelos da Biblioteca, em recipes/README.md.
• Uma curva exata: ease: "cubic-bezier(a, b, c, d)" no keyframe que sai (patterns/custom-curves.md).
• Molas e saltos: scripts/motion/curves.py os incorpora em keyframes.

3. Conduza o aplicativo

Regra permanente (23 Out 2026): construa e altere cenas editando o JSON do .carverproj diretamente, depois edit.open {force:true}. Uma cena inteira também vai pelo MCP em um scene.apply atômico e validado; o arquivo de projeto agora é carvercat/2 (px, y para baixo, quadros; cada salvamento o escreve, arquivos v1 ainda abrem), e a rota JSON abaixo descreve a forma mais antiga v1 (frações, y para cima) que json_author/cc.py escreve e o aplicativo ainda carrega; para um novo gerador escreva carvercat/2 (cc_project.py, como os construtores de receitas fazem). Use MCP para as etapas que o arquivo não pode fazer (medir texto, visualizar, salvar, transferência para Resolve, ajustes ao vivo). Procedimento e alternativas: references/app/json-authoring.md.

references/app/design-units.md é o guia de trabalho: unidades, scene.apply, seletores, anim.set (tweens, easing, escalonamento), efeitos em termos CSS, auxiliares, notas headless. references/app/mcp-essentials.md cobre o ciclo construir -> visualizar -> verificar, os comandos que vale a pena conhecer e as armadilhas que custam horas (clip.move sobrescreve, ids reiniciam por composição). O catálogo legível por máquina é carvercat://schema/design, carvercat://schema/commands e carvercat://schema/scene (o schema/agent/json-schema/ do repositório do app): leia a entrada antes de usar uma chave desconhecida; nunca adivinhe argumentos ou ids de entrada gerados.

Para trabalho scriptado, use os scripts Python mantidos: ai/scripts/cc_client.py + cc_scene.py (references/app/creative-toolkit.md); o aplicativo também tem seu próprio auxiliar Python (carvercat_py). Efeitos, preenchimento/contorno, gradientes, cores, transformações, escalonamento e corte de caminho estão em references/app/creative-controls.md. Planos pendentes podem ser verificados com scene.apply {dry_run: true} e measure.*; nada é armazenado além do documento. Meça texto com forma real; escolha fontes deliberadamente, incluindo execuções numéricas LTR separadas em texto RTL misto. Cada exemplo nos guias é executado por ai/scripts/verify_examples.py contra um Carvercat headless.

3b. Efeitos, desenho, mapas e trabalhos completos

Necessidade	Leia
Desfoque, brilho (com limites de queima), sombra, desfoque de movimento, gradientes, contorno/corte por traço, bordas suaves e máscara com feather, contorno de texto, escalonamento, máscaras	references/effects/README.md
Parâmetros ocultos do porão, promovendo-os, amarras entre parâmetros	references/effects/basement-promote-ropes.md
Todas as formas (retângulo, elipse, estrela, polígono, caminho), organizando e agrupando	references/drawing/shapes.md
Personagens/objetos a partir de partes: âncoras como juntas, parentesco, o objeto nulo (object.new {kind: "null"}) como pivô ou alça	references/drawing/rigging.md
Mapas: fronteiras, estradas, pins, rotas, anéis, pop-ups de pontos de referência, setas, zoom in/out	references/maps/maps.md
Legendas + VO, RTL/Árabe, entrega para Resolve, exportação, o ciclo de trabalho	references/workflows/
Algo se comporta mal	references/known-issues.md

Regras de efeito que valem em todos os lugares: glow força ≤ 0.8 (0.9 corta, 1.0 queima para branco), o raio define o alcance do halo; desfoque e sombra apenas para profundidade no herói; corte por traço para linhas; softEdge de 2 a 6 px para formas de UI, 160 a 320 px para luz ambiente (references/effects/soft-edge.md, com a revelação da máscara com feather).

4. Verifique antes de dizer que está pronto

• Veja a entrada, a pausa e a saída (carvercat_look). Meça com carvercat_inspect (timing, curves para overshoot e estabilização, lint, expect, qc para flashes) e os auxiliares sem render (measure.boxes, measure.overlaps {within: "safe"}, measure.contrast). Pré-voe com carve.preflight {host} antes de um envio.
• Percorra references/craft/review-checklist.md: história, temporização, texto, UI, transições, visual, som, higiene.
• Construa uma composição representativa primeiro, revise-a, depois expanda. Receitas são pontos de partida: adapte a hierarquia, as imagens e a temporização ao briefing e ao material de arquivo. Limites seguros não substituem o julgamento visual.
• Lag ou falta de áudio: references/app/performance.md.

5. Ferramentas que vivem fora do aplicativo (scripts/motion/, Python 3, biblioteca padrão + ffmpeg)

• vo_align.py: voz sobreposta → quadros de palavras e linhas.
• sfx_kit.py / sfx_render.py: Efeitos sonoros sintetizados (pop, whoosh-hit, tick, impacto...) → um WAV por sinal.
• music_bed.py: uma base que se encaixa no corte; mix_check.py: LUFS das faixas e uma mixagem de referência.
• reformat.py: um projeto 16:9 → composições 9:16.
• carverproj.py: auxiliares JSON de projeto (ids, keyframes).
• build_pattern_pack.py / comp_to_template.py: regerar o pacote.
• effects_param_tables.py: regerar a tabela de parâmetros de efeito.
• ../maps/geo_paths.py / ../maps/map_overlay.py: geografia real → caminhos; sobreposição explicativa (pins, anéis, rotas, cartões, setas).

6. Segurança e entrega

Use ids de cena (e namespaces Scene.component) para que uma revisão atualize os mesmos objetos: aplique o mesmo documento novamente e apenas as diferenças mudam. Após uma recusa, pare o trabalho que depende dela. Após um resultado desconhecido, inspecione a identidade e o estado antes de qualquer alteração adicional; nunca repita uma escrita ou exportação cujo resultado você não conheça. Operações no Resolve precisam da autorização atual do usuário; sem ela, crie e teste apenas nativamente. Quando autorizado, verifique o projeto real, a linha do tempo e o formato, preserve a edição original e inspecione amostras compostas. A unidade de trabalho do Carvercat é uma composição; uma linha do tempo do Resolve é separada. Para inspeção de transferência, consolidação, realocação e religamento, leia references/app/media-recovery.md; onde a cobertura de referência de limpeza estiver incompleta, mantenha os arquivos.

Créditos e licenças para as ideias por trás das referências de ofício: SOURCES.md.