remotion-brand-codify
Transforme le résultat de recherche en code typé que chaque composition lit.
Déclencheurs
- Après que
remotion-brand-researchait écrit un dossier dans.research/. - L'utilisateur colle des couleurs, polices et notes de ton et dit « codify the {brand} brand ».
Entrées
.research/brand-{slug}-{date}.json(préféré) ou le dossier MarkdownSynthex/packages/brand-config/src/brands/{slug}.tsexistant si présent (pour le diff)
Méthode
- Valider que le dossier couvre tous les champs obligatoires de
BrandConfig(voirSynthex/packages/brand-config/src/types.ts). Champs manquants = blocage ; demander àremotion-brand-researchde compléter. - Appliquer le contrat de frontière — les hexadécimaux de couleurs / échelle typographique / espacement / composants / disposition vont dans
.design.md; la voix / voiceover / mouvement / audience / canal / mots interdits / chemins de logo / signature vont dans.ts. VoirPi-Dev-Ops/remotion-studio/src/brands/CONTRACT.md. - Pour chaque couleur, exécuter
remotion-colour-familysi la palette contient moins de 5 couleurs ou échoue WCAG-AA sur « text on primary ». Le skill colour-family émet un bloc YAML prêt à être inséré dans la sectioncolors:du.design.md. - Pour le mouvement, exécuter
remotion-motion-languagesi le blocmotionest vide. - Pour les polices, valider la licence : seules les familles OFL / Apache / MIT passent. Bloquer sur Adobe Fonts (rendu côté serveur interdit) et les polices Google payantes.
- Émettre
Synthex/packages/brand-config/src/brands/{slug}.tscontenant uniquement les champs runtime (selon CONTRACT.md). UtiliserSynthex/packages/brand-config/src/brands/ra.tscomme exemple canonique. Exécuternpm run builddepuisSynthex/packages/brand-config/après pour regénérerdist/. - Émettre
Synthex/packages/brand-config/src/brands/{slug}.design.mdcontenant uniquement les tokens visuels au format conforme à la spécification@google/design.md. Utiliser tout*.design.mdexistant (ex.ra.design.md) comme exemple canonique. - Linter le design.md — exécuter
npx --prefix Pi-Dev-Ops/remotion-studio design.md lint Synthex/packages/brand-config/src/brands/{slug}.design.md. Bloquer sur les erreurs. Les avertissements sont consultatifs — corriger les avertissements de token non référencé uniquement lorsque le token inutilisé n'a aucune intention sémantique. - Miroiter vers l'emplacement runtime —
cp Synthex/packages/brand-config/src/brands/{slug}.design.md Pi-Dev-Ops/packages/brand-config/src/brands/{slug}.design.md. Le chargeur runtime (loadDesign(slug)) lit depuis la copie locale de Pi-Dev-Ops via le lien d'espace de travail dans remotion-studio. - Mettre à jour
Synthex/packages/brand-config/src/brands/index.tssi le slug est nouveau (également étendre l'unionBrandSlugdanstypes.ts). - Regénérer la projection lisible en 9 sections à
Pi-Dev-Ops/remotion-studio/src/brands/{slug}.mden lisant à la fois.tset.design.md. Les sections 2 (Palette de couleurs), 3 (Typographie), 4 (Composants), 5 (Disposition) tirent leurs données de.design.md; les sections 1, 6, 7, 8, 9 tirent de.ts+ prose d'accompagnement.
Sortie
Trois fichiers édités par marque :
Synthex/packages/brand-config/src/brands/{slug}.ts—BrandConfigtypé (runtime + comportement, source de vérité selon RA-1985).Synthex/packages/brand-config/src/brands/{slug}.design.md— tokens visuels (source de vérité, conforme à la spécification@google/design.md).Pi-Dev-Ops/remotion-studio/src/brands/{slug}.md— projection lisible en 9 sections (regénérée à partir des DEUX ; ne jamais éditer manuellement).
Plus le miroir runtime à Pi-Dev-Ops/packages/brand-config/src/brands/{slug}.design.md (une copie du #2 — maintenue synchronisée jusqu'à ce que la consolidation brand-config supprime la copie locale).
La projection .md en 9 sections est une projection du .ts + .design.md, pas une source parallèle. Regénérer chaque fois que l'une des sources change ; ne jamais éditer manuellement. L'ordre des sections est fixe :
- Thème visuel et atmosphère (depuis
.tsvoix + prose audience) - Palette de couleurs et rôles (tableau miroir de
colors:dans.design.md, plus ligne variante sombre si définie) - Règles typographiques (depuis
typography:dans.design.md+ famille/poids deBrandTypographypour traçabilité de licence) - Styles des composants (depuis
components:dans.design.md) - Principes de disposition (depuis
spacing.outer-margin-*+BrandLogo.safeAreaPxdans.design.md) - Profondeur et élévation (depuis la prose d'Élévation dans
.design.md) - À faire et à ne pas faire (concaténation de
doNotdans.ts+voice.forbiddenWords+ section À faire/Ne pas faire du.design.md) - Comportement responsive (ratios d'aspect depuis
.ts, échelle typographique par ratio depuis.design.md) - Guide de prompt pour l'agent (un exemple littéral invoquant les tokens
{colors.*}etmotion.signature)
Plus une PR (ou diff local) résumant :
- Chemin du dossier source
- Champs renseignés vs laissés à la revue du fondateur
- État du lint (erreurs/avertissements du
design.md lint, licence des polices, contraste) - Les trois fichiers émis (
.ts+.design.md+ projection.md) — bloquer en cas d'artefact manquant
Frontières
- Toujours définir
auto-merge:falsesur la PR — la nuance de la voix de la marque doit être revue par un humain. - Ne jamais écraser un fichier existant silencieusement ; produire un diff côte à côte.
- Ne jamais inventer de polices ou couleurs — les valeurs proviennent du dossier de recherche ou utilisent des valeurs neutres par défaut avec des commentaires
// TODO: revue fondateur. - Ne jamais dupliquer un token entre
.tset.design.md. Sicolour.primaryvit dans.design.md, le.tsne doit pas le redéclarer. Le CONTRACT.md est l'arbitre. - Ne jamais éditer la projection
.mdà la main — la regénérer à partir des sources.
Réutilisé
src/brands/CONTRACT.md— frontière de propriété des tokenssrc/brands/ra.design.md— exemple canonique.design.mdSynthex/packages/brand-config/src/brands/ra.ts— exemple canonique.tssrc/design-systems/_library/— 140 fichiers DESIGN.md importés pour ancrage d'école visuelle (citer au plus un)
Utilitaires réutilisés
Synthex/packages/brand-config/src/types.ts— schéma source de vérité (selon RA-1985)remotion-studio/src/colour/index.ts—contrast()pour les vérifications WCAGremotion-studio/src/design-systems/_library/— 138 fichiers DESIGN.md de référence importés (open-design, Apache-2.0). Citer au plus un comme ancre d'école visuelle dans la projection.md; ne jamais copier textuellement- Projection de référence :
remotion-studio/src/brands/ra.mdest l'exemple canonique à refléter