remotion-brand-codify
Wandelt Forschungsergebnisse in typisierten Code um, den jede Komposition verwenden kann.
Auslöser
- Nachdem
remotion-brand-researchein Dossier unter.research/geschrieben hat. - Der Benutzer fügt Markenfarben, Schriftarten und Ton-Notizen ein und sagt: „codify the {brand} brand".
Eingaben
.research/brand-{slug}-{date}.json(bevorzugt) oder das Markdown-Dossier.- Vorhandene Datei
Synthex/packages/brand-config/src/brands/{slug}.ts(für Diff-Prüfung).
Methode
- Das Dossier muss jedes Pflichtfeld von
BrandConfigabdecken (sieheSynthex/packages/brand-config/src/types.ts). Fehlende Felder blockieren den Vorgang;remotion-brand-researchwird um Ausfüllung gebeten. - Den Boundary-Vertrag anwenden — Farb-Hexwerte / Typografie-Skala / Abstände / Komponenten / Layout gehen nach
.design.md; Sprachausgabe / Bewegung / Zielgruppe / Kanal / verbotene Wörter / Logo-Pfade / Signatur gehen nach.ts. SiehePi-Dev-Ops/remotion-studio/src/brands/CONTRACT.md. - Für jede Farbe
remotion-colour-familyausführen, wenn die Palette weniger als 5 Farben hat oder WCAG-AA für „Text auf Primärfarbe" nicht besteht. Die Farbfamilien-Fähigkeit gibt einen YAML-Block aus, der direkt in dencolors:-Abschnitt der.design.mdeingefügt werden kann. - Bei Bewegung
remotion-motion-languageausführen, falls dermotion-Block leer ist. - Schriftarten-Lizenzen validieren: Nur OFL-/Apache-/MIT-Familien sind zulässig. Adobe Fonts (serverseitiges Rendering verboten) und kostenpflichtige Google Fonts werden blockiert.
Synthex/packages/brand-config/src/brands/{slug}.tsausgeben, das nur Laufzeitfelder enthält (gemäß CONTRACT.md).Synthex/packages/brand-config/src/brands/ra.tsals kanonisches Beispiel verwenden. Anschließendnpm run buildvonSynthex/packages/brand-config/aus ausführen, umdist/neu zu generieren.Synthex/packages/brand-config/src/brands/{slug}.design.mdausgeben, das nur visuelle Tokens im spezifikationskonformen@google/design.md-Format enthält. Vorhandene*.design.md(z.B.ra.design.md) als kanonisches Beispiel verwenden.- Die design.md linten —
npx --prefix Pi-Dev-Ops/remotion-studio design.md lint Synthex/packages/brand-config/src/brands/{slug}.design.mdausführen. Bei Fehlern blockieren. Warnungen sind empfehlend — behebeunreferenced-token-Warnungen nur, wenn das ungenutzte Token keine semantische Absicht hat. - In den Laufzeit-Pfad spiegeln —
cp Synthex/packages/brand-config/src/brands/{slug}.design.md Pi-Dev-Ops/packages/brand-config/src/brands/{slug}.design.md. Der Laufzeit-Loader (loadDesign(slug)) liest aus der lokalen Pi-Dev-Ops-Kopie über den Workspace-Link in remotion-studio. Synthex/packages/brand-config/src/brands/index.tsaktualisieren, wenn der Slug neu ist (auch dieBrandSlug-Union intypes.tserweitern).- Die menschenlesbare 9-teilige Projektion unter
Pi-Dev-Ops/remotion-studio/src/brands/{slug}.mdneu generieren, die AUS BEIDEN.tsund.design.mdliest. Die Abschnitte 2 (Farbpalette), 3 (Typografie), 4 (Komponenten), 5 (Layout) beziehen sich aus.design.md; die Abschnitte 1, 6, 7, 8, 9 aus.ts+ ergänzendem Prosa.
Ausgabe
Drei bearbeitete Dateien pro Marke:
Synthex/packages/brand-config/src/brands/{slug}.ts— typisierteBrandConfig(Laufzeit + Verhalten, Quelle der Wahrheit gemäß RA-1985).Synthex/packages/brand-config/src/brands/{slug}.design.md— visuelle Tokens (Quelle der Wahrheit, spezifikationskonformes@google/design.md).Pi-Dev-Ops/remotion-studio/src/brands/{slug}.md— 9-teilige menschenlesbare Projektion (aus BEIDEN neu generiert; niemals manuell bearbeiten).
Plus die Laufzeit-Spiegelung unter Pi-Dev-Ops/packages/brand-config/src/brands/{slug}.design.md (eine Kopie von #2 – synchron gehalten, bis die Brand-Konsolidierung die lokale Kopie entfernt).
Die 9-teilige .md-Projektion ist eine Projektion der .ts + .design.md, keine parallele Quelle. Immer neu generieren, wenn eine der Quellen geändert wird; niemals manuell bearbeiten. Die Abschnittsreihenfolge ist festgelegt:
- Visuelles Thema & Atmosphäre (aus
.tsvoice + audience Prosa) - Farbpalette & Rollen (Tabelle, die
.design.mdcolors:spiegelt, plus Zeile für dunkle Variante, falls definiert) - Typografie-Regeln (aus
.design.mdtypography:+ Familie/Gewicht ausBrandTypographyfür Lizenzrückverfolgung) - Komponenten-Stylings (aus
.design.mdcomponents:) - Layout-Prinzipien (aus
.design.mdspacing.outer-margin-*+BrandLogo.safeAreaPx) - Tiefe & Höhenstaffelung (aus
.design.mdElevation Prosa) - Dos and Don'ts (Verkettung von
.tsdoNot+voice.forbiddenWords+ Do's/Don'ts-Abschnitt aus.design.md) - Responsives Verhalten (Seitenverhältnisse aus
.ts, Schriftskala pro Verhältnis aus.design.md) - Agent Prompt Guide (ein wörtliches Beispiel, das
{colors.*}undmotion.signature-Tokens aufruft)
Zusätzlich eine PR (oder lokaler Diff) mit Zusammenfassung von:
- Quelldossier-Pfad
- Ausgefüllte Felder vs. Felder zur Prüfung durch den Gründer
- Lint-Status (
design.md lintFehler/Warnungen, Schriftlizenz, Kontrast) - Alle drei ausgegebenen Dateien (
.ts+.design.md+.mdProjektion) – blockieren bei fehlendem Artefakt
Grenzen
- Immer PR
auto-merge:falsesetzen – Marken-Stimm-Nuancen müssen von einem Menschen geprüft werden. - Niemals eine vorhandene Datei stillschweigend überschreiben; einen Side-by-Side-Diff erzeugen.
- Niemals Schriftarten oder Farben erfinden – Werte stammen aus dem Recherche-Dossier oder werden auf neutrale Fallbacks mit
// TODO: Gründer-Review-Kommentaren zurückgesetzt. - Niemals einen Token doppelt in
.tsund.design.mddeklarieren. Wenncolour.primaryin.design.mdlebt, darf.tsihn nicht erneut deklarieren. Die CONTRACT.md ist der Schiedsrichter. - Niemals die
.md-Projektion von Hand bearbeiten – immer aus den Quellen neu generieren.
Wiederverwendet
src/brands/CONTRACT.md— Grenze der Token-Zugehörigkeitsrc/brands/ra.design.md— kanonisches.design.md-BeispielSynthex/packages/brand-config/src/brands/ra.ts— kanonisches.ts-Beispielsrc/design-systems/_library/— 140 bereitgestellte DESIGN.md-Dateien zur visuellen Verankerung (maximal eine zitieren)
Wiederverwendete Hilfsmittel
Synthex/packages/brand-config/src/types.ts— Schema-Quelle der Wahrheit (gemäß RA-1985)remotion-studio/src/colour/index.ts—contrast()für WCAG-Prüfungenremotion-studio/src/design-systems/_library/— 138 bereitgestellte Referenz-DESIGN.md-Dateien (Open-Design, Apache-2.0). Maximal eine als visuelle Verankerung in der.md-Projektion zitieren; niemals wörtlich kopieren- Referenzprojektion:
remotion-studio/src/brands/ra.mdist das kanonische Beispiel zur Nachahmung