Cómo escribir requisitos de software que puedan comprobarse

Un requisito útil explica quién necesita hacer qué, en qué condiciones y cómo se confirma el resultado. Esta descripción permite comparar propuestas, implementar el comportamiento esperado y aceptar la entrega con criterios claros. Puede empezar en un documento sencillo siempre que conserve las decisiones, las versiones y los ejemplos concretos.

Por Lyntev. Actualizado el .
Unos 5 minutos de lectura.

La respuesta empieza en la fuenteInformación aprobada, acceso definido y una respuesta verificable.

Traducción publicada el . Guía original en portugués; revisión de la fuente .

Al terminar, podrá:

  • Separar el objetivo de la funcionalidad
  • Definir las reglas y los límites
  • Relacionar los requisitos con las pruebas

Explique el problema y los límites de la primera entrega

Empiece por el problema observado, las personas afectadas y el resultado que desea. «Necesitamos una aplicación» describe una solución posible; «las solicitudes quedan sin responsable cuando llegan por canales diferentes» describe un problema que orienta el proyecto. Indique cómo se observó la situación y qué sigue pendiente de confirmar.

Delimite la primera entrega. En un ejemplo ficticio de asistencia técnica, el sistema recibe solicitudes, asigna responsables y sigue los estados. La facturación y la gestión de piezas quedan fuera de esa fase. La orientación de Microsoft recomienda explicitar objetivos, ámbito y responsabilidades. Este límite permite evaluar cambios sin tratar cada idea nueva como parte implícita del acuerdo inicial.

Describa escenarios que alguien pueda ejecutar

Identifique el papel, la tarea y el motivo. «Como coordinador, quiero asignar una solicitud a un técnico para que haya una persona responsable de la intervención» es un comienzo. Añada el estado inicial, los datos necesarios y la salida. El nombre de un botón o una pantalla no sustituye el comportamiento del proceso.

La documentación Agile de Azure Boards distingue historias, tareas y defectos. Utilice esa separación sin depender de la herramienta: una necesidad del usuario puede generar varias tareas de implementación. Mantenga la historia comprensible para quien trabaja en la operación; los detalles de código pueden vincularse en una nota técnica.

Describa escenarios que alguien pueda ejecutar
ElementoEjemplo ficticio completado
PapelCoordinador de asistencia
PrecondiciónSolicitud abierta, todavía sin técnico
AcciónSeleccionar un técnico activo y confirmar la asignación
ResultadoLa solicitud muestra al responsable y registra el cambio
ExcepciónUn técnico inactivo no puede recibir nuevas solicitudes

Haga explícitas las reglas que cambian el resultado

Enumere los campos obligatorios, los estados permitidos, los permisos y las condiciones de cambio. «Asignar técnico» plantea preguntas: ¿quién puede cambiar la asignación? ¿Puede haber dos responsables? ¿Qué ocurre si el técnico deja el equipo? La regla necesita una decisión del negocio antes de trasladarse al sistema.

Defina los términos ambiguos en un glosario breve. Una solicitud cerrada puede significar completada, cancelada o rechazada; si los tres casos necesitan informes diferentes, deben poder distinguirse. Para fechas, importes y cantidades, indique la unidad y la zona horaria cuando corresponda. Añada ejemplos de valores válidos, inválidos y ausentes, especialmente en los campos importados de otros sistemas.

Escriba qué demuestra que se ha cumplido el requisito

Un criterio de aceptación describe un resultado observable. Incluya el recorrido esperado y los casos en que debe rechazarse la operación. Evite criterios como «funciona correctamente» o «es intuitivo»: no aclaran la condición de aprobación. Utilice datos de prueba sin información personal innecesaria.

El plan de pruebas de Microsoft relaciona requisitos, precondiciones, pasos y resultados esperados. Una forma práctica es escribir «dado, cuando, entonces». Si dos usuarios cambian la misma solicitud, defina el comportamiento aceptable: impedir una sustitución silenciosa, pedir una actualización o aplicar una regla explícita. El equipo técnico elige una implementación capaz de cumplir ese contrato.

