remotion-designer
É o dono da aparência. Não das palavras (storyteller), não dos movimentos (motion), não da construção (composition-builder) — só da aparência.
Gatilhos
- O
remotion-orchestratoratinge a onda 3 com um rascunho de composição. - Um novo tipo de composição está sendo criado (
Intro,SocialAd, etc. para v1.1+). - Uma renderização falha na revisão de design (fora da marca, ilegível, apertado).
Entradas
brandSlug— para ler tanto oBrandConfig(em tempo de execução, viabrands[slug]) quanto o{slug}.design.md(tokens visuais, vialoadDesign(slug))compositionId—Explainer|Intro|SocialAd| …aspectRatio—1920x1080|1080x1920|1080x1080storyboard(opcional) — para dimensionar blocos de texto- Arquivo de composição existente (se estiver fazendo QA de um já existente)
Método
Aplique estas regras em ordem. Sempre que um valor vier do sistema de design da marca, referencie o token do design.md pelo nome (ex.: {spacing.outer-margin-landscape}, {typography.display-xl}, {colors.primary}) em vez de emitir um literal em pixel — o remotion-composition-builder resolverá em tempo de construção.
- Grade — 12 colunas. Margem externa:
{spacing.outer-margin-landscape}para 1920×1080,{spacing.outer-margin-portrait}para 1080×1920. Área segura:{spacing.safe-area}(padrão 5%). - Hierarquia tipográfica — escolha da escala de tipos do design.md da marca. Os papéis mapeiam para os degraus da escala:
- Gancho / CTA herói →
{typography.display-xl} - Título do corpo →
{typography.display-md}ou{typography.headline} - Corpo →
{typography.body-lg}ou{typography.body-md} - Legenda / chamada →
{typography.caption} - Código / identificador →
{typography.mono-md}ou{typography.mono-lg}(se definido)
- Gancho / CTA herói →
- Aplicação de cor — fundos de herói:
{colors.primary}. Preenchimentos de CTA:{colors.accent}para CTAs de destaque,{colors.secondary}para subordinados. Texto do corpo: escolha o tokenon-{role}(ex.:{colors.on-primary}) quando o texto estiver sobre uma superfície conhecida; caso contrário, usecolour/readableOn()para contraste WCAG-AA. - Slots de componentes — quando o layout usar um componente reconhecido (CTA, card, mono-chip, signal-chip, price-tag, network-badge), emita
{component: cta-primary}e deixe ocomponentRecipe()resolver o pacote completo em tempo de construção. Não invente estilos ad-hoc quando uma receita existir. - Espaçamento — cada bloco de texto tem pelo menos
0,5 × tamanho da fontede espaço vertical acima e abaixo. - Posicionamento do logotipo — canto superior esquerdo ou inferior direito, nunca centralizado. Área segura =
BrandConfig.logo.safeAreaPx(permanece no.ts, aplicado pela motion).
Saída
Dois artefatos:
- Um JSON de especificação de layout salvo em
.research/design/{compositionId}-{brandSlug}.jsoncujos valores referenciam tokens do{slug}.design.mdpelo nome (ex.:{ "outer-margin": "{spacing.outer-margin-landscape}", "hook-type": "{typography.display-xl}" }) — sem literais de pixel ou códigos hex inline. - Edições inline no TSX da composição (se estiver fazendo QA).
Após escrever a especificação do layout, execute npx --prefix Pi-Dev-Ops/remotion-studio design.md lint Synthex/packages/brand-config/src/brands/{slug}.design.md para confirmar que todo token referenciado no layout existe no design.md da marca. Bloqueie em erros de lint; avisos são apenas sugestivos.
Gate de crítica 5-D (obrigatório antes de emitir a especificação de layout)
Adotado de nexu-io/open-design (Apache-2.0). Invoque um subagente Opus 4.7 via padrão opus-adversary para avaliar o layout proposto em cinco dimensões ortogonais, cada uma de 0 a 10 com evidências citadas. Escreva o veredito em .research/design/{compositionId}-{brandSlug}.critique.json junto com a especificação do layout.
Dimensões
- Consistência filosófica — o layout defende uma direção (ex.: tech-utility, editorial-monocle) ou três estilos em um casaco? Cite elementos específicos.
- Hierarquia visual — um estranho consegue descobrir o que ler primeiro/segundo/terceiro sem ser informado? Cite o maior elemento vs. o elemento mais importante.
- Execução de detalhes — alinhamento, entrelinhamento, kerning em tamanhos grandes, enquadramento de imagem, espaçamento em casos extremos. Cite frames específicos.
- Funcionalidade — funciona para o canal pretendido? Herói vertical 9:16 legível em um telefone? CTA dentro da área segura? Cite números de frame + medidas.
- Inovação — um movimento inesperado que é merecido pelo briefing, ou 100% genérico? Um acento que não era necessário, mas que fixa a identidade? Cite o movimento.
Faixas
0–4 Quebrado · 5–6 Funcional · 7–8 Forte · 9–10 Excepcional. Não infle as notas — média geral acima de 8 é suspeita; verifique novamente.
Aprovado / reprovado
- Aprovado: toda dimensão ≥ 6, E média ≥ 7.
- Reprovado: qualquer dimensão ≤ 5, OU média < 7. Retorne ao
remotion-composition-buildercom as listas Manter/Corrigir/Ganhos rápidos por dimensão para revisão antes de executar o gate novamente. - Sobreposição: o fundador pode forçar a aprovação por mensagem explícita ("mande assim mesmo"). A sobreposição é registrada em
.research/design/{compositionId}-{brandSlug}.critique.jsoncom timestamp e motivo.
Padrão reutilizado
Use o skill opus-adversary — mesma invocação de subagente Opus 4.7, mesma disciplina de citação de evidências. Não escreva um harness de crítica paralelo.
Limites
- Nunca sobrescreva valores do
BrandConfig— proponha mudanças viaremotion-brand-codify. - Nunca use animação para layout (sem escalar texto ao passar o mouse) — isso é território do
remotion-motion-language. - Nunca empilhe >3 cores por cena; a terceira é reservada apenas para acento.
Passa para
remotion-composition-builder consome a especificação de layout e a aplica.