DESIGN.md em 2026: o arquivo que eu entrego para a IA não sair da sua marca

DESIGN.md é um arquivo de texto simples, em Markdown, que descreve as regras visuais de uma marca (cores, tipografia, espaçamento, componentes e tom) para que agentes de IA gerem telas e peças dentro da identidade, sem precisar receber tudo de novo a cada prompt. Em 2026 ele virou o formato mais prático para isso, e aqui no Studio Seu eu passei a entregar um DESIGN.md junto com toda identidade visual e todo site.

Neste texto eu conto o que é o formato, o que eu coloco dentro, onde ele funciona e onde ele ainda não resolve.

O que é o DESIGN.md e por que ele apareceu em 2026

O formato ganhou força quando o Google relançou o Stitch como uma tela de design nativa de IA, em março de 2026, e trouxe junto o DESIGN.md. Em abril o Google abriu a especificação, e em poucas semanas surgiram repositórios públicos como o awesome-design-md, que reúne arquivos no estilo de sistemas de marcas conhecidas e passou de 11 mil estrelas no GitHub em maio.

A ideia é simples: o agente lê o arquivo na raiz do projeto e passa a usar a sua cor primária e a sua escala tipográfica, em vez de inventar um azul genérico e uma Inter qualquer. É o mesmo raciocínio de outros dois arquivos que já viraram padrão: o AGENTS.md, que diz ao agente como trabalhar no código, e o SKILL.md, que ensina uma tarefa específica. O DESIGN.md é a terceira camada: diz como as coisas devem parecer.

Por que isso importa para quem contrata design

O relatório State of the Designer 2026, do Figma, aponta que 72% dos designers já usam IA generativa no fluxo de trabalho. Do lado do cliente, eu vejo o mesmo: a equipe de marketing gera landing pages no Lovable, o time de produto prototipa no Claude Code, alguém monta apresentação com IA. Sem um arquivo de referência, cada ferramenta interpreta a marca de um jeito, e em três meses a identidade que eu entreguei vira cinco identidades parecidas.

O que eu coloco dentro de um DESIGN.md

Na minha experiência, o erro mais comum é tratar o DESIGN.md como uma cópia do manual de marca em PDF. Não é. Um agente não precisa da história do logo, precisa de regras que ele consiga aplicar. O meu modelo tem sete blocos:

• Princípios em uma frase cada: por exemplo, "muito respiro, pouca cor, a cor de destaque aparece só em ação".
• Cores com função: não só o código, mas onde cada uma pode e não pode aparecer, e as combinações de contraste aprovadas.
• Tipografia: famílias, pesos, escala e altura de linha, com o uso de cada nível (título de página, subtítulo, corpo, legenda).
• Espaçamento e grid: a escala de espaçamento e as larguras máximas de leitura.
• Componentes: como são botões, cards, formulários e estados (hover, foco, erro, desabilitado).
• Voz e microtexto: como a marca escreve botões, mensagens de erro e confirmações.
• O que nunca fazer: a seção que mais funciona. Gradiente no logo, sombra pesada, emoji em título, fotos de banco genéricas.

Eu escrevo tudo no imperativo e com exemplos curtos. Frase vaga como "a marca é moderna e acolhedora" não muda nada no resultado de um agente. Frase como "cantos com raio de 12px em cards e 999px em botões" muda.

DESIGN.md não substitui os tokens

Aqui no Studio Seu eu continuo mantendo os design tokens como fonte oficial dos valores. O DESIGN.md referencia esses tokens e explica quando usar cada um. Os tokens dizem "o quê", o DESIGN.md diz "quando e por quê". Quando um valor muda, eu mudo o token e reviso o texto: como é arquivo de texto versionado no Git, a mudança aparece como diferença numa revisão, e ninguém fica usando um PDF antigo.

Onde o DESIGN.md funciona e onde ainda falha

Nos testes que fiz este ano com Stitch, Claude Code e Lovable, a diferença é clara em três pontos: paleta, tipografia e espaçamento saem certos quase sempre. Os componentes melhoram bastante. O que ainda falha é o que depende de olho: hierarquia de uma página inteira, ritmo entre seções, escolha de imagem, o momento de quebrar a regra de propósito.

Por isso eu não vendo o DESIGN.md como "o fim do designer". Ele é um corrimão. Ele segura a qualidade mínima quando alguém do cliente gera uma peça sozinho numa sexta à tarde. A direção de arte continua sendo trabalho humano, e é exatamente aí que eu quero gastar o meu tempo.

Como eu entrego para o cliente

• Um DESIGN.md na raiz do repositório do site.
• A mesma versão numa pasta compartilhada, para quem usa ferramentas sem repositório.
• Um teste de aceite: eu peço a três ferramentas diferentes a mesma tela e comparo. Se alguma sair fora da marca, o arquivo precisa de ajuste, não a ferramenta.
• Uma revisão a cada seis meses, junto com a revisão dos tokens.

Perguntas frequentes

O que é DESIGN.md?

É um arquivo Markdown que descreve as regras visuais de uma marca (cores, tipografia, espaçamento, componentes e voz) para agentes de IA gerarem interfaces e peças coerentes com a identidade.

DESIGN.md substitui o manual de marca?

Não. O manual explica a marca para pessoas. O DESIGN.md traduz as regras aplicáveis para máquinas. Eu entrego os dois, e o DESIGN.md aponta para os tokens como fonte dos valores.

Quais ferramentas leem DESIGN.md?

O Google Stitch trouxe o formato em 2026, e agentes de código como Claude Code e Codex, além de construtores como o Lovable, usam o arquivo quando ele está na raiz do projeto ou é anexado como contexto.

Uma empresa pequena precisa de um DESIGN.md?

Se alguém na empresa usa IA para gerar telas, posts ou apresentações, sim. Um arquivo de duas páginas já evita a maior parte das peças fora da marca.

Conclusão

Eu passei anos entregando manuais que ninguém abria. O DESIGN.md é o primeiro formato em que a regra da marca é lida toda vez, porque quem lê é a máquina que está produzindo a peça. Para mim, ele virou parte do que significa entregar uma identidade em 2026. Se você quer que a sua marca continue sendo ela mesma quando a sua equipe começa a produzir com IA, fale comigo aqui no Studio Seu: montar esse arquivo é uma das partes do trabalho que eu mais gosto de fazer.