motion-designer
1. Brief (obligatorio)
En MOTION_BRIEF.md, una sección ## Segment: <id> con los 14 campos: Propósito, Duración, Marca, Escena, Idea visual, Tipografía, Movimiento, Cámara, Fondo, Transiciones, Sonido, Entrada, Salida, Destino de integración. Lenguaje de movimiento: brands/<brand-id>/MOTION_LANGUAGE.md. Verificar: npm run mos -- motion brief <pkg> <id>. Muestra el brief al usuario → npm run mos -- approve <pkg> motion:<id> --quote "…" (--by delegated solo si el usuario delegó explícitamente el motion; cita sus palabras).
2. Plantilla
Las plantillas viven en video/hyperframes/templates/: las compartidas (notification-card, bubble-transition) y las de marca (<brand-id>-*). Los tokens de tokens.json se inlinean, las fuentes y GSAP son locales, los textos pasan por data-composition-variables. Construye una nueva plantilla según el contrato de composición de HyperFrames (si las habilidades hyperframes-core / hyperframes-animation están instaladas, síguelas): una línea de tiempo pausada en window.__timelines["<id>"], determinista, sin CSS transform y GSAP en la misma propiedad, @font-face en el archivo. Prohibido a menos que MOTION_LANGUAGE.md lo solicite: animaciones SaaS genéricas, cuadrículas bento, degradados aleatorios, neón. Nunca copies la interfaz de usuario o marcas registradas de otra empresa.
El texto en pantalla debe estar en el idioma de la marca. Los elementos visuales que no sean del producto real (maquetas, conceptos, UI ilustrativa, comentarios ficticios) deben llevar una etiqueta de honestidad; nunca presentes una maqueta como el producto real.
3. Segmento
npm run mos -- motion new <pkg> <id> --template <template> --duration <sec> --scene <scene-id> --var key=value …
npm run mos -- motion check <pkg> <id> # lint + tiempo de ejecución + diseño + contraste, hasta que tenga 0 errores
npm run mos -- motion render <pkg> <id> # VP9 WebM transparente, verificación de canal alfa, almacenado en caché por hash de entrada
El renderizado es local. No ejecutes media-use, renderizado en la nube, TTS o generación sin permiso explícito.
4. Integración
En video/props.json, una escena {"kind":"motion","src":"content/<pkg>/video/motion/<id>/renders/<id>.webm","segmentId":"<id>","layer":"overlay", …}. Verifica el fotograma en Studio y con npm run mos -- video still <pkg> <frame>: la capa inferior debe mostrarse a través de las áreas transparentes. Sin alfa → recurre a un componente de Remotion (NotificationCard, etc.).