Marcus Andrey Estudo
Read in English Biblioteca

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.

  1. 1Requisitos

    Usuários, fluxos, estados, regras e critérios de aceite. UX é dono da experiência.

    "O que o usuário precisa conseguir fazer?"
  2. 2Design

    Como é construído: componentes, tokens, dados e decisões de arquitetura.

    "Quais componentes e quais dados?"
  3. 3Tarefas

    Passos pequenos e verificáveis que um agente consegue implementar um a um.

    "Qual é o próximo passo?"
  4. 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.

O desenvolvimento guiado por especificação transforma especificações escritas em trabalho de agentes, com revisão humana entre cada etapa.

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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
-
Fonte
GitHub Spec Kit, AWS Kiro
Salvo só neste dispositivo.

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