Pontuação VibeSpec 25: redação negativa
A pontuação 25 se aplica quando as exigências são escritas no formato “não faça”. Embora tecnicamente corretas, as frases negativas muitas vezes escondem o que o sistema deve realmente realizar.
Exemplos de exigências
- “A interface não deve confundir o operador.”
- Interpretação do desenvolvedor: um layout básico já serve desde que sem erros graves.
- Interpretação do testador: a interface deve ser autoexplicativa para iniciantes.
- Correção: “Projetar a interface para que os operadores concluam tarefas comuns sem ajuda externa.”
- “O processo não deve demorar muito.”
- Interpretação do desenvolvedor: um ou dois minutos podem ser aceitáveis.
- Interpretação do gerente: espera resultados quase instantâneos.
- Correção: “O processo deve terminar em até 30 segundos para cargas normais.”
- “Os logs não devem ser difíceis de ler.”
- Interpretação do desenvolvedor: formatação mínima é suficiente.
- Interpretação do suporte: precisa de timestamps claros e níveis de erro.
- Correção: “Fornecer logs estruturados com timestamps e níveis de severidade.”
Como o VibeSpec detecta e explica
O VibeSpec incentiva transformar frases negativas em positivas. Descrever o comportamento esperado facilita a validação e remove dúvidas sobre casos extremos.
Por que as interpretações diferem
Um desenvolvedor pode entender “não demorar muito” como menos de um minuto, enquanto um testador espera alguns segundos. De modo similar, o que parece “não confuso” para um especialista pode confundir um novato. Destacar essas visões ajuda a equipe a reformular em termos claros.
Saiba mais em nossa introdução ao VibeSpec.
