Una promesa de valor orienta la solución, pero no describe por sí sola lo que debe hacer, cómo debe comportarse ni cómo comprobaremos que funciona.
«Queremos facilitar las reservas» no basta para encargar una aplicación. ¿Quién crea la reserva? ¿Cómo se confirma? ¿Qué ocurre si la conexión falla? ¿Quién puede modificarla y cómo sabe el cliente que el cambio quedó guardado? Convertir el resultado buscado en requisitos verificables reduce malentendidos, pero no garantiza por sí solo una buena experiencia. La guía británica de historias de usuario insiste en vincular actor, necesidad, objetivo y criterios de aceptación [R01]; esa práctica puede aplicarse también a servicios o procesos que no utilizan Scrum.
1. No confundas necesidad, resultado, requisito y funcionalidad
| Concepto | Pregunta | Ejemplo de reservas |
|---|---|---|
| Necesidad | ¿Qué intenta conseguir la persona? | Evitar perder cambios de horario |
| Resultado de valor | ¿Qué mejora debemos producir? | Personal y cliente reciben la misma confirmación |
| Requisito | ¿Qué condición debe cumplir la solución? | Registrar fecha, hora y confirmación del cambio |
| Funcionalidad | ¿Qué capacidad concreta se implementa? | Modificar una reserva desde la agenda |
| Criterio de aceptación | ¿Qué evidencia permite aceptar ese comportamiento? | Tras confirmar, el nuevo horario aparece a los usuarios autorizados |
| Métrica de resultado | ¿Cómo evaluar si mejora la situación? | Cambios perdidos en un período, con denominador y contexto |
Una función puede existir y no producir valor: una agenda capaz de guardar veinte campos no resuelve un cambio si el personal no entiende quién confirma. El artículo de propuesta de valor del Pilar 2 aporta la promesa; aquí transformamos esa promesa en condiciones de construcción. No uses «valor» como sinónimo de «cantidad de requisitos».
2. Recupera necesidades y escenarios reales
Antes de redactar requisitos, reúne las necesidades priorizadas, el recorrido de usuarios, incidencias documentadas, restricciones y obligaciones conocidas. Identifica quién usa, quién compra, quién autoriza y quién opera: no siempre son la misma persona. La guía de investigación de necesidades de GOV.UK recomienda conservar la conexión entre necesidades y futuras historias de usuario [R02].
Para cada escenario describe: actor, situación inicial, acción, resultado esperado y qué podría impedirlo. No inventes procesos perfectos: contrasta los flujos con quienes realizan el trabajo. Un gerente puede pedir «reservas automáticas», mientras que el empleado necesita gestionar cambios por teléfono y la persona usuaria necesita no recibir dos confirmaciones contradictorias.
Cuando aparezcan peticiones incompatibles, utiliza la priorización de necesidades del cliente para distinguir los resultados realmente importantes. Un listado de funcionalidades no reemplaza la evidencia sobre necesidades.
3. Clasifica requisitos por su propósito
Funcionales: capacidades y reglas observables; crear, consultar, modificar o cancelar una reserva. De información y datos: qué datos se necesitan, de dónde provienen, quién puede acceder y cuánto deben conservarse. De interfaz e integración: qué otras herramientas o personas deben intercambiar información.
No funcionales o atributos de calidad: seguridad, accesibilidad, confiabilidad, rendimiento, mantenibilidad y compatibilidad. No todos se reducen a una cifra única; deben tener una condición verificable y un contexto. El modelo ISO/IEC 25010:2023 ofrece una referencia para especificar y evaluar calidad de productos TIC, pero no sustituye los requisitos propios del negocio ni implica que cada servicio deba certificarse [R03].
Operativos: quién atiende incidencias, qué ocurre sin conexión, cómo se recupera una tarea y cómo se capacita al personal. Restricciones: presupuesto, equipo, materiales, condiciones regulatorias y límites físicos. Algunas restricciones son obligatorias; otras expresan una preferencia que puede renegociarse.
Un mismo enunciado no debe mezclarlas todas. «La aplicación será rápida, segura y sencilla» carece de contexto, métrica y criterio de prueba.
Los atributos no funcionales necesitan criterios acordes con su riesgo: la guía para definir y comprobar calidad desarrolla dimensiones, controles y evidencias para no confundir «rápido» o «seguro» con requisitos ya verificables.
4. Redacta requisitos claros y comprobables
Un requisito útil tiene identificador, condición o comportamiento, actor/contexto, motivo, prioridad, fuente de evidencia y método de verificación. Por ejemplo:
- Débil: «El sistema permitirá reservas fáciles».
- Mejor: «Una persona autorizada puede cambiar la hora de una reserva existente y verificar el horario confirmado antes de abandonar el flujo».
- Complemento no funcional: «El cambio no debe permitir que usuarios sin permiso consulten datos de otra reserva».
Evita «siempre», «intuitivo» o «lo más rápido posible» salvo que definas qué significan y cómo se comprobarán. Un requisito no necesita sonar contractual para ser preciso. Si su origen es una suposición, márcalo como hipótesis, no como necesidad confirmada.
5. Usa historias de usuario, casos de uso y escenarios según convenga
Una historia resume actor, acción y propósito: «Como encargado de sala, necesito modificar una reserva existente para reflejar un cambio confirmado por el cliente». Ayuda a discutir alcance, pero no sustituye el comportamiento detallado.
Un caso de uso describe secuencias, precondiciones, escenarios alternativos y errores: la reserva existe; el encargado solicita otra hora; el sistema verifica disponibilidad; confirma o informa del conflicto. Un escenario concreto representa una situación que puedes observar o probar.
No conviertas todo en historias de usuario por obligación. Un requisito de resistencia de materiales, un control de inocuidad o una condición de seguridad puede necesitar especificación técnica, procedimiento de inspección o evidencia de una autoridad. La forma documental debe servir al riesgo.
6. Escribe criterios de aceptación que puedan ponerse a prueba
Los criterios describen cuándo una capacidad satisface lo acordado. Pueden redactarse como resultados observables o con el patrón Given–When–Then (Dado–Cuando–Entonces), que es útil, no obligatorio:
Dado que una reserva confirmada existe y el encargado tiene autorización, cuando selecciona una nueva hora disponible y confirma el cambio, entonces el sistema muestra el horario actualizado y conserva evidencia del cambio.
Añade escenarios de error, no solo el camino feliz:
Dado que el horario solicitado está ocupado, cuando intenta confirmarlo, entonces recibe una explicación comprensible, no se sustituye silenciosamente el horario anterior y puede elegir otra opción.
En una inspección física, el equivalente es definir dimensiones, tolerancias, instrumento, muestra y consecuencia de una desviación. Para un servicio, puede ser comprobar que se emita una confirmación conforme al procedimiento y que existan pasos de recuperación. Los umbrales reales se fijan según el contexto, los riesgos y la evidencia; no se copian de ejemplos ficticios.
7. Define lo mínimo obligatorio sin degradar la solución
Distingue esencial para producir el valor, obligatorio por seguridad o cumplimiento, necesario para operar y recuperar fallos, y mejoras opcionales. Una etiqueta «MVP» no justifica suprimir controles necesarios ni prometer capacidades que aún no existen.
La priorización estratégica de necesidades se desarrolla en el Pilar 2 y la matriz MoSCoW de alcance en el Pilar 4. Aquí el objetivo es determinar qué requisitos debe cumplir la versión que vamos a construir y probar, con una decisión explícita sobre lo que queda fuera. Si se excluye notificación automática, explica qué mecanismo manual conservará la confirmación y quién será responsable.
Con las obligaciones mínimas identificadas, pasa a definir un MVP con alcance suficiente para aprender. Reducir funciones no autoriza a suprimir condiciones esenciales de seguridad, cumplimiento o valor central.
8. Construye una matriz de trazabilidad
La trazabilidad une el problema al resultado, el requisito, el criterio y la evidencia. No sirve de nada crear cientos de IDs si no permiten tomar decisiones.
| ID | Necesidad | Requisito | Aceptación prevista | Evidencia |
|---|---|---|---|---|
| REQ-01 | Evitar cambios perdidos | Encargado modifica reserva | Horario actualizado con confirmación | Prueba de flujo y registro |
| REQ-02 | Evitar doble reserva | Detectar conflicto antes de guardar | No altera reserva original ante conflicto | Caso de prueba negativo |
| REQ-03 | Proteger información | Acceso según rol | Un rol no autorizado no ve datos ajenos | Comprobación de permisos |
| REQ-04 | Resolver fallos | Recuperar tras error | Estado final conocido y sin duplicado | Ensayo de interrupción |
La tabla es un ejemplo didáctico, no una especificación lista para producción. Cada criterio real necesitará precisión suficiente sobre actores, condiciones y resultados. Es preferible cuatro requisitos justificables a cincuenta que nadie sabe comprobar.
9. Controla contradicciones y cambios
Dos actores pueden solicitar cosas incompatibles: el cliente quiere editar hasta el último minuto y la cocina necesita cerrar pedidos con antelación. No escondas el conflicto en requisitos independientes. Registra alternativas, impacto, decisión responsable y condiciones. Una necesidad nueva puede requerir revisar una regla anterior, pero debe mantenerse el historial y los casos de prueba afectados.
El control de versiones del Pilar 5 explicará cómo registrar la modificación en una versión entregable. Aquí conserva el motivo del requisito, no solo su redacción final.
Ejemplo completo: criterios cumplidos, experiencia difícil
Un equipo desarrolla una pantalla que permite crear y editar reservas. Los criterios técnicos dicen: guardar fecha, aceptar un nombre y registrar una modificación. En la revisión, todos pasan. Sin embargo, tres usuarios ficticios en una prueba ilustrativa creen que un botón «Cerrar» confirma el cambio; salen sin guardar y deben repetir la tarea.
El cumplimiento técnico no demuestra satisfacción del usuario. El equipo registra el hallazgo y separa tres acciones: revisar el diseño de confirmación, añadir un criterio que exija una señal inequívoca del estado guardado y observar nuevamente la tarea con participantes representativos. La cifra «tres» no representa una población real: ilustra que una nueva observación puede demostrar que los criterios originales eran insuficientes.
En vez de escribir «UX mejorada», el equipo establece qué comportamiento debe observarse, bajo qué condiciones y qué hará si aún existe confusión. El hallazgo se conserva como evidencia, no se reescribe la prueba anterior para fingir que ya cubría el problema.
Errores habituales y límites
Confundir características con necesidades; usar «debe ser fácil» como criterio; omitir errores, recuperación o roles; escribir veinte historias que describen el mismo problema; declarar requisitos sin fuente; establecer cifras de rendimiento sin capacidad de medirlas; convertir un supuesto en obligación legal; priorizar solo el flujo feliz; confundir aceptación de una función con éxito comercial.
La precisión documental es un medio, no el objetivo. Si el equipo dedica más esfuerzo a mantener una matriz que a resolver discrepancias importantes, simplifica el formato sin perder vínculos esenciales.
Qué deberías tener al terminar
Una especificación mínima de solución que incluya necesidades y resultados, requisitos identificados, criterios positivos y negativos, condiciones obligatorias, fuentes, pruebas previstas y trazabilidad. Debe permitir construir y aceptar una versión sin suponer que cumplirla garantiza valor demostrado.
Referencias
- [R01] UK Government Digital Service. Writing user stories. https://www.gov.uk/service-manual/agile-delivery/writing-user-stories
- [R02] UK Government Digital Service. Learning about users and their needs. https://www.gov.uk/service-manual/user-research/start-by-learning-user-needs
- [R03] ISO. ISO/IEC 25010:2023 — Product quality model (resumen público; no se reproduce el texto de la norma). https://www.iso.org/standard/78176.html