Escribir requisitos claros
Capítulo 3: Técnicas para una comunicación nítida
Escriba como un profesional: requisitos claros y prácticos
El marco SMART
Cada requisito debe ser:
- Específico: No hay ambigüedad sobre lo que se necesita
- Mensurable: Criterios claros para completar
- Realizable: Técnicamente factible con los recursos disponibles.
- Importante: Apoya directamente los objetivos comerciales
- Comprobable: Se puede verificar cuando esté completo.
Qué hacer y qué no hacer
HACER
Utilice voz activa:
"El sistema enviará un correo electrónico cuando el inventario alcance el nivel mínimo"
NO
Usa voz pasiva:
"Se debe enviar un correo electrónico cuando se alcancen los niveles mínimos"
HACER
Sea específico con los números:
"El tiempo de respuesta debe ser inferior a 2 segundos para el 95% de las consultas"
NO
Utilice términos vagos:
"El sistema debería ser rápido"
HACER
Definir términos:
"Cliente activo: cualquier cliente con una compra en los últimos 90 días"
NO
Asuma comprensión:
"Mostrar clientes activos" (¿Qué hace que un cliente sea activo?)
Palabras poderosas para requisitos
Utilice estas palabras de acción:
- Calcular, Validar, Generar
- Mostrar, ocultar, habilitar, deshabilitar
- Crear, actualizar, eliminar, archivar
- Enviar, recibir, procesar, almacenar
- Autenticar, autorizar, registrar
Evite estos términos vagos:
- "Fácil de usar" (sea específico)
- "Flexible" (definir la flexibilidad)
- "Intuitivo" (describe el flujo)
- "Robusto" (especifique el manejo de errores)
- "Etc." (enumera todo)
El formato de la historia de usuario
Como [tipo de usuario], quiero [acción], para que [beneficio]
Ejemplos:
- "Como gerente de almacén, quiero ver alertas de existencias bajas en mi panel para poder realizar nuevos pedidos antes de que se agoten las existencias"
- "Como representante de ventas, quiero comprobar el inventario en tiempo real durante las llamadas para poder prometer fechas de entrega precisas"
- "Como contable, quiero informes de valoración de acciones automatizados, para poder cerrar los libros más rápido cada mes"
Plantilla de criterios de aceptación
Dado [contexto inicial]
Cuando [ocurre la acción]
Entonces [resultado esperado]
Ejemplo:
Dado un producto con nivel de stock mínimo de 50 unidades.
Cuando la cantidad disponible cae a 50 o menos
Luego, el sistema envía un correo electrónico al director del almacén en 5 minutos.