Marcus Andrey Estudo
Read in English Biblioteca

IA para UX · Passo 2 · 6 min de leitura

Design systems prontos para IA

As ferramentas de IA agora leem o seu design system para gerar telas e código. O que torna um sistema legível por máquinas e também por pessoas: tokens no formato DTCG, componentes ligados ao código, arquivos estruturados com intenção, regras de uso escritas e conectores como o MCP. Com um checklist para auditar o seu.

O seu design system tem um novo leitor. Quando um designer pede a uma ferramenta de IA "monte esta tela com os nossos componentes", a ferramenta lê os seus arquivos, os seus tokens e a sua documentação, e copia o que encontra, inclusive a bagunça. Um sistema com nomes claros, código ligado e regras escritas é usado do jeito certo. Um que mora na cabeça das pessoas vira chute. Deixar um sistema pronto para IA é, em grande parte, o mesmo trabalho que o deixa bom para pessoas, feito com mais cuidado.

O que você vai conseguir fazer depois de ler:

  • Explicar o que as ferramentas de IA leem de um design system, e como
  • Descrever os tokens no formato DTCG e por que um formato padrão importa
  • Preparar arquivos do Figma, componentes e documentação para a IA usar do jeito certo
  • Auditar o seu próprio sistema com um checklist curto

Produtos e versões são de novembro de 2026; a área muda rápido.


1. O que as ferramentas de IA leem

1Tokens

Decisões nomeadas como dados, com descrições.

JSON no DTCG 2025.10
2Componentes

Ligados ao código real, com variantes e estados.

Code Connect, Storybook
3Arquivos

Componentes, variáveis, auto layout, nomes de verdade.

Nada de "Frame 427"
4Regras

Quando usar, quando não, o que usar no lugar.

Linhas de uso, exemplos
5Conectores

Como as ferramentas de IA chegam a tudo isso.

Servidores MCP, arquivos de contexto
Cinco camadas que uma ferramenta de IA lê do seu design system. Cada lacuna vira um palpite. Diagrama: Marcus Andrey, CC BY 4.0.
Gavetas de madeira de um catálogo de assuntos de biblioteca, cada uma com uma etiqueta impressa; uma gaveta está aberta, cheia de fichas.
Um catálogo de assuntos funciona porque toda gaveta é nomeada do mesmo jeito e toda ficha segue o mesmo formato. Um design system legível por IA precisa da mesma disciplina. Foto: Dr. Marcus Gossler, Wikimedia Commons, CC BY-SA 3.0.

2. Tokens num formato compartilhado (DTCG)

Design tokens são as decisões nomeadas do seu sistema: cores, tipografia, espaçamento, raios de borda. O Design Tokens Community Group do W3C publicou a primeira versão estável do seu formato, a 2025.10, em 28 de outubro de 2025 (anúncio). Os tokens são arquivos JSON (.tokens ou .tokens.json), cada um com um valor, um tipo e uma descrição opcional (formato).

{
  "color": {
    "action": {
      "primary": {
        "$type": "color",
        "$value": "#1F5BD6",
        "$description": "Botões primários e links. Nunca para erros."
      }
    }
  }
}

Repare no rótulo honesto: é um "Final Community Group Report" (relatório final de um Community Group), "not a W3C Standard" (não um padrão do W3C). Mesmo assim, é o formato que a maioria das ferramentas lê e escreve hoje. O $description é onde você diz às pessoas, e às máquinas, como usar o token.


3. Componentes ligados ao código

  • O Figma Code Connect liga cada componente do Figma ao componente real no código, para que as ferramentas de IA e os desenvolvedores vejam o seu código de verdade em vez de um chute (documentação). Ele exige uma licença Dev ou Full num plano Professional, Organization ou Enterprise; o Professional fica limitado a uma biblioteca e um framework.
  • O servidor MCP do Figma (em beta desde junho de 2025) entrega às ferramentas de IA o contexto do seu design, as variáveis e os mapeamentos do Code Connect, e também consegue escrever no canvas (documentação). Veja MCP e IA no Figma.
  • O add-on MCP do Storybook (em preview, primeiro para React, desde março de 2026) permite que agentes leiam os seus componentes e stories documentados (documentação). O shadcn/ui tem um servidor MCP que funciona com qualquer registry de componentes compatível, inclusive os privados (documentação).

