Design system pronto para IA: guia mostra como levar o código ao Figma com MCP
Aprofundamento CEVIU
Aprofundamento
O guia parte de um problema concreto: o arquivo do Figma é uma abstração, e a IA o trata como instrução completa. A autora comparou o que um componente React consegue expressar com o que um componente Figma expressa e chegou a cerca de 17% de cobertura. Para CSS, o número sobe para uns 45%, ainda longe do total. O que falta (ordem de foco, estados de erro, o que o leitor de tela anuncia, o que acontece quando uma requisição falha ou uma lista vem vazia) não aparece em screenshot, então ninguém pega na revisão.
A saída proposta é inverter o fluxo. O código é a fonte da verdade e o Figma espelha. O passo a passo usa um repositório com Storybook, um arquivo Figma vazio e o Figma Console MCP, que lê e grava variáveis direito. Primeiro vêm tokens e estilos de texto, depois dois componentes de teste (por exemplo Button e Alert). Cada elemento leva seu contexto junto: nome idêntico nos dois lados, propriedades com valores e defaults, descrição e link para o Storybook. O que não cabe no Figma vai para um arquivo GAPS.md, que vira lista revisável para levar ao dev. Para manter a paridade, um checker compara o manifest do Storybook com uma lista equivalente extraída do Figma: verde onde bate, vermelho onde divergiu.
O que mudou
O tema já vinha sendo coberto. Em 27 de abril de 2026, o CEVIU noticiou "Aprendendo Design Systems Agentic", com um experimento que usava o Figma Console MCP para gerar componentes Figma a partir de código, mantendo tokens sincronizados. Em 17 de agosto de 2026, "Alinhando o Design: Combatendo a Deriva em Design Systems com Estratégia e IA" tratou do descompasso entre Figma e produto. Agora o guia entrega um fluxo completo e repetível, com o código como fonte da verdade, o GAPS.md e uma checagem de paridade automatizada para atacar essa deriva.
Por que isso importa
Para quem trabalha com design system, a leitura é que o gargalo deixou de ser desenhar o componente e passou a ser documentar o que o Figma não mostra. Acessibilidade e tratamento de falhas ficam no código, e um espelho com lacunas declaradas é mais seguro do que uma fonte que parece completa. Para o usuário final, a consequência prática é menos comportamento inventado pela IA em foco, leitor de tela e estados de erro.
Linha do tempo
CEVIU noticia que design systems falham quando arquivos de design e código falam linguagens distintas.
Experimento com Figma Console MCP gera componentes Figma a partir de código e mantém tokens sincronizados.
Matéria sobre como tornar o design system compatível com IA trata decisões de design como infraestrutura.
CEVIU aborda por que regras em texto não funcionam e propõe práticas incorporadas ao código.
Matéria sobre deriva em design systems explica o descompasso entre Figma e produto final.
Figma apresenta Workflow Lab com servidor MCP e Code Connect para agentes de IA.
Guia mostra como levar o código ao Figma com MCP, com o código como fonte da verdade.
Perguntas frequentes
Por que o Figma-para-código com IA falha?
O arquivo do Figma é uma abstração e cobre só parte do que o código expressa. Na comparação da autora, foram cerca de 17% para componentes React e 45% para CSS. A IA lê o arquivo como instrução completa e preenche o resto com o que parece plausível, como ordem de foco e estados de erro.
O que significa tratar o código como fonte da verdade?
Significa que o Figma espelha o repositório, e onde os dois divergem, o Figma está errado. Os designers continuam desenhando no canvas. A biblioteca do Figma, porém, é gerada a partir de tokens, propriedades, variantes e estados reais do código.
Para que serve o GAPS.md?
É um arquivo em que a IA lista tudo o que não conseguiu expressar no Figma, o que ficou incerto e o que o designer deve conferir à mão. Entre os exemplos estão line heights sem unidade no código, que viram pixels no Figma, e estados que só existem em comportamento. A lista pode ser levada ao desenvolvimento para revisão.
Preciso saber programar para seguir esse fluxo?
Não precisa escrever código de produção, mas precisa se sentir à vontade para abrir um repositório e ler o que há nele. A IA conduz o resto. Convém trabalhar em uma cópia segura, como uma branch ou sandbox, onde nada chega à produção.
Fontes
- christinevallaure.substack.comfonte original
- Categoria
- CEVIU Design
- Publicado
- 30 de outubro de 2026
- Editoria
- CEVIU Design

