IA para UX · Passo 2 · 7 min de leitura
Especificações de design para IA
Por que a especificação escrita vira o artefato de design mais importante quando a IA desenha telas em segundos: as três camadas de contexto, um modelo de especificação pronto para IA com um exemplo completo, os novos arquivos de contexto (AGENTS.md, DESIGN.md), e o lugar do design no desenvolvimento guiado por especificação.
Quando a IA gera uma tela em segundos, a tela deixa de ser a parte difícil. A parte difícil é saber o que a tela deve fazer: para quem, em quais situações, com quais regras. Esse conhecimento mora na especificação. Uma boa especificação é o que faz o resultado da IA ser seu e não genérico, e é dela que tanto as pessoas quanto os agentes de IA partem para trabalhar.
O que você vai conseguir fazer depois de ler:
- Explicar por que as especificações importam mais, e não menos, quando a IA gera designs
- Diferenciar as três camadas de contexto: produto, funcionalidade e tarefa
- Escrever uma especificação de funcionalidade pronta para IA, com estados, regras e critérios de aceite
- Reconhecer os novos arquivos de contexto (
AGENTS.md,DESIGN.md) e as ferramentas guiadas por especificação que os engenheiros usam
1. Por que as especificações importam mais agora
- Entra vago, sai genérico. "Faça um dashboard de reservas" gera o dashboard médio da internet. Uma especificação que nomeia os usuários, as tarefas, os estados, os dados e os componentes gera o seu dashboard.
- Uma especificação, muitos usos. O mesmo documento alimenta um protótipo no Figma, um protótipo em código, o ticket de engenharia e o checklist de testes.
- Você só consegue revisar com base em algo escrito. Sem especificação, "isto está certo?" vira uma questão de gosto.
- Agentes seguem documentos. Os agentes de IA que constroem software partem cada vez mais de especificações escritas. Se o design não escreve a parte da experiência, o agente inventa.
2. Três camadas de contexto
Regras estáveis que toda sessão lê: usuários, princípios, tokens, componentes, regras do tipo "nunca".
Em geral: CLAUDE.md, AGENTS.md, DESIGN.mdO que este recurso precisa fazer: problema, usuários, fluxos, estados, regras, critérios de aceite.
Em geral: uma especificação na wiki ou no repositórioO pedido desta iteração, dentro da conversa com a ferramenta.
Em geral: "Mostre três opções"Muda raramente → muda a cada recurso → muda a cada iteração
A maior parte dos resultados ruins de IA vem de uma camada 1 ou 2 que falta, não de um prompt mal escrito. Veja arquivos de contexto e Padrões de prompt para designers.
Os novos arquivos de contexto
| Arquivo | O que é | Situação (nov 2026) |
|---|---|---|
AGENTS.md |
Um arquivo Markdown simples num repositório de código que explica a qualquer agente de código como o projeto funciona | Formato aberto, mantido pela Agentic AI Foundation, dentro da Linux Foundation (agents.md) |
DESIGN.md |
Um arquivo que descreve uma identidade visual para agentes de código: tokens em YAML mais o raciocínio em Markdown | Do Google Labs; ainda um formato alpha, "expect changes" (espere mudanças) (repositório) |
CLAUDE.md |
As instruções de projeto do Claude Code, lidas no começo de cada sessão | Recurso do produto (documentação) |
| Design tokens (DTCG) | Um formato JSON compartilhado para cores, espaçamento, tipografia | Primeira versão estável em out 2025; um relatório de um Community Group do W3C, não um padrão do W3C (especificação) |
Você não precisa de todos. Um arquivo bem cuidado com os seus princípios, componentes e regras de "nunca faça" já muda o resultado.
3. Um modelo de especificação de funcionalidade pronto para IA
# Funcionalidade: <nome>
## Problema
O que está errado hoje, para quem, com evidências (pesquisa, tickets de suporte, analytics).
## Usuários e contexto
Papéis, nível de experiência, ambiente (mesa, em movimento, lugar barulhento), com que frequência usam.
## Jobs to be done
Quando <situação>, eu quero <ação>, para que eu possa <resultado>.
## Métricas de sucesso
Sucesso na tarefa, tempo na tarefa, taxa de erro, satisfação.
## Escopo
Dentro: … Fora: …
## Fluxo
O caminho principal passo a passo, mais as alternativas principais.
## Estados
Vazio · carregando · parcial · erro · sem permissão · offline · dados muito grandes
## Regras e lógica
Validação, permissões, valores padrão, ordenação, regras de negócio.
## Dados
Campos, formatos, exemplos realistas e anonimizados, tamanhos máximos, idiomas.
## Design system
Componentes a usar (nomes como na biblioteca), padrões, tokens. Precisa de componentes novos?
## Acessibilidade
Navegação por teclado, ordem de foco, rótulos, contraste, movimento (WCAG 2.2 AA).
## Critérios de aceite
Dado / Quando / Então, testáveis.
## Perguntas em aberto
…
As seções que a IA mais erra quando elas faltam: estados, regras e dados. Se o tempo estiver curto, escreva essas primeiro.
4. Exemplo completo (fictício)
Um app de reservas para centros esportivos comunitários. Os sócios continuam sem perceber que a reserva deles foi cancelada por causa de manutenção.
Problema: sócios chegam a quadras que estavam fechadas para manutenção. O suporte recebe cerca de 40 reclamações por mês dizendo "ninguém me avisou". Usuários: sócios no celular, muitas vezes a caminho do centro; funcionários que fecham quadras pela ferramenta de administração. Job: quando uma quadra que eu reservei é fechada, eu quero saber na hora e receber uma alternativa, para não perder a viagem. Estados: nenhuma reserva afetada · uma reserva afetada · várias reservas afetadas · fechamento anunciado menos de uma hora antes (urgente) · sócio offline (notificação na fila). Regras: oferecer primeiro o horário livre mais próximo no mesmo centro; nunca remarcar automaticamente sem a confirmação do sócio. Design system:
Banner(variante urgente),BookingCard,Button. Nenhum componente novo. Aceite: dado uma reserva numa quadra fechada, quando o sócio abre o app, então um banner no topo mostra o fechamento e o horário alternativo, com "Aceitar" e "Escolher outro horário".
Uma especificação assim gera resultados úteis no Figma Make, no Claude ou num agente de código. "Deixe os cancelamentos mais claros" não gera.
5. Desenvolvimento guiado por especificação
A engenharia está indo na mesma direção. Ferramentas guiadas por especificação organizam o trabalho como documentos que os agentes seguem:
- GitHub Spec Kit: constitution → specify → plan → tasks → implement, agora seguido de uma etapa "converge", que coloca o código e a especificação de novo em sintonia.
- Kiro:
requirements.md→design.md→ tarefas (e umbugfix.mdpara correções).
- 1Especificação de design
Usuários, fluxos, estados, regras, acessibilidade.
Responsabilidade do design - 2Especificação de engenharia
Arquitetura, dados, tarefas.
Responsabilidade da engenharia - 3O agente constrói
Código que segue os dois documentos.
Revisado por pessoas
Veja desenvolvimento guiado por especificação.
A oportunidade para o design: quando a engenharia trabalha a partir de especificações, a especificação de design vira uma entrada da especificação de engenharia. Garanta que o design é dono das seções de experiência (fluxos, estados, regras, acessibilidade), em vez de deixar um agente inventá-las.
6. Erros comuns
| Erro | Melhor |
|---|---|
| Uma especificação que é só capturas de tela | Telas mais as regras e os estados por trás delas |
| "Tratar erros com elegância" | Liste cada erro e o que o usuário vê e pode fazer |
| Dados falsos como "Lorem ipsum" ou "Usuário 1" | Exemplos realistas e anonimizados, incluindo nomes longos e casos extremos |
| Inventar componentes na especificação | Use os nomes dos componentes da biblioteca; marque um que falta como pergunta em aberto |
| Escrever a especificação depois do design | Escreva primeiro o problema, os usuários, os estados e as regras; eles guiam o design |
7. Experimente (sem código)
- Escolha uma funcionalidade em que você trabalhou há pouco tempo.
- Preencha só quatro seções do modelo: Usuários, Estados, Regras, Critérios de aceite.
- Entregue a especificação a qualquer ferramenta de IA aprovada e peça: "Desenhe a tela principal para esta especificação. Depois liste tudo o que estiver confuso ou contraditório na especificação."
- Leia a lista de pontos confusos. Um engenheiro teria feito as mesmas perguntas?
Perguntas para refletir: qual seção costuma faltar nas suas especificações? Quem no seu time perceberia se um agente inventasse uma regra de negócio?
8. Se você lidera um time
- Combinem um modelo de especificação do time e um checklist curto de "pronto para IA" (usuários, estados, regras, dados, componentes).
- Crie um arquivo de contexto de design para o seu design system: princípios, tokens, componentes, o que fazer e o que não fazer.
- Façam críticas de especificação: revisem a especificação, não só as telas. Veja Crítica de design.
- Junte cada especificação a uma medida de sucesso, para o trabalho feito com ajuda de IA ser avaliado pelos resultados.
Checklist
Para saber mais
- NN/g: Prompt to Design Interfaces: Why Vague Prompts Fail and How to Fix Them · UX-Context Design · Context Libraries
- Formatos: AGENTS.md · DESIGN.md · Design Tokens Format 2025.10
Livros, cursos e vídeos para ir mais fundo (em inglês)
Relacionadas
Padrões de prompt para designers · Prototipação com IA · Gerando design com Claude Code · IA no Figma · arquivos de contexto · desenvolvimento guiado por especificação · Processo de revisão de design com IA