Framework · IA e design · 4 min de leitura
Desenvolvimento guiado por especificação
Um jeito de trabalhar em que todo recurso começa de especificações escritas (requisitos, depois design, depois tarefas) que pessoas revisam e agentes implementam, para que UX seja dono da experiência antes de qualquer código ser gerado.
- 1Requisitos
Usuários, fluxos, estados, regras e critérios de aceite. UX é dono da experiência.
"O que o usuário precisa conseguir fazer?" - 2Design
Como é construído: componentes, tokens, dados e decisões de arquitetura.
"Quais componentes e quais dados?" - 3Tarefas
Passos pequenos e verificáveis que um agente consegue implementar um a um.
"Qual é o próximo passo?" - 4Implementar
Os agentes geram o código; pessoas revisam contra a especificação.
"Bate com a especificação?"
Pessoas revisam cada especificação antes da geração. Quando o comportamento muda, atualize a especificação primeiro.
Use quando
- A engenharia começa a usar uma ferramenta guiada por especificação e pede ao design "os requisitos" num formato estruturado.
- Os recursos gerados por IA continuam deixando de fora estados, casos extremos ou necessidades de acessibilidade que o designer conhecia.
- Você quer que as decisões de design vivam junto do código, versionadas e revisáveis, e não só num arquivo de design.
Como usar
- Aprenda o fluxo da engenharia. Descubra que estrutura os seus engenheiros usam. As mais comuns vão de requisitos para design e para tarefas, por exemplo o GitHub Spec Kit (constitution, specify, plan, tasks, implement) e o AWS Kiro (
requirements.md,design.md, tarefas). Resultado: os arquivos e etapas de especificação que o seu time usa. - Assuma as seções de experiência. Combine com a engenharia que UX é dono de usuários, fluxos, estados, regras, dados exibidos, acessibilidade e critérios de aceite da experiência. A especificação de UX vira uma entrada da especificação de engenharia. Resultado: um dono com nome para cada seção da especificação.
- Escreva a especificação a partir da sua especificação de design. Use o modelo de especificação pronto para IA do seu time (veja especificações de design para IA) e cite componentes e tokens do design system pelo nome. Deixe as regras estáveis nos arquivos de contexto. Resultado: uma seção de experiência revisada na especificação.
- Revise a especificação antes da geração. Faça uma revisão curta da especificação com o PM e um engenheiro: todos os estados estão cobertos, todas as regras estão claras, todas as questões em aberto estão listadas? Trate isso como a "Definition of Ready" (definição de pronto para começar) da geração por IA. Resultado: uma especificação aprovada, com as questões em aberto resolvidas ou marcadas.
- Mantenha a especificação e o código juntos. Versione a especificação no repositório junto com o código. Quando o comportamento mudar, atualize primeiro a especificação e depois gere de novo ou ajuste. Confira o resultado contra a especificação no QA de design. Resultado: uma especificação que ainda bate com o recurso entregue.
Exemplo prático
Uma plataforma interna de operações com 6 times de produto. A engenharia do time de faturamento adota uma ferramenta guiada por especificação. A primeira tela de "exceções de fatura" construída pelo agente funciona, mas não tem estado vazio, nem suporte a teclado, e inventa os próprios rótulos de status.
| Seção da especificação | Antes | Depois que o designer assume |
|---|---|---|
| Usuários | "Usuários do faturamento" | Assistentes de faturamento que resolvem mais de 100 exceções por dia, quase sempre pelo teclado |
| Estados | Não escrito | Vazio, carregando, erro, 5.000 linhas, falha parcial |
| Regras | Não escrito | Exceções com mais de 5 dias são sinalizadas; só líderes podem dar baixa em valores |
| Design system | Não escrito | Tabela de dados, badge de status e barra de ações em lote da biblioteca; só tokens de status |
| Acessibilidade | Não escrito | WCAG 2.2 AA, foco visível, nenhum status só por cor |
| Critérios de aceite | "Mostra exceções" | O assistente consegue filtrar, selecionar e resolver 20 exceções sem mouse |
A segunda versão gerada precisa de muito menos comentários de revisão, e a revisão da especificação leva 20 minutos em vez de várias rodadas de QA de design.
Cuidado com
- Deixar o agente escrever a experiência. Se a especificação diz só "mostrar exceções", o agente decide o fluxo, os estados e o texto. Escreva essas seções você mesmo.
- Revisar código em vez de especificações. Corrigir comportamento no código gerado é mais lento que corrigir uma linha na especificação. Revise a especificação primeiro.
- Especificações que se desatualizam. Uma especificação que não é atualizada quando o recurso muda engana a próxima execução do agente. Versione junto com o código.
- Especificações que parecem completas mas não são verdadeiras. A IA consegue rascunhar uma especificação caprichada e cheia de suposições. Uma pessoa confere cada regra contra o que os usuários realmente precisam.
Modelo
Copie isto para a parte de experiência da sua especificação (por exemplo um requirements.md ou um arquivo de especificação no repositório).
## Experiência (dono: UX) Dono: Revisado em:
### Usuários e contexto
- Quem, com que frequência, em que situação, com que experiência
### Fluxo
1.
2.
### Estados
- Vazio / Carregando / Erro / Muitos dados / Falha parcial / Sem permissão
### Regras
- Regras de negócio e de interação, política para casos extremos
### Design system
- Componentes (nomes na biblioteca):
- Tokens:
- Precisa de componentes novos? -> processo de contribuição
### Acessibilidade
- WCAG 2.2 AA; teclado; foco; nenhum status só por cor
### Critérios de aceite (experiência)
- [ ]
- [ ]
### Questões em aberto
-