design.md: o que é e como usar com LLM para manter a identidade visual

Você pede uma página para uma ferramenta de IA. Sai boa. Pede outra, no mesmo tom, e ela volta com outra fonte, outro azul, outro espaçamento. Nada mudou no seu pedido. Mudou o contexto que a ferramenta tinha à mão.

É esse buraco que um arquivo chamado design.md tenta tapar. Não é ferramenta de design nem produto. É um arquivo de texto que descreve a identidade visual da sua marca e que a IA pode ler antes de gerar. A proposta é funcionar como contrato: sem ele, o modelo improvisa. Com ele, o modelo tem de onde partir.

O que a IA não guarda sozinha

Um LLM (sigla em inglês para "modelo de linguagem de grande porte") é o motor por trás de ferramentas como ChatGPT, Claude ou Gemini. Ele foi treinado em enormes volumes de texto e aprendeu a prever a continuação mais provável de uma frase. Isso o torna bom em linguagem. Não o torna bom em lembrar que o botão da sua marca é azul petróleo, e não azul royal.

Aqui vale separar duas coisas que costumam ser confundidas. Um chat comum mantém o histórico daquela conversa: se você definiu o azul na primeira mensagem, ele continua ali na décima. O que não existe é memória entre conversas diferentes. Abra um chat novo e o modelo começa do zero, sem saber nada do que foi combinado antes. E mesmo dentro da mesma conversa, o histórico é contexto acumulado, não uma regra fixa: quanto mais longa a sessão, mais fácil a instrução antiga se diluir no meio de tudo o mais.

Segundo o blog técnico Punkmetrics, LLMs não têm memória visual por padrão e, sem contexto, inventam. A fonte secundária designmd.app descreve o mesmo efeito: a cor do botão muda, a fonte troca entre Inter, Poppins e a fonte padrão do sistema, o espaçamento varia de um componente para o outro.

O design.md entra aí. É um arquivo de texto simples, escrito em Markdown, que descreve a identidade visual de um projeto em formato que agentes de IA conseguem ler e aplicar. Markdown é uma forma de escrever texto com símbolos simples: uma cerquilha cria um título, um asterisco cria uma lista. A extensão .md indica esse tipo de arquivo, suportado por ferramentas comuns, como o Google Docs.

Segundo a designmd.app, o arquivo costuma ter duas partes. Uma é feita de tokens de design, que são valores nomeados, como "cor primária" ou "raio de borda". Pense em etiquetas: cada uma tem um nome fixo e um valor fixo, e a máquina consulta a etiqueta em vez de adivinhar. Esses valores aparecem em YAML, um formato de lista de chave e valor que o computador lê sem ambiguidade. A outra parte são regras em prosa, escritas para humanos: quando usar cada cor, que tom a marca assume, o que evitar. Uma parte fala com a máquina, a outra com a equipe.

Manual de marca, design system e design.md: três contratos, três problemas

Um manual de marca é o documento clássico: logo, paleta, tipografia, tom de voz, tudo reunido para orientar pessoas. Funciona bem quando quem lê é humano e tem tempo de consultar. A proposta do design.md parte de outra premissa: um modelo de linguagem tende a trabalhar melhor com instruções curtas, explícitas e no formato certo do que com um documento longo cheio de intenção implícita.

Um design system é outra coisa. É o conjunto de componentes reutilizáveis, botões, campos, cartões, com regras de uso, normalmente ligado ao código. Serve a quem programa. É excelente para garantir que a interface real seja consistente, mas não foi feito para ser lido por um modelo de linguagem no meio de uma geração de conteúdo.

O design.md ocupa um terceiro lugar. Segundo o blog Dev Genius, ele é apresentado como o elo entre agentes de IA e consistência de interface. A diferença é estrutural: o manual de marca fala com humanos, o design system fala com o código, e o design.md fala com a IA. Por isso a boa prática citada pelo blog camaraux é manter a identidade visual em um documento próprio e fazer o mecanismo de instruções de cada agente apontar para ele.

Isso não substitui os outros dois. Você continua precisando do manual para alinhar pessoas e do design system para alinhar código. O design.md resolve um terceiro problema, mais recente: alinhar a máquina que gera.

Uma ressalva importante: não existe norma única e oficial chamada design.md. Uma fonte secundária afirma que haveria uma especificação mantida pelo Google Labs, mas isso não foi confirmado em fonte primária. A origem também é relatada de forma divergente: o Punkmetrics diz que a ideia surgiu com o Google Stitch, uma plataforma de prototipagem visual. Trate o design.md como convenção prática de mercado, não como padrão formal.

Do site ao post: como o arquivo entra no fluxo de trabalho

O mecanismo proposto é este. Você escreve o design.md uma vez, com as cores, as fontes, os espaçamentos e o tom de voz da marca. Depois, aponta o agente para esse arquivo, seja colando o conteúdo na conversa, seja anexando o arquivo, seja configurando o agente para consultá-lo sempre. A partir daí, o pedido de geração vem acompanhado do contrato: "gere uma página de preços seguindo o design.md". A proposta é que o agente parta dos valores definidos em vez de inventar. O que sobra para você é revisar a saída e corrigir o que escapou.

A Atlassian publicou um relato de testes com um DESIGN.md usado como contexto de design portátil para geração com IA. É um indício de que a abordagem foi experimentada por times reais, ainda que o trecho disponível seja curto demais para conclusões maiores.

Para posts de redes sociais, o princípio seria o mesmo, ainda que as fontes coletadas não documentem esse caso específico. O que importa ali muda um pouco de peso: em uma página de site, espaçamento e componentes pesam mais; em um post, paleta, tipografia e tom de voz carregam quase toda a identidade. Se o arquivo descreve esses três elementos e o agente o consulta antes de gerar, a expectativa é que a peça saia alinhada à marca em vez de aleatória. É uma extensão plausível do mesmo mecanismo, não uma receita testada.

Aqui a promessa precisa ser calibrada. O design.md reduz o desvio, não o elimina. A saída de um LLM varia por natureza: o mesmo pedido pode gerar resultados diferentes, e nenhum arquivo de texto muda isso por completo. Quem espera consistência perfeita vai se frustrar. Quem espera menos improviso, mais acerto.

Existe um segundo limite, mais silencioso. O arquivo só funciona enquanto reflete a marca atual. Se a identidade muda e o design.md fica parado, ele passa a instruir a IA a repetir algo que já não é verdade. Vira um contrato vencido. As fontes coletadas não documentam como as equipes fazem essa manutenção, mas a lógica é difícil de contornar: um contrato desatualizado tende a produzir saída desatualizada.

No fim, o design.md não é sobre design. É sobre dar contexto persistente a uma ferramenta que não carrega a sua marca sozinha. Ele traduz a identidade visual em algo que a máquina consegue ler e reaplicar, e é isso que permite gerar site e conteúdo sem que cada peça pareça de outra marca. Não é mágica, nem norma oficial. É um contrato de texto, e como todo contrato, vale o que está escrito e o quanto ele é mantido em dia.