carvercat/carvercat-motion

Gráficos animados Carvercat

¿No encuentras algo? references/INDEX.md responde "dónde está X" para toda la habilidad (diseño, aplicación, efectos, dibujo, mapas, flujos de trabajo, problemas conocidos).

Funciona con cualquier agente que pueda llamar a las herramientas MCP de Carvercat: Claude, GPT/Codex, Gemini, o una persona leyendo junto. Nada aquí depende de un solo proveedor. Los nombres de las herramientas pueden llevar un prefijo del cliente (por ejemplo mcp__carvercat__carvercat_run).

0. Unidades y la nueva superficie (lee esto primero)

Todo lo que escribes está en unidades de diseño: px desde la esquina superior izquierda del fotograma con y hacia abajo, grados en sentido horario, colores CSS y easing, fontSize px, tiempos como fotogramas, "1.5s" o "500ms". Construye una escena completa en una llamada validada (scene.apply, primera prueba en seco), selecciona objetos con selectores tipo CSS, usa los ayudantes (layout.*, text.fit, motion.apply, measure.*) y ejecuta carve.preflight {host} antes de cualquier envío. Guía: references/app/design-units.md. Los nombres antiguos aún funcionan durante una versión y se listan allí una vez; no los escribas.

0b. Antes de tocar nada

• Localiza la aplicación Carvercat instalada en esta máquina y usa la carpeta de esta habilidad como instalada; para trabajos creativos esta habilidad es suficiente. No uses una ruta histórica fija.
• carvercat_session (adjuntar) luego carvercat_state: verifica la compilación, el proyecto abierto y la composición antes de cambiar algo. carvercat_list da los ids.
• Pide a la persona que no haga clic en la aplicación mientras construyes: el cambio de su composición redirige tus próximos comandos.
• Nunca borres el documento de un usuario para reconstruir. Guarda el .carverproj editable en el destino del trabajo.

1. Planifica como un diseñador de motion (diseño)

Lee solo lo que el trabajo necesita:

Necesidad	Lee
Duraciones, easing, los 12 principios, coreografía, sincronización con música, anti-patrones	references/craft/motion-principles.md; una página por principio en references/craft/principles/
Escala tipográfica, tiempo de lectura, estilos de entrada, énfasis; tracking medido, interlineado y umbrales de lint	references/craft/typography.md
Qué transición, cuánto dura, el traspaso en el corte	references/craft/transitions.md
SFX y música: un clip por evento, niveles, especificaciones pop/whoosh	references/craft/sound-design.md
9:16 / áreas seguras sociales, convertir una pieza 16:9	references/craft/vertical-and-safe-areas.md
Roles de paleta, contraste, degradados, valores de color	references/craft/colour.md
Sistema de movimiento de una marca: familia de easing, duraciones, movimiento característico, paquetes de marca	references/craft/brand-systems.md
Punto focal, orden de lectura, cuadrículas, jerarquía, áreas seguras	references/craft/composition-and-layout.md
Leer un briefing: hechos, presupuesto de fotogramas, estilo, receta	references/craft/reading-a-brief.md
Qué paquete de estilo para un briefing	references/craft/style-families.md
Recuentos de fotogramas medidos por estilo; lista de revisión del estilo	references/craft/timing-by-style.md, references/craft/review-by-style.md
Por qué funciona un movimiento: los 12 principios y más allá, fundamentos de diseño, técnicas, géneros, timing, flujo de trabajo, accesibilidad, historia (cada página termina con cómo hacerlo en Carvercat)	../wiki/README.md, índice de máquina ../wiki/index.json

Reglas que aplican en todas partes:

• Un héroe por escena.
• Los elementos secundarios entran con expo-out o decelerando.
• Las salidas aceleran y toman aproximadamente el 70% del tiempo de entrada.
• Escalonar vecinos por 3–6 f.
• Cada escena tiene una entrada, algo de movimiento en el medio y una salida (nunca una pausa congelada).
• El texto se mantiene al menos max(25 f, 10 f por palabra) + 10 f. El lint de Carvercat pide 17 caracteres por segundo (espacios no contados), al menos 25 fotogramas completamente opacos.

2. Construye desde la biblioteca de patrones primero

