Requirements Document
A precise, testable specification of functional and non-functional requirements, each a single verifiable statement with a stable ID, plus acceptance criteria, constraints and scope..
Qué es un Documento de Requisitos
Un Documento de Requisitos es el contrato entre la intención y la construcción. Establece, en oraciones únicas y verificables, qué debe hacer un sistema y qué cualidades debe cumplir, para que diseñadores, ingenieros e interesados trabajen a partir de una definición compartida y no de una conversación de pasillo.
Cada requisito lleva un ID estable y es verificable por sí solo. Esa estructura permite que los criterios de aceptación se vinculen a líneas específicas, que los revisores aprueben una lista conocida y que el alcance no se desvíe una vez que comienza el trabajo.
Bien hecho, es breve de leer pero exacto para actuar sobre él. Separa el comportamiento funcional de las cualidades no funcionales, como el rendimiento y la seguridad, registra los supuestos y las restricciones, e indica qué queda deliberadamente fuera de alcance.
Anatomía de un Documento de Requisitos
Visión general y objetivos
Explica por qué existe el sistema y cómo se ve el éxito. Esto enmarca cada requisito que sigue y le da a los revisores un objetivo con el cual evaluar.
Alcance y contexto
Define el límite, los usuarios y los sistemas involucrados. Acordar el contexto aquí evita discusiones posteriores sobre qué estaba realmente en juego.
Requisitos funcionales
Enumera qué debe hacer el sistema, cada uno como una única declaración verificable con un ID estable. Son los comportamientos que un evaluador puede confirmar o rechazar sin debate.
Requisitos no funcionales
Recoge cualidades como el rendimiento, la seguridad, la fiabilidad y la disponibilidad. Redáctalas como umbrales medibles para que se puedan probar en lugar de darse por supuestas.
Criterios de aceptación
Detalla exactamente cómo se verifica cada requisito y qué se considera terminado. Es la línea que separa una funcionalidad terminada de una discusión interminable.
Supuestos y restricciones
Registra de qué depende la especificación y los límites que debe respetar, como plataformas, presupuestos o plazos. Sacarlos a la luz desde el principio evita que se conviertan en sorpresas.
Fuera de alcance
Indica, de forma deliberada, qué no hará este sistema. Una lista de exclusiones explícita es la defensa más económica que puedes escribir contra la expansión de alcance.
Cómo redactar requisitos que se sostengan
Do
- Redacta cada requisito como una única declaración verificable con un ID estable para que se pueda rastrear y probar.
- Separa el comportamiento funcional de las cualidades no funcionales, como el rendimiento, la seguridad y la fiabilidad.
- Vincula criterios de aceptación a cada requisito para que todos acuerden qué significa "terminado".
- Expón los supuestos y las restricciones con claridad para que las dependencias salgan a la luz antes de la construcción, no durante ella.
- Mantén una lista explícita de fuera de alcance para frenar la expansión de alcance antes de que comience el trabajo.
Avoid
- No agrupes varios comportamientos en un solo requisito, porque una prueba que pasa a medias no tiene dónde aterrizar.
- No escribas objetivos no funcionales ambiguos como "rápido" sin un umbral medible que verificar.
- No reutilices ni reordenes los IDs, ya que un objetivo cambiante rompe la trazabilidad y la aprobación.
- No dejes los criterios de aceptación sobreentendidos, o "terminado" se convertirá en una cuestión de opinión.
- No omitas la sección de fuera de alcance dando por sentado que todos comparten el mismo límite.
El método tradicional frente al método waxTable
Cómo genera Waxe tu Documento de Requisitos
- 1
Describe el sistema
Cuéntale a Waxe para qué sirve el sistema, quién lo usa y qué problema resuelve. Waxe convierte eso en la visión general y los objetivos, estableciendo la meta con la que se evaluará cada requisito.
- 2
Define el límite
Waxe redacta el alcance y el contexto, nombrando a los usuarios y sistemas involucrados y dónde se ubican los límites. También escribe la lista de fuera de alcance para que el límite quede explícito antes de que alguien empiece a construir.
- 3
Redacta los requisitos
Waxe redacta los requisitos funcionales y no funcionales como declaraciones únicas y verificables, cada una con un ID estable. El comportamiento funcional y las cualidades como el rendimiento y la seguridad quedan en secciones propias, listas para probar.
- 4
Vincula criterios de aceptación
Para cada requisito, Waxe redacta criterios de aceptación que definen exactamente cómo se verifica y qué se considera terminado. También registra los supuestos y las restricciones de los que depende la especificación, para que las dependencias queden documentadas.
- 5
Revisa y comparte
Editas cualquier línea directamente en el espacio de trabajo, ajustando requisitos, criterios o alcance según sea necesario. La numeración y la estructura se mantienen intactas, y compartes un Documento de Requisitos limpio y fiel a tu marca en unos cinco minutos por unos centavos.
Frequently asked
¿Qué es un Documento de Requisitos?
Un Documento de Requisitos es una especificación precisa y verificable de qué debe hacer un sistema y con qué nivel de calidad debe hacerlo. Cada requisito funcional y no funcional se redacta como una única declaración verificable con un ID estable, para que se pueda rastrear, probar y aprobar. También recoge los criterios de aceptación, los supuestos, las restricciones y una lista explícita de lo que queda fuera de alcance. El objetivo es no dejar nada a la interpretación entre quienes redactan la especificación y quienes construyen a partir de ella.
¿Qué incluye un buen Documento de Requisitos?
Comienza con una visión general y los objetivos, y luego establece el alcance y el contexto para que todos acuerden los límites. El cuerpo separa los requisitos funcionales de los no funcionales, como el rendimiento, la seguridad y la fiabilidad. Los criterios de aceptación definen exactamente cómo se verifica cada requisito, y los supuestos y restricciones registran de qué depende la especificación. Una sección clara de fuera de alcance cierra la puerta a la expansión de alcance incluso antes de que empiece la construcción.
¿Por qué asignar un ID estable a cada requisito?
Un ID estable convierte una línea de texto en algo a lo que se puede hacer referencia durante toda la vida del proyecto. Permite que una prueba haga referencia al requisito exacto que verifica, que una solicitud de cambio indique qué está modificando, y que una aprobación cubra una lista conocida. Sin IDs, los revisores discuten sobre a qué frase se referían y la aceptación se convierte en conjetura. waxTable asigna estos IDs y los mantiene coherentes entre las secciones funcionales y no funcionales, para que la trazabilidad se mantenga desde el objetivo hasta el criterio de aceptación.
¿Cómo construye waxTable el documento para mi proyecto?
Le indicas a Waxe para qué sirve el sistema y a quién sirve, y Waxe redacta un Documento de Requisitos completo con visión general, alcance, requisitos numerados y criterios de aceptación. Separa el comportamiento funcional de las cualidades no funcionales y redacta cada requisito como una única declaración verificable. Los supuestos, las restricciones y una lista de fuera de alcance se completan para que el límite quede explícito. Todo el borrador toma unos cinco minutos y cuesta unos centavos, y luego editas cualquier línea directamente en el espacio de trabajo.
¿Puedo modificar los requisitos después de que Waxe los genere?
Sí. El Documento de Requisitos generado se puede editar por completo en el espacio de trabajo de waxTable, no es una exportación bloqueada. Puedes reescribir cualquier requisito, añadir o quitar criterios de aceptación, ajustar el límite de alcance o mover un elemento a la sección de fuera de alcance. Las ediciones mantienen intactas la estructura y el estilo del documento, así que la numeración y el orden de las secciones se mantienen ordenados. Cuando la especificación está lista, la compartes como un documento pulido y fiel a tu marca.
Skip the writing — generate the whole requirements document
Waxe drafts it on your brand in about five minutes, then you refine it. From two days of work to a few cents.
Tu próximo documento de requisitos, en cinco minutos
Cuéntale a Waxe sobre el cliente y recibe un documento de requisitos completo y fiel a tu marca, listo para revisar: el trabajo de dos días por unos pocos céntimos. No hay página en blanco con la que empezar ni nada que formatear a mano; respondes un breve cuestionario, Waxe redacta, y tú conservas el control total del documento final en el editor.