remotion-brand-codify
Transforma a saída da pesquisa em código tipado que toda composição lê.
Gatilhos
- Após
remotion-brand-researchescrever um dossiê em.research/. - O usuário cola cores, fontes e notas de tom da marca e diz "codifique a marca {slug}".
Entradas
.research/brand-{slug}-{date}.json(preferido) ou o dossiê markdownSynthex/packages/brand-config/src/brands/{slug}.tsexistente, se presente (para diff)
Método
- Validar que o dossiê cobre todos os campos obrigatórios de
BrandConfig(vejaSynthex/packages/brand-config/src/types.ts). Campos faltantes = bloqueio; peça aoremotion-brand-researchpara preencher. - Aplicar o contrato de fronteira — hexadecimais de cor / escala tipográfica / espaçamento / componentes / layout vão para
.design.md; voz / voz-over / movimento / público / canal / palavras-proibidas / caminhos de logo / assinatura vão para.ts. VejaPi-Dev-Ops/remotion-studio/src/brands/CONTRACT.md. - Para cada cor, executar
remotion-colour-familyse a paleta tiver menos de 5 cores ou falhar WCAG-AA em "text on primary". A skill colour-family emite um bloco YAML pronto para ser inserido na seçãocolors:do.design.md. - Para movimento, executar
remotion-motion-languagese o blocomotionestiver vazio. - Para fontes, validar licenciamento: apenas famílias OFL / Apache / MIT são aprovadas. Bloquear Adobe Fonts (renderização no servidor proibida) e fontes pagas do Google Fonts.
- Emitir
Synthex/packages/brand-config/src/brands/{slug}.tscontendo apenas campos de runtime (conforme CONTRACT.md). UsarSynthex/packages/brand-config/src/brands/ra.tscomo exemplo canônico. Executarnpm run buildemSynthex/packages/brand-config/depois para regenerardist/. - Emitir
Synthex/packages/brand-config/src/brands/{slug}.design.mdcontendo apenas tokens visuais no formato@google/design.mdconforme especificação. Usar qualquer*.design.mdexistente (ex.:ra.design.md) como exemplo canônico. - Executar lint no design.md — rodar
npx --prefix Pi-Dev-Ops/remotion-studio design.md lint Synthex/packages/brand-config/src/brands/{slug}.design.md. Bloquear em erros. Avisos são consultivos — corrija avisos de token não referenciado apenas quando o token não utilizado não tiver intenção semântica. - Espelhar para o local de runtime —
cp Synthex/packages/brand-config/src/brands/{slug}.design.md Pi-Dev-Ops/packages/brand-config/src/brands/{slug}.design.md. O carregador de runtime (loadDesign(slug)) lê da cópia local do Pi-Dev-Ops através do link de workspace no remotion-studio. - Atualizar
Synthex/packages/brand-config/src/brands/index.tsse o slug for novo (também estender a uniãoBrandSlugemtypes.ts). - Regenerar a projeção legível de 9 seções em
Pi-Dev-Ops/remotion-studio/src/brands/{slug}.mdlendo de AMBOS.tse.design.md. Seções 2 (Paleta de Cores), 3 (Tipografia), 4 (Componentes), 5 (Layout) puxam de.design.md; seções 1, 6, 7, 8, 9 puxam de.ts+ prosa de apoio.
Saída
Três arquivos editados por marca:
Synthex/packages/brand-config/src/brands/{slug}.ts—BrandConfigtipado (runtime + comportamento, fonte da verdade conforme RA-1985).Synthex/packages/brand-config/src/brands/{slug}.design.md— tokens visuais (fonte da verdade,@google/design.mdconforme especificação).Pi-Dev-Ops/remotion-studio/src/brands/{slug}.md— projeção legível de 9 seções (regenerada de AMBOS; nunca editar manualmente).
Mais o espelho de runtime em Pi-Dev-Ops/packages/brand-config/src/brands/{slug}.design.md (uma cópia do #2 — mantida em sincronia até a consolidação do brand-config remover a cópia local).
A projeção .md de 9 seções é uma projeção do .ts + .design.md, não uma fonte paralela. Regere-a sempre que qualquer uma das fontes mudar; nunca edite manualmente. A ordem das seções é fixa:
- Tema Visual & Atmosfera (da prosa de voz + público do
.ts) - Paleta de Cores & Papéis (tabela espelhando
colors:do.design.md, mais linha de variante escura se definida) - Regras Tipográficas (de
typography:do.design.md+ família/peso deBrandTypographypara rastreio de licença) - Estilizações de Componentes (de
components:do.design.md) - Princípios de Layout (de
spacing.outer-margin-*do.design.md+BrandLogo.safeAreaPx) - Profundidade & Elevação (da prosa de Elevação do
.design.md) - O Que Fazer e O Que Não Fazer (concatenar
doNotdo.ts+voice.forbiddenWords+ seção Do's/Don'ts do.design.md) - Comportamento Responsivo (proporções de aspecto do
.ts, escala tipográfica por proporção do.design.md) - Guia de Prompt do Agente (um exemplo literal invocando tokens
{colors.*}emotion.signature)
Mais um PR (ou diff local) resumindo:
- Caminho do dossiê fonte
- Campos preenchidos vs deixados para revisão do fundador
- Status do lint (erros/avisos do
design.md lint, licença de fonte, contraste) - Todos os três arquivos emitidos (
.ts+.design.md+ projeção.md) — bloquear em artefato faltante
Fronteiras
- Sempre definir PR
auto-merge:false— a nuance da voz da marca deve ser revisada por um humano. - Nunca sobrescrever um arquivo existente silenciosamente; produzir um diff lado a lado.
- Nunca inventar fontes ou cores — valores vêm do dossiê de pesquisa ou padrão para fallbacks neutros com comentários
// TODO: revisão do fundador. - Nunca duplicar um token entre
.tse.design.md. Secolour.primaryvive no.design.md, o.tsnão deve redeclarar. O CONTRACT.md é o árbitro. - Nunca editar a projeção
.mdmanualmente — regerar das fontes.
Reutilizados
src/brands/CONTRACT.md— fronteira de propriedade de tokenssrc/brands/ra.design.md— exemplo canônico de.design.mdSynthex/packages/brand-config/src/brands/ra.ts— exemplo canônico de.tssrc/design-systems/_library/— 140 arquivos DESIGN.md licenciados para ancoragem de escola visual (citar no máximo um)
Utilitários reutilizados
Synthex/packages/brand-config/src/types.ts— esquema fonte da verdade (conforme RA-1985)remotion-studio/src/colour/index.ts—contrast()para verificações WCAGremotion-studio/src/design-systems/_library/— 138 arquivos DESIGN.md de referência licenciados (open-design, Apache-2.0). Citar no máximo um como âncora de escola visual na projeção.md; nunca copiar literalmente- Projeção de referência:
remotion-studio/src/brands/ra.mdé o exemplo canônico a espelhar