remotion-brand-codify
Convierte el resultado de una investigación en código tipificado que toda composición puede leer.
Disparadores
- Después de que
remotion-brand-researchescriba un dossier en.research/. - El usuario pega colores de marca, tipografías y notas de tono y dice "codifica la marca {marca}".
Entradas
.research/brand-{slug}-{fecha}.json(preferido) o el dossier en markdown.Synthex/packages/brand-config/src/brands/{slug}.tsexistente, si está presente (para diff).
Método
- Validar que el dossier cubra cada campo requerido de
BrandConfig(verSynthex/packages/brand-config/src/types.ts). Campos faltantes = bloquear; pedir aremotion-brand-researchque los complete. - Aplicar el contrato de límites — los colores hex / escala tipográfica / espaciado / componentes / diseño van a
.design.md; voz / locución / movimiento / audiencia / canal / palabras prohibidas / rutas de logo / firma van a.ts. VerPi-Dev-Ops/remotion-studio/src/brands/CONTRACT.md. - Para cada color, ejecutar
remotion-colour-familysi la paleta tiene menos de 5 colores o falla WCAG-AA entexto sobre primario. La habilidad de familia de colores emite un bloque YAML listo para insertar en la seccióncolors:del.design.md. - Para movimiento, ejecutar
remotion-motion-languagesi el bloquemotionestá vacío. - Para tipografías, validar licencias: solo familias OFL / Apache / MIT pasan. Bloquear en Adobe Fonts (renderizado del lado del servidor no permitido) y Google Fonts de pago.
- Emitir
Synthex/packages/brand-config/src/brands/{slug}.tsconteniendo solo campos de runtime (según CONTRACT.md). UsarSynthex/packages/brand-config/src/brands/ra.tscomo ejemplo canónico. Ejecutarnpm run builddesdeSynthex/packages/brand-config/después para regenerardist/. - Emitir
Synthex/packages/brand-config/src/brands/{slug}.design.mdconteniendo solo tokens visuales en formato@google/design.mdconforme al estándar. Usar cualquier*.design.mdexistente (ej.ra.design.md) como ejemplo canónico. - Hacer lint del design.md — ejecutar
npx --prefix Pi-Dev-Ops/remotion-studio design.md lint Synthex/packages/brand-config/src/brands/{slug}.design.md. Bloquear en errores. Las advertencias son orientativas — corregir advertencias de token-no-referenciado solo cuando el token no usado no tenga intención semántica. - Reflejar a la ubicación de runtime —
cp Synthex/packages/brand-config/src/brands/{slug}.design.md Pi-Dev-Ops/packages/brand-config/src/brands/{slug}.design.md. El cargador de runtime (loadDesign(slug)) lee desde la copia local de Pi-Dev-Ops a través del enlace de espacio de trabajo en remotion-studio. - Actualizar
Synthex/packages/brand-config/src/brands/index.tssi el slug es nuevo (también extender la uniónBrandSlugentypes.ts). - Regenerar la proyección legible de 9 secciones en
Pi-Dev-Ops/remotion-studio/src/brands/{slug}.mdleyendo TANTO del.tscomo del.design.md. Las secciones 2 (Paleta de colores), 3 (Tipografía), 4 (Componentes), 5 (Diseño) se obtienen del.design.md; las secciones 1, 6, 7, 8, 9 se obtienen del.tsmás prosa de apoyo.
Salida
Tres archivos editados por marca:
Synthex/packages/brand-config/src/brands/{slug}.ts—BrandConfigtipificado (runtime + comportamiento, fuente de verdad según RA-1985).Synthex/packages/brand-config/src/brands/{slug}.design.md— tokens visuales (fuente de verdad,@google/design.mdconforme al estándar).Pi-Dev-Ops/remotion-studio/src/brands/{slug}.md— proyección legible de 9 secciones (regenerada desde AMBAS; nunca editar a mano).
Además, el espejo de runtime en Pi-Dev-Ops/packages/brand-config/src/brands/{slug}.design.md (una copia de #2 — se mantiene sincronizada hasta que la consolidación de brand-config elimine la copia local).
La proyección .md de 9 secciones es una proyección del .ts + .design.md, no una fuente paralela. Regenerarla cada vez que alguna fuente cambie; nunca editar a mano. El orden de las secciones es fijo:
- Tema Visual y Ambiente (desde
.tsvoz + prosa de audiencia) - Paleta de Colores y Roles (tabla que refleja
colors:del.design.md, más fila de variante oscura si está definida) - Reglas Tipográficas (desde
typography:del.design.md+ familia/peso deBrandTypographypara traza de licencia) - Estilos de Componentes (desde
components:del.design.md) - Principios de Diseño (desde
spacing.outer-margin-*del.design.md+BrandLogo.safeAreaPx) - Profundidad y Elevación (desde la prosa de Elevación del
.design.md) - Qué Hacer y Qué No Hacer (concatenar
doNotdel.ts+voice.forbiddenWords+ sección de Hacer/No Hacer del.design.md) - Comportamiento Adaptable (relaciones de aspecto desde
.ts, escala tipográfica por relación desde.design.md) - Guía de Prompt para el Agente (un ejemplo literal que invoca tokens
{colors.*}ymotion.signature)
Además, un PR (o diff local) que resuma:
- Ruta del dossier fuente
- Campos completados vs. dejados para revisión del fundador
- Estado del lint (errores / advertencias de
design.md lint, licencia de tipografía, contraste) - Los tres archivos emitidos (
.ts+.design.md+ proyección.md) — bloquear si falta algún artefacto
Límites
- Siempre establecer
auto-merge:falseen el PR — los matices de la voz de marca deben ser revisados por un humano. - Nunca sobrescribir un archivo existente en silencio; producir un diff lado a lado.
- Nunca inventar fuentes o colores — los valores provienen del dossier de investigación o se establecen por defecto en neutrales con comentarios
// TODO: revisión del fundador. - Nunca duplicar un token entre
.tsy.design.md. Sicolour.primaryvive en.design.md, el.tsno debe redeclararlo. El CONTRACT.md es el árbitro. - Nunca editar la proyección
.mda mano — regenerar a partir de las fuentes.
Reutilizado
src/brands/CONTRACT.md— límite de propiedad de tokenssrc/brands/ra.design.md— ejemplo canónico de.design.mdSynthex/packages/brand-config/src/brands/ra.ts— ejemplo canónico de.tssrc/design-systems/_library/— 140 archivos DESIGN.md proveídos para anclaje visual de escuela (citar como máximo uno)
Utilidades reutilizadas
Synthex/packages/brand-config/src/types.ts— esquema fuente de verdad (según RA-1985)remotion-studio/src/colour/index.ts—contrast()para verificaciones WCAGremotion-studio/src/design-systems/_library/— 138 archivos DESIGN.md de referencia proveídos (open-design, Apache-2.0). Citar como máximo uno como ancla de escuela visual en la proyección.md; nunca copiar textualmente- Proyección de referencia:
remotion-studio/src/brands/ra.mdes el ejemplo canónico a reflejar