01
Contrato primeiro
4 HEspecificação da API escrita e revisada antes de existir implementação. Quem consome participa dessa conversa.
Passos da etapa · sprint de uma semana
- Escreva o contrato completo do que será exposto/consumido: campos, tipos, códigos, exemplos
- Revise o contrato COM o consumidor (pessoa ou sistema) antes de qualquer implementação
- Versione o contrato junto da spec; mudança de contrato = decisão registrada
- Gere validação automática a partir do contrato
Critério de aceite
O consumidor aprova o contrato por escrito antes da primeira linha, e a validação da borda deriva DELE.
A armadilha clássica
Implementar primeiro e "documentar depois": o contrato vira descrição do acidente, não acordo.
Entregável que fecha a etapa: Contrato aprovado pelo consumidor