Marcus Andrey Estudo
Read in English Biblioteca

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.
Uma planta de arquitetura com a fachada de uma casa de dois andares, com chaminé e janelas com venezianas.
Quem constrói trabalha a partir da planta, não de um desejo. Uma especificação faz o mesmo pela IA: quanto mais ela diz, menos a máquina precisa adivinhar. Desenho: Alice Trythall Washburn, Wikimedia Commons, domínio público.

2. Três camadas de contexto

1Arquivo 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.md
2Especificação do recurso

O 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ório
3Prompt da tarefa

O 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

Três camadas de contexto para o trabalho com IA; o arquivo de contexto é a camada que define os seus padrões para toda sessã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 um bugfix.md para correções).
  1. 1Especificação de design

    Usuários, fluxos, estados, regras, acessibilidade.

    Responsabilidade do design
  2. 2Especificação de engenharia

    Arquitetura, dados, tarefas.

    Responsabilidade da engenharia
  3. 3O agente constrói

    Código que segue os dois documentos.

    Revisado por pessoas
No desenvolvimento guiado por especificação, a especificação de design alimenta a de engenharia. Se o design não escreve a parte da experiência, um agente inventa. Diagrama: Marcus Andrey, CC BY 4.0.

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)

  1. Escolha uma funcionalidade em que você trabalhou há pouco tempo.
  2. Preencha só quatro seções do modelo: Usuários, Estados, Regras, Critérios de aceite.
  3. 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."
  4. 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

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

Salvo só neste dispositivo.

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