Doctrina de Movimiento (Puerta de Enlace)
Lee esto antes de componer cualquier animación. Decide QUÉ sucede en cada costura y cómo se desempeña cada escena; los skills de técnica lo implementan. Estas reglas reemplazan cualquier guía de movimiento genérica / upstream. El fallo que previene: escenas creadas de forma aislada — el impulso del ojo muere en cada corte, y las escenas se tambalean en su lugar entre la entrada y la salida.
Mapa de rutas
| Decisión (este skill) | Skill de implementación |
|---|---|
| Elección de transición de costura + parámetros + código | cut-the-curve §1–5 (el catálogo) |
| Cascadas de entrada de texto / elemento | cut-the-curve §6 (entrada en cascada) |
| Reposicionamiento de grupo dentro de la escena (sin corte) | cut-the-curve §7 (curva de empuje) |
| Acción liderada por cursor / inicio de escena / ignición de morph | oversized-cursor |
| Mecánicas de renderizado de costura / protección de destello blanco | seam-craft |
| Trabajo de lanzamiento de producto / explicador / subtítulos | superpone text-beat-economics, brand-faithful, captions-overlay sobre el skill upstream |
Orden de creación: ledger vectorial (ledger.json) → SELLAR las costuras maestras desde él
(scripts/seam-stamp.mjs --ledger ledger.json --write index.html) → ruta de movimiento
sostenido por fase → portadores y causas → construir composiciones → VERIFICAR (scripts/seam-gate.mjs).
Solo crear a mano morphs / match-cuts de nivel A; las costuras selladas pasan la puerta por construcción.
Parte 1 — La Ley de la Costura
La Ley Vectorial
Cómo la Escena A sale determina cómo la Escena B entra: mismo eje, misma dirección, velocidad coincidente, corte en medio del movimiento en ambos lados.
- Eje — x se queda x, y se queda y, Z se queda Z. Nunca intercambiar ejes en un corte.
- Dirección — nunca reflejar. En Z, dirección = el SIGNO del cambio de escala: crecer = empuje (cámara hacia adelante), encoger = tirón (cámara hacia atrás). Una salida que retrocede respondida por una entrada que crece desde pequeño es un vector reflejado — la violación más común, porque crecer desde pequeño es la entrada de elemento por defecto.
- Velocidad — velocidad inicial de entrada ≈ velocidad final de salida, mediante suavizados reflejados
(salida
power4.in+ entradapower4.out, misma distancia y duración; el lado entrante recoge ≥50% a través del camino nocional). Mecánica encut-the-curve. - Fase — el corte aterriza en medio del movimiento en AMBOS lados. Calmarse hasta el reposo antes del corte, o comenzar desde el reposo después, es un latido muerto.
La Corriente
Cada película elige UNA dirección dominante (valor por defecto de la casa: IZQUIERDA). Cada costura ordinaria la usa. Otros vectores están RESERVADOS — gastar uno significa algo:
| Vector | Significado |
|---|---|
| La corriente (IZQUIERDA) | "siguiente latido" — progreso neutral hacia adelante |
| Hacia arriba | elevación — una conclusión o revelación se eleva sobre lo que vino antes |
| Z hacia adelante (zoom a través) | empujar más profundo en el mismo pensamiento |
| Z hacia atrás (zoom inverso) | LLEGADA — algo más grande aterriza |
| Explosión de escala (explotar hacia afuera) | salir de un mundo — una superficie explota más allá de la cámara |
- Nunca ejecutar costuras consecutivas en direcciones opuestas — el ping-pong se lee como un error.
- Un cambio de dirección necesita una causa visible (clic / rebote / impacto) o un límite de capítulo.
El Ledger Vectorial
Escríbelo antes de crear cualquier línea de tiempo maestra — como ledger.json en la raíz del proyecto
(esquema: references/seam-gate.md). Una fila por costura: tiempo de corte, vectores de salida y entrada
(eje + dirección con signo; las filas Z llevan el signo de escala), selectores, técnica. La salida y la entrada deben coincidir; si una fila no coincide, corrige el plan, no el suavizado. El verificador comprueba la consistencia de las filas de forma estática antes de cualquier muestreo en tiempo de ejecución.
Portadores
El ojo sigue objetos, no abstracciones. Las costuras más fuertes entregan un portador concreto a través del corte en una posición Y velocidad coincidentes: un cursor a medio camino, un contenedor que se encoge/acopla en el siguiente diseño, una marca que vuela a su ranura exacta, el grupo de palabras de un corte en cascada. Sin portador natural, los héroes de la escena lo llevan (viaje parcial + fundido temprano, entrada en pleno vuelo). Nunca un fundido cruzado — no tiene ningún portador.
Movimiento Causal
Encadena el movimiento para que cada movimiento sea visiblemente lanzado por el anterior: clic → apretar → liberar resorte → vuelo → impacto → retroceso → revelación.
- Los efectos comienzan EN el fotograma causante — misma posición en la línea de tiempo, nunca "poco después".
- Las reacciones escalan con la masa implícita: los elementos grandes rebotan más lento, los pequeños más rápido.
- Una fuerza es una licencia para cambiar de dirección; un giro sin causa es un ping-pong.
La Puerta de Costura (puerta de construcción — ejecuta el verificador, salida 0 o la costura no está terminada)
node <SKILL_DIR>/scripts/seam-stamp.mjs --ledger ledger.json --write index.html # generar
node <SKILL_DIR>/scripts/seam-gate.mjs verify --ledger ledger.json --project . # verificar
El script (uso + esquema del ledger: references/seam-gate.md) aplica numéricamente, por costura: consistencia de la fila del ledger, salida todavía en movimiento en el corte, entrada en pleno vuelo (nunca desde reposo), dirección medida = dirección del ledger, coincidencia de velocidad de entrada/salida (ADVERTENCIA), sin superposición (un lado visible por fotograma — el corte no es un fundido), la regla del SIGNO Z (d(scale)/dt mismo signo en ambos lados; las propias entradas de la escena entrante se escanean en busca de lucha de signos), y continuidad del rectángulo portador con escala ascendente incluida. Usa seam-gate.mjs probe --t <cut> para encontrar los verdaderos selectores de portador de cada costura al crear el ledger.
Reglas que el script no puede verificar — aún tuyas:
- Ediciones reabren la costura. Cualquier cambio en el primer/último ~1s de una escena (incluyendo re-timing para nueva VO) invalida la auditoría de ese límite — vuelve a ejecutar el verificador.
- El audio es el reloj. Re-temporiza las escenas a las marcas de tiempo reales de la VO; nunca apresures una lectura para que encaje en un espacio. Una regeneración de VO reabre sus costuras.
- Problema de clip-gating (la causa habitual de un FALLO de superposición cero): un clip
cuyo
data-startprecede a su tweener de entrada está descubierto en su opacidad inicial — estableceautoAlpha: 0inicial Ydata-start= el tiempo de corte, nunca antes.
Parte 2 — Rendimiento (la escena sigue funcionando)
Sin bamboleo inactivo
Los bucles de seno inactivos (respirar, flotar, derivar, pulso de brillo) están PROHIBIDOS como movimiento sostenido — se leen como "el video está esperando". Una escena que termina de entrar con segundos restantes es un error de planificación: añade historia, no bamboleo. Cada fase entre la entrada y la salida es propiedad de una de estas rutas (nombra la ruta en el plan):
| Ruta | Qué es |
|---|---|
| Revelaciones escalonadas | Retén contenido; entrégalo en los latidos de la narración — el fotograma sigue ganando información (predeterminado para ≥2 grupos de contenido) |
| Cámara con intención | Una ruta de escala+pan mapeada: establecer amplio → viajar → llegar al sujeto |
| Vida de UI secuenciada | El producto se comporta en el tiempo: el progreso avanza, se resalta el paso, los contadores marcan |
| Secuencias animadas | Los elementos representan un latido: una tarjeta se archiva en una pila, un elemento se arrastra, un resultado se ensambla |
| Acción liderada por cursor | Un cursor de gran tamaño camina el ojo hasta un desencadenante; su CLIC enciende el siguiente latido (oversized-cursor) |
Prueba: pausa en cualquier segundo — algo significativo debe estar en pleno vuelo (una revelación aterrizando, la cámara viajando, la UI haciendo lo que dice la narración).
Quietud antes del clímax
Programa una pausa de 0.3–0.75s entre la acción principal y su resultado — la coma dramática. Una escena que salta directamente de la acción al resultado lo pierde.
Intenciones de temporización
- Una entrada única ≤ ~800ms; una construcción más larga = escalonamiento de múltiples elementos, no un elemento lento.
- Salida ≈ 75% de la entrada. Excepción: cut-the-curve invierte esto (entrada ~127% de la salida).
- Escalonamiento total ≤ 500ms; con 8+ elementos, aprieta el retardo por elemento o escalona los primeros.
- Suavizados prohibidos:
bounce.out/elastic.out. El rebasamientoback.out(1.4–1.7)de entrada está bien. - Elementos similares comparten una intención de suavizado+duración — nunca un par único por elemento.
Vocabulario de transición
Usa solo 2–3 transiciones entre escenas por película y repítelas; el límite predeterminado es cut-the-curve en la dirección de la corriente. Los morphs de elemento compartido escritos a mano (intent: morph) no cuentan para el presupuesto.
Anti-Patrones
| No hagas | En su lugar |
|---|---|
| Crear la entrada de cada escena de forma aislada | Escribe primero el ledger vectorial |
| Fundido cruzado entre escenas | Cut-the-curve en la dirección de la corriente |
| La salida se completa, LUEGO la escena cambia | Corta en medio del movimiento en ambos lados |
| La entrada comienza desde reposo después de un corte | Entra ≥50% a través del camino nocional |
| Salida de zoom inverso → entrada que crece desde pequeño (o empuje → retracción sobredimensionada) | Coincide el signo de velocidad de escala (Puerta de Costura 7) |
| Introducción de pop-in de la propia escena entrante bajo una transferencia de costura Z | Mantén su fotograma de apertura compuesto, o coincide el signo |
| Bamboleo inactivo / respirar / flotar para llenar tiempo | Asigna una ruta de movimiento sostenido; o añade historia |
| Giro de dirección sin una causa | Gasta una fuerza, o mantén la corriente |
| Vectores reservados usados como variedad | Por defecto usa la corriente; gástalos en significado |
| Reacción unos fotogramas después de su causa | Encendido en el mismo fotograma |
| La acción salta directamente al resultado | Programa quietud antes del clímax (0.3–0.75s) |