Um requisito é bom quando todos o leem do mesmo jeito e quem testa consegue comprovar que ele foi cumprido. A norma internacional de requisitos (ISO/IEC/IEEE 29148) lista as características; quatro pegam a maioria dos problemas:
- Inequívoco: um único significado. "Pedidos recentes" significa coisas diferentes para pessoas diferentes; "pedidos dos últimos 90 dias", não.
- Verificável: dá para escrever um teste que passa ou falha. Cuidado com as palavras vagas: rápido, amigável, fácil, flexível, assim que possível, quando apropriado, etc. Cada uma precisa de um número ou de uma regra.
- Único: um requisito de cada vez. "O sistema deverá mandar a etiqueta por e-mail e reembolsar o cliente" são dois; divida, porque podem ser construídos, testados e alterados separadamente.
- Viável e necessário: pode ser construído dentro das restrições, e alguém precisa dele.
Escreva na voz ativa com um sujeito claro: "O sistema deverá..." ou "O gerente da loja pode...". Deixe o desenho de fora ("um botão verde"), a não ser que ele seja mesmo um requisito.
Requisitos vagos e requisitos juntados, reescritos.