Criterios ficticios para asignar una solicitudtext
Dada una solicitud abierta sin responsable,
cuando coordinación elige un técnico activo y confirma,
entonces la solicitud muestra a ese técnico y el cambio queda en el historial.

Dada una solicitud que otro coordinador acaba de cambiar,
cuando alguien confirma con una versión desactualizada,
entonces el sistema avisa y no sustituye silenciosamente el cambio.

Incluya requisitos de calidad y operación

Además de las funciones, describa los dispositivos, la accesibilidad, el rendimiento, la continuidad y el soporte. «Rápido» no basta: indique la operación, las condiciones del ensayo, la cantidad de datos y la medida que observar. Un objetivo de tiempo elegido para el proyecto es un criterio negociado, no un estándar universal ni una promesa de resultado antes de probarlo.

Confirme quién crea usuarios, recupera accesos, exporta datos y trata incidentes. Identifique las integraciones, los límites conocidos y los entornos de pruebas. Si el trabajo depende de la red, defina el comportamiento cuando falla la conexión. No pida funcionamiento sin conexión sin aclarar qué tareas quedan disponibles y cómo se resolverán los conflictos al volver la conexión.

  • Indicar los navegadores y equipos realmente utilizados por el equipo.
  • Definir los perfiles de acceso y ejemplos de operaciones prohibidas.
  • Acordar copias, recuperación y responsabilidades de mantenimiento.
  • Separar las funciones de la primera entrega de las mejoras posteriores.

Priorice por necesidad y conserve la relación con las pruebas

Clasifique los requisitos como imprescindibles para la operación inicial, importantes o aplazables. Justifique la prioridad y las dependencias: un informe puede depender de fechas que todavía no se registran. Una lista en la que todo es urgente no ayuda a decidir el ámbito cuando el plazo o la inversión son limitados.

Dé un identificador a cada requisito y relaciónelo con la prueba correspondiente. Al cambiar una regla, registre el motivo, la decisión y las pruebas afectadas. Distinga defecto, aclaración y cambio de ámbito. Esta distinción no decide automáticamente las condiciones comerciales; aporta pruebas para discutir qué ha cambiado y cuál es el impacto.

Priorice por necesidad y conserve la relación con las pruebas
Formulación débilCómo mejorarla
Tener informes completosNombrar la decisión, los datos, los filtros y el cálculo.
Permitir editarlo todoIndicar perfiles, campos y estados editables.
Enviar notificacionesDefinir el evento, el destinatario, el canal y el fallo.
Integrar con cualquier sistemaIdentificar sistemas, contratos y operaciones concretos.

Utilice una ficha por comportamiento verificable

Complete primero los requisitos que sostienen el recorrido principal. Revíselos con alguien de la operación y alguien de la implementación. Cuando el equipo puede explicar el escenario y la prueba del mismo modo, ya hay una base útil para estimar y construir. Guarde las decisiones abiertas con un responsable y una fecha para resolverlas.

Ficha para su proyecto

Ficha de requisito
Identificador, título y versión:
Problema u objetivo que resuelve:
Papel del usuario y permisos necesarios:
Estado inicial y datos de entrada:
Acción y resultado esperado:
Reglas, estados y excepciones:
Criterios de aceptación y ejemplos:
Comportamiento ante errores o concurrencia:
Requisitos de calidad asociados:
Dependencias y prioridad justificada:
Prueba asociada y evidencias esperadas:
Cuestiones pendientes y responsable:
Aprobación y fecha:

Fuentes y criterios

Contenido elaborado con ayuda de IA e investigación en fuentes técnicas, con comprobación de los ejemplos y cálculos pertinentes. Las referencias fundamentan las decisiones de la guía; los ejemplos identificados como ficticios permiten probar el método.

Wellinton Oliveira

Escrito por

CEO de Lyntev

Tecnología con contexto, análisis propio y fuentes que puede consultar.