4. Arquivos estruturados com intenção

O próprio guia do Figma para um código gerado por IA melhor pede: componentes em vez de camadas soltas, variáveis em vez de valores fixos, nomes de camada com propósito, auto layout e anotações para o comportamento (Figma, Structure your Figma file). Nada disso é novo. A IA só deixa visível, em cada tela gerada, o custo de pular essas etapas.


5. Regras escritas para um leitor que não pode perguntar

  • Uma linha de uso por componente: quando usar, quando não usar e o que usar no lugar.
  • Estados e regras de conteúdo junto do componente: vazio, carregando, erro, texto longo.
  • Um brief do projeto para as ferramentas de IA. O DESIGN.md, do Google Labs, é um formato inicial "for describing a visual identity to coding agents" (para descrever uma identidade visual para agentes de código) (versão alpha, Apache 2.0, GitHub); o AGENTS.md e o CLAUDE.md fazem o mesmo para regras em geral. Veja arquivos de contexto.
  • Exemplos de bom uso, não só o componente isolado.

A maior parte das orientações sobre como escrever documentação para IA ainda vem dos fornecedores das ferramentas (Figma, Storybook). Trate isso como ponto de partida e teste o que funciona com as suas ferramentas.


6. Erros comuns

  • Instâncias desvinculadas (detached) e cores fixas no código: a IA copia.
  • Nomes de camada como "Frame 427".
  • Tokens sem descrição, e aí a IA escolhe pela cor, não pelo significado.
  • Regras de uso só numa apresentação de slides ou na cabeça de alguém.
  • Conectar ferramentas de IA ao sistema antes de arrumá-lo.

7. Vocabulário

Termo Significado
Design token Uma decisão de design nomeada (cor, espaçamento, tipografia) guardada como dado
Formato DTCG O formato da comunidade para tokens, versão estável 2025.10
Code Connect A ligação do Figma entre um componente de design e o código dele
MCP Um jeito padrão de as ferramentas de IA se conectarem a outros apps e dados
Registry Um catálogo compartilhado de componentes de onde as ferramentas podem instalar
Arquivo de contexto Instruções permanentes que uma ferramenta de IA lê em toda sessão

8. Experimente (sem código)

  1. Escolha uma tela e um componente central do seu sistema.
  2. Passe o checklist abaixo neles. Conte as lacunas.
  3. Escreva a linha de uso desse componente: quando usar, quando não usar, o que usar no lugar.
  4. Peça a uma ferramenta de IA que monte uma tela simples com o seu sistema. Anote cada lugar em que ela chutou errado, e qual lacuna causou isso.

Perguntas para refletir: quais regras do seu design system só existem na cabeça das pessoas? O que um designer novo que só pudesse ler erraria primeiro?


9. Se você lidera um time

  • Inclua a legibilidade para IA na definição de pronto do design system: nomes, variáveis, descrições, linhas de uso.
  • Configure o Code Connect (ou o equivalente) primeiro para os componentes mais usados.
  • Revise as telas geradas por IA em busca de desvios do sistema, e corrija a fonte, não só a tela.

Checklist

Para saber mais

Livros, cursos e vídeos para ir mais fundo (em inglês)

Os links dos livros são de afiliado da Amazon: como associado, recebo por compras qualificadas, sem custo a mais para você.

Relacionadas

Especificações de design para IA · IA no Figma · Gerando design com Claude Code · Prototipação com IA · MCP · Arquivos de contexto

Salvo só neste dispositivo.

↑ ↓ para mover · Enter para abrir · Esc para fechar