patterns/README.md contiene 25 ajustes preestablecidos y 5 plantillas, todos verificados en 0.0.72 con fotogramas de overshoot y estabilización medidos, más recetas para push, zoom-through, pila de tarjetas y barrido de resaltado. El paquete es ../library/templates/motion-patterns/. Verifica que esté instalado con library.list {query:"expo"}; si no, instálalo en la carpeta de Biblioteca del usuario (Help > Library Folder o library.folder, copia en templates/, luego library.reload; necesita Carvercat 0.1.8+; ver patterns/README.md). Antes de 0.1.8 una aplicación instalada no puede cargarlo. Una plantilla colocada se convierte en una composición anidada — ver el README de patrones.

• Un objeto: preset.apply {name, id}, por ejemplo Rise - expo, Pop - spring, Stamp, Exit up - accelerate.
• Texto: Words rise - expo, Letters cascade - spring, Lines reveal - decelerate, y otros.
• Varios objetos: library.place {name, frame} luego template.apply {id}. Por ejemplo Two-tone wipe, Colour iris, Lower third - accent bar, Logo - stamp reveal, Bar chart - grow.
• Una pieza completa de varios compases en una composición: patterns/promo-assembly.md.
• Paquetes de estilo (misma instalación 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; elige uno con references/craft/style-families.md. Necesitan Rethink Sans instalada (el texto no puede usar las fuentes incluidas en la aplicación, KI-136). Cada uno tiene un laboratorio y un proyecto de muestra en ../categories/.
• Recetas para briefings comunes (lanzamiento SaaS, actualización de puntuación deportiva, reel de consejos 9:16, apertura de informe anual, resultados trimestrales, teaser de lujo, lección explicativa, reel de citas cinéticas, explicación para niños, promo de venta, tráiler tecnológico, noche retro, teaser musical): listas de tomas con fotogramas y proyectos de muestra verificados construidos solo con las plantillas de la Biblioteca, en recipes/README.md.
• Una curva exacta: ease: "cubic-bezier(a, b, c, d)" en el keyframe que sale (patterns/custom-curves.md).
• Springs y bounces: scripts/motion/curves.py los hornea en keyframes.

3. Conduce la aplicación

Regla vigente (23 Oct 2026): construye y cambia escenas editando el JSON del .carverproj directamente, luego edit.open {force:true}. Una escena completa también va por MCP en un scene.apply atómico validado; el archivo de proyecto ahora es carvercat/2 (px, y abajo, fotogramas; cada guardado lo escribe, los archivos v1 aún se abren), y la ruta JSON a continuación describe la forma más antigua v1 (fracciones, y arriba) que json_author/cc.py escribe y la aplicación aún carga; para un nuevo generador escribe carvercat/2 (cc_project.py, como hacen los constructores de recetas). Usa MCP para los pasos que el archivo no puede hacer (medir texto, mirar, guardar, transferencia a Resolve, ajustes en vivo). Procedimiento y alternativas: references/app/json-authoring.md.

references/app/design-units.md es la guía de trabajo: unidades, scene.apply, selectores, anim.set (tweens, easing, escalonamiento), efectos en términos CSS, ayudantes, notas sin interfaz. references/app/mcp-essentials.md cubre el bucle construir -> mirar -> verificar, los comandos que valen la pena y los peligros que cuestan horas (clip.move sobrescribe, los ids se reinician por composición). El catálogo legible por máquina es carvercat://schema/design, carvercat://schema/commands y carvercat://schema/scene (el repositorio de la aplicación schema/agent/json-schema/): lee la entrada antes de usar una clave desconocida; nunca adivines argumentos o ids de entrada generados.

Para trabajo con scripts usa los scripts Python mantenidos: ai/scripts/cc_client.py + cc_scene.py (references/app/creative-toolkit.md); la aplicación también tiene su propio ayudante Python (carvercat_py). Los efectos, relleno/contorno, degradados, colores, transformaciones, escalonamiento y recorte de trazado están en references/app/creative-controls.md. Los planes pendientes se pueden verificar con scene.apply {dry_run: true} y measure.*; no se almacena nada junto al documento. Mide el texto con forma real; elige fuentes deliberadamente, incluyendo ejecuciones numéricas LTR separadas en texto RTL mixto. Cada ejemplo en las guías es ejecutado por ai/scripts/verify_examples.py contra un Carvercat sin interfaz.

3b. Efectos, dibujo, mapas y trabajos completos

Necesidad	Lee
Desenfoque, brillo (con límites de quemado), sombra, desenfoque de movimiento, degradados, contorno/recorte de trazado, bordes suaves y pluma de máscara, contorno de texto, escalonamiento, máscaras	references/effects/README.md
Parámetros ocultos del sótano, promocionarlos, conexiones entre parámetros	references/effects/basement-promote-ropes.md
Todas las formas (rectángulo, elipse, estrella, polígono, trazado), organizar y agrupar	references/drawing/shapes.md
Personajes/objetos a partir de partes: anclas como articulaciones, herencia, el objeto nulo (object.new {kind: "null"}) como pivote o manejador	references/drawing/rigging.md
Mapas: bordes, carreteras, pines, rutas, anillos, ventanas emergentes de lugares emblemáticos, flechas, zoom in/out	references/maps/maps.md
Subtítulos + VO, RTL/Árabe, traspaso a Resolve, exportación, el bucle de trabajo	references/workflows/
Algo se comporta mal	references/known-issues.md

Reglas de efectos que aplican en todas partes: glow intensidad ≤ 0.8 (0.9 recorta, 1.0 quema a blanco), el radio establece el alcance del halo; desenfoque y sombra solo para profundidad en el héroe; recorte de trazado para líneas; softEdge de 2 a 6 px para formas de interfaz, de 160 a 320 px para luz ambiental (references/effects/soft-edge.md, con la revelación de máscara difuminada).

4. Verifica antes de decir que está terminado

• Mira la entrada, la pausa y la salida (carvercat_look). Mide con carvercat_inspect (timing, curves para overshoot y settle, lint, expect, qc para destellos) y los ayudantes sin renderizar (measure.boxes, measure.overlaps {within: "safe"}, measure.contrast). Preflight con carve.preflight {host} antes de un envío.
• Recorre references/craft/review-checklist.md: historia, timing, texto, interfaz, transiciones, aspecto, sonido, higiene.
• Construye una composición representativa primero, revísala, luego expande. Las recetas son puntos de partida: adapta la jerarquía, las imágenes y el timing al briefing y al metraje. Los límites seguros no reemplazan el juicio visual.
• Retraso o falta de audio: references/app/performance.md.

5. Herramientas que viven fuera de la aplicación (scripts/motion/, Python 3, biblioteca estándar + ffmpeg)

• vo_align.py: voz en off → fotogramas de palabras y líneas.
• sfx_kit.py / sfx_render.py: SFX sintetizados (pop, whoosh-golpe, tic, impacto...) → un WAV por señal.
• music_bed.py: una base musical que se ajusta al corte; mix_check.py: LUFS de pista y una mezcla de referencia.
• reformat.py: un proyecto 16:9 → composiciones 9:16.
• carverproj.py: ayudantes JSON de proyecto (ids, keys).
• build_pattern_pack.py / comp_to_template.py: regenera el paquete.
• effects_param_tables.py: regenera la tabla de parámetros de efectos.
• ../maps/geo_paths.py / ../maps/map_overlay.py: geografía real → trazados; superposición explicativa (pines, anillos, rutas, tarjetas, flechas).

6. Seguridad y entrega

Usa ids de escena (y espacios de nombres Scene.component) para que una revisión actualice los mismos objetos: aplica el mismo documento de nuevo y solo cambian las diferencias. Después de una negativa, detén el trabajo que depende de ella. Después de un resultado desconocido, inspecciona la identidad y el estado antes de cualquier cambio adicional; nunca reproduzcas una escritura o exportación cuyo resultado no conozcas. Las operaciones de Resolve necesitan la autorización actual del usuario; sin ella, solo autor y prueba de forma nativa. Cuando esté autorizado, verifica el proyecto real, la línea de tiempo y el formato, preserva la edición original e inspecciona muestras compuestas. La unidad de trabajo de Carvercat es una composición; una línea de tiempo de Resolve es separada. Para inspección de transferencia, consolidación, reubicación y reenlace, lee references/app/media-recovery.md; donde la cobertura de referencia de limpieza sea incompleta, conserva los archivos.

Créditos y licencias para las ideas detrás de las referencias de diseño: SOURCES.md.