DESIGN.md da Atlassian: promissor para prototipagem, mas com custo alto em tokens e variância
Aprofundamento CEVIU
Aprofundamento
O DESIGN.md não é um sistema de design, é um atalho para fazer IA enxergar sua identidade visual em ambientes onde você não controla a infraestrutura. Ele traduz princípios de marca (cores, tipografia, elevação) e regras de componentes em Markdown legível por humanos *e* agentes, mas com um trade-off claro: troca precisão técnica por portabilidade. Em vez de ensinar o agente a usar seu Button já testado no Storybook, ele descreve como recriar um botão do zero, o que gera código duplicado, inconsistências sutis e maior risco de acessibilidade falhar.
Isso explica por que funciona bem em protótipos rápidos no Figma Make ou em dashboards gerados sob demanda para clientes: lá, não há biblioteca pré-existente para consumir. Mas em produção, onde cada componente tem variantes, estados, suporte a modo escuro nativo e testes automatizados, carregar 19.800 tokens de contexto estático vira gargalo, especialmente quando seu MCP server entrega exatamente o que o agente precisa, no momento certo, com menos de 5% do custo.
Por que isso importa
Designers e devs estão cansados de corrigir 'slop' manualmente, interfaces genéricas que parecem feitas por quem nunca viu seu Figma. O DESIGN.md tenta resolver isso sem exigir integração profunda com sua stack, mas revela uma tensão central no design assistido por IA: quanto de sua disciplina você quer externalizar para o prompt? Se você prioriza consistência, manutenção e acessibilidade, mantenha o agente ligado ao seu sistema real, não à sua versão resumida em Markdown. Se prioriza velocidade de experimentação ou personalização por cliente, o DESIGN.md é um ativo válido, desde que tratado como ponte, não como destino.
Perguntas frequentes
O DESIGN.md substitui meu sistema de design atual?
Não. Ele não contém código, componentes reais, testes ou linters. É um resumo descritivo, útil para guiar IA em ambientes externos, mas incapaz de garantir consistência técnica ou acessibilidade em produção.
Quando vale a pena usar DESIGN.md em vez de um MCP server?
Em três cenários: prototipagem rápida com ferramentas externas (como Figma Make), geração de relatórios temáticos por clientes e integração com ferramentas de design que não suportam chamadas a servidores. Em qualquer fluxo com código base existente, o MCP é mais eficiente e seguro.
Por que o DESIGN.md consome mais tokens que um MCP?
Porque carrega todo o contexto de uma vez, mesmo partes irrelevantes para a tarefa. Um MCP busca só o necessário (ex: regras de Alert) via chamada específica, evitando truncamento e desperdício de contexto.
Posso usar DESIGN.md para garantir acessibilidade?
Não diretamente. Ele pode listar cores contrastantes ou tamanhos mínimos de texto, mas não valida se o agente gerou ARIA corretamente ou se o foco segue a ordem lógica. Isso exige linters, testes automatizados e componentes validados, coisas que o formato não inclui.
Fontes
- atlassian.comfonte original
- Categoria
- CEVIU Design
- Publicado
- 22 de junho de 2026
- Editoria
- CEVIU Design

