motion-review: la puerta del gusto
Los linters detectan código roto. Este skill detecta el gusto. Postura por defecto: señalar primero; la aprobación se gana. Una pieza que "se ve bien" obtiene un 3, y un 3 no se entrega.
Cómo ejecutarlo
- Ejecútalo como un subagente nuevo cuando puedas. Dale: este archivo, la carpeta del proyecto y el brief. No le digas lo difícil que fue la construcción.
- El revisor nunca edita la composición. Escribe
review.mden la carpeta del proyecto y devuelve el veredicto. - Mira los píxeles, no solo el código. Cada puntuación debe apuntar a una marca de tiempo, fotograma o selector.
- Un revisor por pieza. Dos revisores ejecutándose a la vez escriben el mismo
review.mdy sus veredictos entran en conflicto. Cada ronda termina con una líneaverdict:; el llamador consultareview.mdpara obtenerla. Las revisiones repetidas van al mismo revisor; reemplázalo solo sireview.mdno muestra una nueva ronda tras una larga espera, anota la cancelación enreview.mdy haz que el reemplazo lea el historial primero. Si las rondas entran en conflicto, la última escritura enreview.mdes la autorizada.
Procedimiento
Ejecuta cada paso. Los comandos asumen un proyecto HyperFrames (npx hyperframes …); para otros stacks usa el equivalente (Remotion: npx remotion still para fotogramas, npx remotion render para la tira).
-
Estructura.
npx hyperframes check .Cualquier error es un Bloque. Lee también las advertencias. Su auditoría de contraste es la puerta de contraste. El texto decorativo que nunca se pretende leer (fantasmas borrosos, clones de estela fantasma, chips que se disuelven, relleno de mezcla) se excluye condata-layout-ignoreen cada nodo; nunca lo uses para ocultar copia real. -
Mapa de movimiento. Lee el código de la línea de tiempo (o el mapa de animación, si tus habilidades de HyperFrames incluyen
animation-map.mjs). Anota:- zonas muertas de 1 s o más sin nada en movimiento;
- movimientos espaciales de menos de 0,2 s (demasiado rápidos para leer) o más de 2 s (a la deriva);
- escalonamientos irregulares o mecánicos;
- elementos que salgan del encuadre o choquen accidentalmente.
El movimiento impulsado a través de un objeto proxy/setter (cámara personalizada, three.js, contadores) es invisible para los mapas basados en tweens; usa tiras de fotogramas (paso 5) para esos movimientos.
-
Hoja de contactos. A partir del storyboard o la lista de beats, toma los tiempos de las escenas y las costuras. Captura:
- fotograma 0, el momento héroe y el fotograma final;
- 25 / 50 / 75 % de cada escena;
- cada costura a −2 fotogramas, 0 y +2 fotogramas.
npx hyperframes snapshot --at <t1,t2,…>. Pasa tiempos de fotograma exactos (t = fotograma / fps, p. ej. fotograma 316 a 30 fps →10.5333);--atno ajusta, por lo que un tiempo redondeado muestra una pose intermedia que el render nunca contiene.snapshotdeja PNGs obsoletos de ejecuciones anteriores, así que mueve el directoriosnapshots/anterior antes de cada ejecución (p. ej.node -e "require('fs').renameSync('snapshots','snapshots-'+Date.now())") en lugar de borrarlo con un globrm;--attambién puede añadir un fotograma extra que no pediste, ignora los extras. Abre las imágenes y mira. Haz zoom solo en el texto cuando el elemento sea visible (hacer zoom en un elemento oculto puede colgarse). -
Prueba de profundidad. Para movimientos de cámara o héroe,
npx hyperframes keyframes --ghost --angle. Los planos que se separan a lo largo de z significan profundidad real; todo escalándose junto significa profundidad falsa. El espaciado uniforme de fantasmas en un movimiento héroe significa easing lineal, que falla. Si--ghostno puede ejecutarse, toma una copia de prueba y dale al padre del mundo una cámara de prueba (empujar hacia atrás + inclinación + guiñada, p. ej.translateZ(-900px) rotateX(-28deg) rotateY(64deg); solo guiñada pone la cámara dentro de escenas profundas), captura 4–6 tiempos de fotograma a lo largo del movimiento y superponlos (ffmpeg … -filter_complex blend=all_mode=lighten). Construye esta cebolla a mano para perspectiva anidada (snapshot --angle sidela aplana) y para cámaras de proyección JS (3D proyectado en un SVG/lienzo): intercambia una cámara lateral en la función de proyección en la copia de prueba. -
Visualización a velocidad real. Si existe un render:
- crea una tira:
ffmpeg -i renders/video.mp4 -vf fps=6,scale=360:-1,tile=6x4 strip.jpg; - comprueba la duración y el primer y último fotograma con
ffprobe; - si hay audio, comprueba cada golpe contra la hoja de pauta (±1 fotograma) y el pico verdadero ≤ −1 dBTP en el archivo AAC final (
ffmpeg -i … -af ebur128=peak=true -f null -); - superposiciones
.webmtransparentes:ffprobemuestra VP9-alfa comoyuv420p; verifica alfa decodificando con-c:v libvpx-vp9antes de-i(la lectura de flujo muestrayuva420p) o la etiquetaALPHA_MODE=1.
- crea una tira:
-
Lectura de código. Busca en la composición:
ease:(lista cada ease utilizado) y duraciones;- entradas solo por opacidad y pequeños desplazamientos
y:(20–40 px); Math.random/Date.now(no determinista);back.out|elastic|bounce,yoyo,repeat: -1;- lineal o
power1en movimientos espaciales; eases fuera de la lista permitida (mg.*,power3.out,expo.out,power3.in,power4.out,power2.inOut,none, un muelle horneado); - tweens concurrentes que comparten un ease (solo está bien si son un grupo bloqueado: un tween multiobjetivo o una línea de tiempo hija con
defaults; un proxy controlado por setter cuenta una vez, por el ease de su tween); - una subida de máscara de línea borrosa que comience por debajo de
yPercent 130(el desenfoque se filtra en la máscara); - fuentes prohibidas;
- falta de grano, viñeta o desenfoque de movimiento.
-
Puntúa las 9 dimensiones (anclas abajo), 1–5, cada una con una razón de una línea vinculada a un tiempo o fotograma.
-
Listón de artesanía (12 elementos, pasa/falla; tabla abajo).
-
Escaneo anti-sopor (lista de 15 abajo). Registra los ids.
-
Licencias. Cada activo no original (fuente, SFX, música, imagen, código de terceros) tiene una fuente y una licencia compatible por escrito. Fuentes: OFL o similar. Código: MIT o Apache con encabezados conservados. Algo desconocido: márcalo.
Anclas de rúbrica (puntuación 1–5)
| Dimensión | 1 | 3 | 5 |
|---|---|---|---|
| Concepto | Sin idea; texto sobre fondos; cualquier marca podría intercambiarse | Idea clara en una línea; el movimiento la respalda en algunas escenas | Una idea fuerte de principio a fin con un momento sorprendente y propio que puedas describir en una oración |
| Composición | Todo centrado, tamaños uniformes, desorden o vacío sin intención | Cuadrícula, un héroe por fotograma, espacio negativo decente | Cada imagen fija es de póster: recortes deliberados, capas de profundidad, espacio negativo; los diseños evolucionan |
| Tipografía | Fuente del sistema o genérica, tracking por defecto, bloques enteros que se desvanecen | División correcta (línea/palabra/carácter), revelaciones con máscara, legible | El tipo es la animación: ejes variables, diseño cinético, juego de recorte/escala, ritmo impecable |
| Timing y easing | Eases lineales o por defecto, duraciones uniformes, sin pausas | Eases personalizados en movimientos héroe, duraciones variadas, pausas legibles | Velocidad asimétrica, sobrepaso elegante, pausas que se sienten inevitables fotograma a fotograma |
| Coreografía | Todo se mueve junto o con un escalonamiento uniforme | El héroe lidera, los soportes siguen con desplazamientos, superposición presente | Dirigida: un gesto fluye hacia el siguiente, el movimiento secundario reacciona al primario |
| Transiciones | Crossfades o cortes sin relación | Máscaras/wipe diseñados, al ritmo | Una cámara/idea continua; memorable, nunca gratuita |
| Profundidad y textura | Vectores planos sobre un gradiente plano o de mancha, fotograma estático | Deriva/empuje de cámara, 2+ planos de profundidad, algo de grano o luz | 3D real o 2.5D convincente, la iluminación cuenta la historia, la textura unifica sin presumir |
| Sincronía de sonido | Silencio o audio no relacionado | Los cortes principales caen en los beats | Imagen y sonido compuestos juntos; el silencio usado como acento; mezcla limpia |
| Acabado | Errores, tirones, chasquidos, aliasing, activos no cargados | Limpio, coherente, fotograma final diseñado | Entregable de estudio; cada fotograma escrutado; fotograma final sostenido y resuelto |
Las puntuaciones 2 y 4 se sitúan entre los anclajes. Para puntuar 4:
- Timing: paleta de eases por rol, llegadas "rápido fuera, largo asentamiento", aceleración en salidas.
- Coreografía: anticipación, seguimiento y escalonamientos suavizados o basados en distancia.
- Transiciones: al menos un corte de coincidencia o morph, y cortes a velocidad máxima con desenfoque.
- Profundidad: paralaje de 3 planos y desenfoque de movimiento en movimientos rápidos.
- Composición: al menos 5× contraste de escala.
Una pieza silenciosa sin SFX que se declare silenciosa en el brief puntúa Sincronía de sonido basándose en sus silencios y ritmo visual; no castigues una elección deliberada.
Puertas duras (cualquiera = Bloque)
checkfalla, el render no es determinista, o una búsqueda muestra un fallo.- Texto que no se puede leer:
- duración de pausa inferior a 0,5 s + 0,3 s por palabra;
- contraste inferior a 4.5:1;
- texto que cruza el área segura.
- Destello de fuente, activo faltante, fotograma roto o vacío en una costura, o un salto en el primer o último fotograma.
- 3 o más golpes anti-sopor sin una justificación por escrito.
- Ease lineal o por defecto en un movimiento espacial héroe.
- Un elemento del listón de artesanía faltante sin una exención por escrito en el brief.
- Más de 3 destellos por segundo.
- Un activo de terceros sin fuente o licencia registrada.
Listón de artesanía (12 elementos)
- Concepto. Una idea en una frase, y un momento característico alrededor del 40 % de la duración.
- Fotograma héroe. Un fotograma héroe diseñado (Composición ≥ 4, al menos 3 capas de profundidad).
- Cámara. Al menos un movimiento de cámara real o de profundidad, demostrado por la verificación fantasma o de ángulo lateral.
- Eases personalizados. Al menos 3 caracteres de ease distintos, y ningún tween concurrente compartiendo uno accidentalmente.
- Sin desvanecimiento por defecto. Sin
opacity 0→1+y 20–40→0en ninguna parte. - Costuras nombradas. Las costuras están nombradas y emparejadas por velocidad; como máximo un crossfade simple.
- Desenfoque de movimiento en 1–3 beats rápidos (nunca en texto mientras se lee).
- Pase de textura. Grano, viñeta y gradientes radiales (motivados por luz).
- Evento de luz. Al menos uno: un barrido, brillo, banda de escaneo, florecimiento o fuga.
- Sonido. Sincronía de sonido si hay audio; si no, la pieza se declara silenciosa.
- Ritmo.
- El beat de storyboard más lento es al menos 3× el más rápido (los beats son filas de storyboard, no sub-tweens).
- En todos los tweens, la duración máxima/mínima es al menos 4.
- El fotograma fijo final dura al menos 0,8 s.
- El último fotograma funciona como miniatura.
- Listón de rúbrica cumplido (ver Barra de envío).
Anti-sopor top 15
| id | Señal | Solución |
|---|---|---|
| S1 | Cada elemento aparece y se desliza hacia arriba 20–40 px | Entrada por rol: máscaras/divisiones para texto, escala desde punto para formas, cámara para escenas |
| S2 | Duraciones idénticas (todo 0,5 s / 1 s) | Duración desde distancia y masa; llegadas héroe 0,8–1,5 s, salidas ~30 % más rápidas |
| S3 | Ease por defecto (power1, CSS ease, ease-in-out) o lineal en movimientos espaciales | Eases personalizados nombrados; asimétrico "rápido fuera, largo asentamiento" |
| S4 | Escalonamiento uniforme de 0,1 s | Escalonamiento suavizado desde un origen significativo (centro, punto focal, orden de lectura) |
| S5 | Todo se mueve a la vez, misma velocidad | Un líder; soportes siguen 2–8 fotogramas después con menos amplitud |
| S6 | Sin pausas: entra, sale directo | Pausa de lectura ≥ 0,5 s + 0,3 s/palabra |
| S7 | Paradas muertas: llega y se congela | Asentamiento largo, microderiva durante la pausa |
| S8 | Elastic/back/bounce en todo | Como máximo un sobrepaso por pieza, ≤ 6 %, solo en transformaciones |
| S9 | Pulsos "respirantes" inactivos (escala/opacidad yoyo) | Quietud, o un ambiente motivado, o una deriva de cámara con una pose final |
| S10 | Movimientos rápidos sin desenfoque de movimiento | Desenfoque direccional o de obturador en los 1–3 beats más rápidos |
| S11 | Pila centrada: título / subtítulo / botón | Cuadrícula asimétrica, tipo anclado al borde, 30–50 % de espacio negativo |
| S12 | Fotograma estático, sin cámara | Empuje, deriva, planos de paralaje, acercamientos en los beats |
| S13 | "Diapositivas": escena se desvanece, siguiente aparece | Costuras motivadas: corte de coincidencia, impulso, máscara, morph |
| S14 | Manchas púrpura-azul / rosa-naranja, glassmorphism, neón en todo | Gradientes que se comportan como luz de una fuente; 2–3 tonos + neutros, acento ≤ 10 % |
| S15 | Inter/Roboto/Poppins regular como "el diseño"; emojis o iconos de stock | Tipo expresivo, tracking ajustado, contraste de peso; marcas personalizadas o ninguna |
También vigila:
- máquina de escribir + cursor como toda la idea;
- números de conteo genéricos;
- copia tipo lorem ("desbloquea el futuro de…");
- un final que simplemente se detiene o se desvanece;
- una curva de energía plana sin clímax;
- movimiento que encajaría con cualquier mensaje.
Barra de envío
- APROBAR: media ≥ 4.0, ninguna dimensión por debajo de 3, cero puertas duras.
- PULIR: media 3.5–3.9, o una dimensión en 3. Lista de correcciones, luego re-revisión.
- RETRABAJAR: media inferior a 3.5. Vuelve al concepto y los styleframes; pulir no lo salvará.
Formato de review.md
piece: <nombre> · reviewed: <fecha> · render: <ruta o ninguno>
concept: N — … composition: N — … typography: N — …
timing_easing: N — … choreography: N — … transitions: N — …
depth_texture: N — … sound_sync: N — … finish: N — …
average: N.N
hard_gates: [ … ]
craft_bar: [1 ✓, 2 ✗ (razón), …]
anti_slop_hits: [S1, S7, …]
verdict: APROBAR | PULIR | RETRABAJAR → route fixes to: concept | composition | motion build
contact_sheet: <ruta>
Luego una tabla Antes | Después | Por qué. Ordénala por apalancamiento (impacto ÷ esfuerzo), y haz que cada "Después" sea un valor exacto:
| # | Dónde (t / fotograma / selector) | Antes | Después | Por qué |
|---|---|---|---|---|
| 1 | 3.40–3.90 s #title | opacidad + y 30, power2.out 0.5 s | dividir en líneas, revelación con máscara, ease de asentamiento cubic-bezier(0,.65,.51,.99) 0.9 s, líneas +4 fotogramas | desvanecimiento por defecto (S1); sin asentamiento (S7) |
Orden de corrección: eliminar → reducir → arreglar easing → arreglar composición/origen → reajustar tiempo → añadir profundidad/desenfoque/textura → pulir. Nunca escribas "hacerlo más dinámico"; da siempre una receta con números.
Re-revisión
Las re-revisiones vuelven al mismo revisor. Después de las correcciones, vuelve a ejecutar el paso 1, el paso 3 (regiones cambiadas y sus costuras) y el paso 7. Cualquier reajuste de tiempo vuelve a ejecutar check: sus muestras de contraste se mueven con el tiempo. Conserva las puntuaciones antiguas en review.md para que la mejora sea visible, y termina cada ronda con su propia línea verdict:. Detente después de 3 rondas de pulido; si la media sigue por debajo de 4.0, devuelve RETRABAJAR.
Parte de las habilidades gratuitas de mograf (MIT). Para el pipeline completo del estudio, consulta mograf.si. Cada pieza de la biblioteca incluye su prompt, habilidades, fuente y copia.