Pontuação VibeSpec 20: linguagem ambígua
A pontuação 20 indica que a exigência usa termos vagos ou que podem ser interpretados de várias formas. Ambiguidades levam a implementações inconsistentes e à confusão das equipes.
Exemplos de exigências
- “O app deve abrir rapidamente em condições normais.”
- Interpretação do gerente de projeto: “rapidamente” significa menos de um segundo.
- Interpretação do desenvolvedor: pode ser até cinco segundos.
- Correção: “O app deve abrir em até dois segundos em hardware padrão.”
- “A interface deve ser intuitiva para o usuário médio.”
- Interpretação do designer: exige pouca ou nenhuma capacitação.
- Interpretação do testador: precisa de métricas de usabilidade definidas.
- Correção: “Usuários devem concluir o onboarding em menos de três minutos sem manual.”
- “O sistema deve lidar com grandes volumes de dados sem problemas.”
- Interpretação do engenheiro de dados: pensa em gigabytes.
- Interpretação do analista: pode significar dezenas de terabytes.
- Correção: “O sistema deve processar conjuntos de até 10 GB com tempo de resposta abaixo de cinco segundos.”
Como o VibeSpec detecta e explica
O VibeSpec destaca expressões como “rapidamente” ou “grande” e explica por que elas carecem de critérios mensuráveis. A orientação incentiva a substituí-las por limites específicos ou definições claras.
Por que as interpretações diferem
Um gerente pode achar que “rapidamente” significa menos de um segundo, enquanto o desenvolvedor considera cinco segundos aceitável. “Grandes volumes” pode significar gigabytes para um engenheiro e terabytes para outro. Ao mostrar essas diferenças, o VibeSpec incentiva a definição de métricas claras.
Saiba mais em nossa introdução ao VibeSpec.
