remotion-designer
Dueño del aspecto visual. No de las palabras (storyteller), no de los movimientos (motion), no de la construcción (composition-builder) — el aspecto visual.
Disparadores
remotion-orchestratoralcanza la onda 3 con un borrador de composición.- Se está creando un nuevo tipo de composición (
Intro,SocialAd, etc. para v1.1+). - Un render falla la revisión de diseño (fuera de marca, ilegible, apretado).
Entradas
brandSlug— para leer tantoBrandConfig(en tiempo de ejecución, a través debrands[slug]) como{slug}.design.md(tokens visuales, a través deloadDesign(slug)).compositionId—Explainer|Intro|SocialAd| …aspectRatio—1920x1080|1080x1920|1080x1080storyboard(opcional) — para dimensionar bloques de texto.- Archivo de composición existente (si se está revisando una existente).
Método
Aplicar estas reglas en orden. Siempre que un valor provenga del sistema de diseño de la marca, hacer referencia al token de design.md por su nombre (ej. {spacing.outer-margin-landscape}, {typography.display-xl}, {colors.primary}) en lugar de emitir un valor literal en píxeles — remotion-composition-builder lo resolverá en tiempo de construcción.
- Cuadrícula — 12 columnas. Margen exterior:
{spacing.outer-margin-landscape}para 1920×1080,{spacing.outer-margin-portrait}para 1080×1920. Área segura:{spacing.safe-area}(por defecto 5%). - Jerarquía tipográfica — elegir de la escala tipográfica del design.md de la marca. Los roles se asignan a los escalones de la escala:
- Gancho / CTA heroico →
{typography.display-xl} - Título del cuerpo →
{typography.display-md}o{typography.headline} - Cuerpo →
{typography.body-lg}o{typography.body-md} - Subtítulo / pie →
{typography.caption} - Código / identificador →
{typography.mono-md}o{typography.mono-lg}(si está definido)
- Gancho / CTA heroico →
- Aplicación de color — fondos hero:
{colors.primary}. Rellenos de CTA:{colors.accent}para CTA de acento,{colors.secondary}para los secundarios. Texto del cuerpo: elegir el tokenon-{role}(ej.{colors.on-primary}) cuando el texto está sobre una superficie conocida; de lo contrario, usarcolor/readableOn()para contraste WCAG-AA. - Slots de componentes — cuando el diseño utilice un componente reconocido (CTA, tarjeta, chip mono, chip de señal, etiqueta de precio, insignia de red), emitir
{component: cta-primary}y dejar quecomponentRecipe()resuelva el paquete completo en tiempo de construcción. No inventar estilos ad-hoc cuando exista una receta. - Espacio en blanco — cada bloque de texto tiene al menos
0.5 × font-sizede espacio de respiración vertical por encima y por debajo. - Ubicación del logotipo — arriba a la izquierda o abajo a la derecha, nunca centrado. Área segura =
BrandConfig.logo.safeAreaPx(permanece en.ts, aplicado por motion).
Salida
Dos artefactos:
- Un JSON de especificación de diseño escrito en
.research/design/{compositionId}-{brandSlug}.jsoncuyos valores hacen referencia a los tokens de{slug}.design.mdpor nombre (ej.{ "outer-margin": "{spacing.outer-margin-landscape}", "hook-type": "{typography.display-xl}" }) — sin valores literales en píxeles ni códigos hexadecimales en línea. - Ediciones en línea al TSX de la composición (si se está revisando).
Después de escribir la especificación de diseño, ejecutar npx --prefix Pi-Dev-Ops/remotion-studio design.md lint Synthex/packages/brand-config/src/brands/{slug}.design.md para confirmar que cada token referenciado en el diseño existe en el design.md de la marca. Bloquear en errores de lint; las advertencias son informativas.
Compuerta de crítica de 5 dimensiones (obligatoria antes de emitir la especificación de diseño)
Adoptada de nexu-io/open-design (Apache-2.0). Iniciar un subagente Opus 4.7 mediante el patrón opus-adversary para puntuar el diseño propuesto en cinco dimensiones ortogonales, cada una de 0 a 10 con evidencia citada. Escribir el veredicto en .research/design/{compositionId}-{brandSlug}.critique.json junto con la especificación de diseño.
Dimensiones
- Consistencia filosófica — ¿el diseño aboga por una dirección (ej. utilidad técnica, monóculo editorial) o combina tres estilos inconexos? Citar elementos específicos.
- Jerarquía visual — ¿un extraño puede descubrir qué leer primero/segundo/tercero sin que se lo digan? Citar el elemento más grande vs. el elemento más importante.
- Ejecución de detalles — alineación, interlineado, kerning en tamaños grandes, encuadre de imágenes, espaciado en casos extremos. Citar fotogramas específicos.
- Funcionalidad — ¿funciona para el canal previsto? ¿El hero vertical 9:16 es legible en un teléfono? ¿La CTA está dentro del área segura? Citar números de fotograma + mediciones.
- Innovación — ¿un movimiento inesperado que está justificado por el briefing, o 100% genérico? ¿Un acento que no era necesario pero que refuerza la identidad? Citar el movimiento.
Rangos
0–4 Roto · 5–6 Funcional · 7–8 Fuerte · 9–10 Excepcional. No inflar la nota — una media general superior a 8 es sospechosa; verificar dos veces.
Aprobado / no aprobado
- Aprobado: cada dimensión ≥ 6, Y media ≥ 7.
- No aprobado: cualquier dimensión ≤ 5, O media < 7. Devolver a
remotion-composition-buildercon las listas de Mantener/Corregir/Mejora rápida por dimensión para revisión antes de volver a ejecutar la compuerta. - Anulación: el fundador puede forzar la aprobación mediante un mensaje explícito ("enviarlo de todos modos"). La anulación se registra en
.research/design/{compositionId}-{brandSlug}.critique.jsoncon marca de tiempo y motivo.
Patrón reutilizado
Usar la skill opus-adversary — la misma generación de subagente Opus 4.7, la misma disciplina de citación de evidencia. No escribir un arnés de crítica paralelo.
Límites
- Nunca sobrescribir valores de
BrandConfig— proponer cambios a través deremotion-brand-codify. - Nunca usar animación para el diseño (sin escalar texto al pasar el ratón) — ese es territorio de
remotion-motion-language. - Nunca apilar >3 colores por escena; el tercero está reservado solo para acentos.
Pasar a
remotion-composition-builder consume la especificación de diseño y la aplica.