Escrevendo requisitos claros
Capítulo 3: Técnicas para comunicação cristalina
Escreva como um profissional: requisitos claros e práticos
A Estrutura SMART
Cada requisito deve ser:
- Específico: Sem ambigüidade sobre o que é necessário
- Mensurável: Critérios claros para conclusão
- Alcançável: Tecnicamente viável com os recursos disponíveis
- Relevante: Apoia diretamente os objetivos de negócios
- Testável: Pode ser verificado quando concluído
O que fazer e o que não fazer
FAZER
Usar voz ativa:
"O sistema enviará um e-mail quando o estoque atingir o nível mínimo"
NÃO
Use voz passiva:
"Um e-mail deve ser enviado quando os níveis mínimos forem atingidos"
FAZER
Seja específico com números:
"O tempo de resposta deve ser inferior a 2 segundos para 95% das consultas"
NÃO
Use termos vagos:
“O sistema deve ser rápido”
FAZER
Defina os termos:
“Cliente ativo: qualquer cliente com compra nos últimos 90 dias”
NÃO
Suponha que você entenda:
"Mostrar clientes ativos" (O que torna um cliente ativo?)
Palavras poderosas para requisitos
Use estas palavras de ação:
- Calcular, Validar, Gerar
- Exibir, ocultar, ativar, desativar
- Criar, atualizar, excluir, arquivar
- Enviar, receber, processar, armazenar
- Autenticar, autorizar, registrar
Evite estes termos vagos:
- "Fácil de usar" (seja específico)
- "Flexível" (defina a flexibilidade)
- "Intuitivo" (descreva o fluxo)
- "Robusto" (especifique o tratamento de erros)
- "Etc." (listar tudo)
O formato da história do usuário
Como [tipo de usuário], quero [ação], para que [benefício]
Exemplos:
- "Como gerente de armazém, quero ver alertas de estoque baixo em meu painel, para poder fazer novos pedidos antes de rupturas de estoque"
- "Como representante de vendas, quero verificar o estoque em tempo real durante as ligações, para poder prometer datas de entrega precisas"
- "Como contador, quero relatórios automatizados de avaliação de ações, para poder fechar os livros mais rapidamente a cada mês"
Modelo de critérios de aceitação
Dado [contexto inicial]
Quando [a ação ocorre]
Então [resultado esperado]
Exemplo:
Dado um produto com estoque mínimo de 50 unidades
Quando a quantidade disponível cai para 50 ou menos
Em seguida, o sistema envia um e-mail ao gerente do armazém em 5 minutos