O que Manual de Marca faz?
Converte uma identidade já decidida (logo + estratégia) em um manual normativo: o documento que diz ao cliente, à sua equipe e aos seus fornecedores como usar a marca sem que a designer esteja presente. O manual documenta decisões; não as toma por conta própria. Por isso esta skill pergunta muito e gera pouco sem aprovação: cada coisa que o manual afirma tem que poder ser defendida perante o cliente.
Ritmo de toda a skill: uma pergunta de cada vez, sempre com sua recomendação e uma linha de porquê. Quando a pessoa aceitar sem discutir, nomeie em uma frase o que aquilo implica (o custo) e siga. Mantenha a contagem em voz alta ("Bloco 3 de 6 — Cor"). Se algo pode ser descoberto olhando (o PPT, o SVG, o site de uma licença), descubra em vez de perguntar.
Ferramentas
A skill usa scripts e guias próprios, em scripts/ e references/ junto a
este arquivo. Os scripts usam Python com Playwright/Chromium, Pillow, numpy e scipy;
text_to_svg.py precisa também de uharfbuzz (pip install --break-system-packages uharfbuzz).
Todos aceitam -h. Guias:
references/entrevista.md: banco de perguntas em ordem, com a recomendação padrão.references/nucleo.md: páginas do manual básico.references/modulos.md: módulos estendidos (tomados como referência do manual público da FIFA World Cup 26).references/esqueleto-slides.md: maquete editorial fixa e construção técnica do deck.
Mantenha uma lista de tarefas visível (análise, entrevista, versões, construtivo, cor, deck, pacote): o trabalho é longo e a pessoa pode ir e voltar.
Fase 0 — Entradas obrigatórias
Peça em uma única mensagem o que faltar:
- O logo em SVG, com o texto em contornos. Se só houver PNG/JPG, pare: sem SVG não se mede nem se geram versões confiáveis. Peça também qualquer outro SVG que exista (outras versões, retícula construtiva).
- A apresentação de branding anterior: Google Slides (a que
propuesta-brandingproduz), .pptx ou PDF. Se não existir, pare e sugira executarpropuesta-branding: o manual não inventa estratégia.
Leia a apresentação (para .pptx, python -m markitdown ou python-pptx; extraia
também as imagens das páginas de identidade visual e olhe-as: lá costumam estar
o sistema de logo, a paleta aplicada e as peças). Monte uma ficha:
quem somos, missão, visão, valores, personalidade, tom (diz / evita),
posicionamento, mantra, conceito do logo, moodboard, type board, paleta,
tipografias e regras implícitas (por exemplo "o nome sempre em preto, o
prefixo muda de cor"). Se faltar um campo que o manual precisa, pergunte só por
esse campo. Se uma cor aparecer sem HEX legível, mostre-a da imagem e
peça confirmação.
Fase 1 — Analisar o SVG
python scripts/svg_inspect.py logo.svg trabalho/inspecao/
Mostre inspecao.png e proponha os grupos. Normalmente são isotipo /
logotipo / tagline, mas se a identidade é dinâmica (uma parte muda de
cor por sub-marca, edifício, sede…), agrupe por regra de cor: o que
muda, o que é fixo e o que acompanha o que muda. Assim cada variante é
gerada com uma única instrução. Confirme-os e salve-os em
trabalho/grupos.json (por exemplo {"prefixo": ["1-4"], "nome": ["5-10"], "simbolo": [0]}).
Atenda aos ALERTAS: texto vivo, traços não expandidos, degradês, imagens embutidas.
Fase 2 — Entrevista
Siga references/entrevista.md (6 blocos: escopo → logo → cor →
tipografia → linguagem visual e aplicações → controle do documento). Pode dar
como resolvidas em uma mesma mensagem as decisões de baixo risco ("assumo X a
menos que me corrija"); as que custam caro reverter vão sozinhas.
Ao terminar, apresente o índice resultante (núcleo + módulos, com número de página) e aguarde aprovação antes de produzir qualquer coisa.
Fase 3 — Versões do logo (sempre com aprovação prévia)
Variantes de cor. Gere a proposta e mostre-a como folha; depois uma tabela: grupo de variantes · como se resolve · uso, mais as decisões que tomou. As dúvidas típicas que deve levantar ou resolver com a tabela de contraste da Fase 5:
- Em negativo, a cor se mantém ou passa para branco? Um negativo em cor só existe se essa cor contrasta com o fundo escuro (≥ 3:1); senão, monocromático branco.
- Sobre um fundo que é uma cor da própria paleta, o logo vai em uma única tinta (preto ou branco), nunca em outra cor da paleta.
- Em uma cor, algum detalhe interno se funde com a forma de trás? Proponha furar (
"furar"no spec). - Em identidades dinâmicas: a peça acompanhante (o símbolo, por exemplo) pode ter uma cor diferente? Recomende que não (uma peça = uma cor) e nomeie o custo.
python scripts/logo_variants.py logo.svg trabalho/variantes.json trabalho/versoes/ --version empilhada
Recomposições (horizontal ↔ vertical, símbolo sozinho, avatar, lock-ups):
- Pergunte se já existe o SVG; se existir, use-o.
- Se não, componha com
compose.py: apenas reposiciona, escala e separa peças existentes; nunca redesenha. Para passar de duas linhas para uma, use"alinhar": "base"com a linha base de cada grupo (pé de uma letra sem descendente) e uma separação igual ao espaço entre letras dentro da palavra, para que se leia como uma única palavra. - Mostre a pré-visualização (no avatar, também
_circulo.png; para o favicon, o teste a 32 e 16 px) e aguarde aprovação uma por uma. - Após aprovação, gere suas variantes compondo cada variante de cor aprovada (loop sobre os SVGs da versão principal).
Lock-ups com texto (slogan, nome de sub-marca ou edifício): converta o texto em contornos com a tipografia da marca, sem depender da fonte instalada, e adicione como peça externa:
python scripts/text_to_svg.py "Conecta. Vive. Pertence." fonte.woff trabalho/slogan.svg --color "#1D1D1B"
(as fontes do Google Fonts são obtidas com npm i @fontsource/<familia>; use o .woff).
Em compose.py, "externos": {"slogan": "trabalho/slogan.svg"} e "largura": {"slogan": "logo"}
igualam a largura à do logo. Para uma sub-marca sem nome definido, deixe um
marcador ("[Nome]") e normalize a estrutura, não cada caso. O texto do
lock-up vai na tinta da parte fixa do logo, nunca na cor variável.
Usos incorretos, com o logo real (--fundo-ruim: a cor da paleta com pior
contraste para a versão principal):
python scripts/incorrect_uses.py trabalho/versoes/<principal>.svg trabalho/incorretos/ --grupos g.json --nome "<marca>" --fundo-ruim "#2B57E2"
(g.json precisa de um grupo isotipo com o símbolo e o restante como logotipo).
Fase 4 — Retícula, proteção e tamanho mínimo
- Pergunte se a pessoa tem retícula construtiva e peça o SVG dela. Se tiver, use-a tal qual. Se não:
python scripts/construction.py candidatos logo.svg trabalho/construtivo/ --grupos trabalho/grupos.jsone mostre os candidatos em uma única folha. Costuma funcionar bem combinar dois: a espessura do traço como módulo do plano (cai sobre as hastes) e a largura do símbolo como medida da área de proteção ("deixe livre o espaço de um símbolo", fácil de explicar a qualquer fornecedor). Cobranding: o dobro.python scripts/construction.py plano <versao>.svg trabalho/construtivo/<versao> --modulo <u> --protecao <modulos>para cada versão.python scripts/min_size.py <versao>.svg trabalho/minimos/<versao> --grupos g.json(g.json comlogotipoe, se houver,tagline). Se houver ranhuras finas (a cruz de um símbolo), o script dá dois limiares: [completo] tudo se lê / [legível] o nome se lê e o símbolo fica como um ponto. Monte uma folha de teste com cada versão em vários tamanhos (real e ampliado) e deixe a pessoa escolher. O usual: o mínimo oficial é o [legível], e em formatos pequenos (assinatura, crachá) o símbolo aparece também separado e grande.
Fase 5 — Sistema de cor
- Monte
trabalho/cores.json: um HEX fonte por cor, função, e os RGB/CMYK/Pantone que vierem do material de origem, para validá-los. - Se a pessoa não tem Pantone validados, ofereça-se para fazer o trabalho:
python scripts/pantone_ref.py trabalho/cores.json trabalho/pantone_ref.json(Pantone C e têxtil TCX mais próximos por ΔE 2000). Copie o resultado paracores.jsone apresente em uma tabela com o ΔE: < 2 quase idêntico, 2–5 parecido, > 5 nota-se, > 10 sem equivalente. python scripts/color_system.py trabalho/cores.json trabalho/cor/: converte para CMYK com o perfil FOGRA39 se o encontrar, avisa das cores fora de gama (como ficarão impressas), valida RGB/HEX, calcula escalas 50–950 e a matriz de contraste.- Apresente os ALERTAS antes de projetar. Explique quais cores saem apagadas em CMYK e onde convém Pantone direto (adesivos, sinalização). Todo Pantone/TCX calculado vai no manual como "referência, validar com guia física e prova de cor". Nunca o apresente como oficial. Em preto, distinga preto enriquecido (áreas grandes) de 0/0/0/100 (textos).
- A matriz de contraste decide a tinta de texto e a do logo sobre cada fundo. Se o PPT disser "X sempre em preto" e o contraste o impedir em algum fundo, diga e proponha a regra corrigida ("X na tinta que contraste").
Fase 6 — Tipografia e licenças
Procure a licença de cada fonte no site antes de perguntar:
- Google Fonts / OFL: ok.
- "Grátis para uso pessoal": não cobre um logo comercial. Pergunte de onde a pessoa tirou.
- Envato Elements: cobre logos, mas é preciso registrar a fonte para aquele projeto enquanto a assinatura estiver ativa e guardar o certificado PDF. Se não o fez, é o pendente mais importante; coloque no manual um marcador do código de licença.
- Restrita a um sistema (por exemplo SF Pro): avise e proponha uma alternativa livre.
A fonte do logotipo, se for entregue em contornos, declara-se "apenas na arte do logo; não se instala". Defina uma fonte de backup (Google Docs/Canva e Word) e a hierarquia com exemplos escritos com a voz da marca.
Ilustrações de terceiros (bancos, comunidade do Figma): revise também sua
licença (Streamline Free, por exemplo, exige atribuição, permite 25 por
projeto e proíbe redistribuí-las). Se não puderem ser entregues a terceiros, o
manual as mostra como estilo de referência com o crédito, e não vão no .zip.
Para trazê-las do Figma use o conector oficial (create_session →
get_metadata → get_screenshot com base64; o arquivo fica salvo em
disco). No plano Starter as chamadas são limitadas: localize e escolha antes de
baixar. Se o conector local do Figma retornar "Token expired", o token
se altera na configuração do app (ou em Settings → Extensions), não no
arquivo; enquanto isso use o conector oficial ou peça a exportação.
Fase 7 — Construir o deck
Leia references/esqueleto-slides.md. Crie o deck a partir do tipo Slides
(título: "Manual de marca – ") e siga suas instruções de arquivos:
- Renderize para PNG transparente tudo o que vai no deck (versões, planos, testes de mínimo, usos incorretos, ilustrações) e envie como recursos de uma pasta do diretório de trabalho, até 25 por chamada.
deck.jsonprimeiro, com oordercompleto (núcleo + módulos + separadores) e as fontes da marca emfaces(Google Fonts); depois a capa, e depois lotes de 6–8 páginas.- Textos de estratégia: do PPT, em registro de manual, sem adicionar afirmações. O que faltar vai entre colchetes ("[e-mail]"), na página e nas notas do orador.
- Aplicações do ramo: construa-as no slide com formas, o PNG do logo e textos de exemplo com a voz da marca. Não são mockups fotográficos.
- Verifique se o nome da marca está correto em cabeçalhos e índice.
Fase 8 — Pacote de arquivos
Copie para uma pasta apenas os SVGs aprovados, com nome <versao>_<variante>.svg
(sem pré-visualizações nem peças soltas), e execute:
python scripts/package.py trabalho/entrega/ trabalho/pacote/ --marca "<Marca>"
Gera SVG, PNG transparente 500/1000/2000 px e PDF vetorial por variante, em RGB. As versões CMYK/Pantone, as simplificadas para bordado e o favicon de 16 px ajustado ficam como "pendentes de arte final". Envie o .zip com SendUserFile.
Fase 9 — Entrega
Mensagem breve: o deck (seu card já leva o link), o .zip e a lista de
pendentes agrupada por responsável (designer / cliente / gráfica).
Exemplos: registrar a licença da fonte, validar Pantone, o e-mail do
responsável pela marca, a arte final para bordado, a licença das
ilustrações. Como passo opcional, ofereça executar brand-board ou produzir
os templates.
Exemplo bom
Assim se documenta uma decisão no manual: concreta, mensurável e com seu estado.
Cor · Azul
HEX #2B57E2 · RGB 43/87/226 · CMYK 85/65/0/0 (FOGRA39, sai um pouco apagado)
Pantone 2728 C · ΔE 3,1 (parecido). Referência: validar com guia física e prova de cor.
Tamanho mínimo · Versão horizontal
24 mm / 90 px de largura: o nome se lê e o símbolo fica como ponto.
Menor (assinatura, crachá): usar o símbolo separado e grande.
Exemplo ruim
Pantone oficial: 2728 C
Não usar o logo muito pequeno.
Por que está errado: apresenta um Pantone calculado como oficial e sem ΔE, e o mínimo não tem medida, então nenhum fornecedor consegue verificar se o cumpre.
O que esta skill nunca faz
- Redesenhar ou "melhorar" o logo: apenas recoloriza, fura, reposiciona, escala e separa peças existentes, e converte em contornos textos novos.
- Criar uma versão sem aprovação prévia.
- Inventar estratégia, licenças ou dados do cliente, nem apresentar Pantones calculados como oficiais.
- Misturar valores de cor de fontes diferentes sem validá-los.