¿Por qué estructurar los criterios de aceptación en formato BDD (Gherkin)?

El formato Gherkin (Dado que - Cuando - Entonces) elimina la ambigüedad en los requisitos al transformar las expectativas de negocio en escenarios de prueba verificables y automatizables directamente con herramientas como Cucumber, Playwright o Cypress.

¿Qué significa el acrónimo INVEST en metodologías ágiles?

INVEST es un conjunto de criterios creado por Bill Wake para evaluar la calidad de una historia de usuario: Independent (Independiente), Negotiable (Negociable), Valuable (Valiosa), Estimable (Estimable), Small (Pequeña para caber en un sprint) y Testable (Verificable con pruebas objetivas).

¿Cómo exportar las historias generadas a Jira o Linear?

La herramienta cuenta con un selector de formato en tiempo real: selecciona la pestaña «Markdown» para Linear, GitHub Issues o Notion, o la pestaña «Jira» para obtener la sintaxis nativa de Atlassian lista para pegar directamente en la descripción del ticket.

Generador de historias de usuario y BDD Gherkin

Estructurador ágil de historias de usuario

Redacta especificaciones claras y criterios de aceptación verificables con 1 clic

1. Definición y alcance

Título de la historia / Tarea *

Épica / Módulo

Tipo de issue

Prioridad

2. Narrativa de usuario

COMO

QUIERO

PARA

3. Criterios de aceptación BDD (Gherkin)

4. Estimación y calidad INVEST

Estimación en Story Points (Secuencia Fibonacci)

Checklist de calidad INVEST 6 de 6 cumplidos (100 %)

Independiente Negociable Valiosa Estimable Pequeña (Small) Verificable (Testable)

Historias guardadas 0

Ingeniería ágil de requisitos de software

Cómo redactar historias de usuario profesionales y criterios BDD

Guía canónica de redacción, criterios de aceptación y buenas prácticas INVEST para Product Managers y Scrum Masters.

1. La anatomía de la historia de usuario

Una historia de usuario no es una especificación exhaustiva de software, sino una invitación a una conversación centrada en el valor:

Como: Concreta el arquetipo (persona) para que el equipo entienda su contexto y motivaciones.
Quiero: Expresa la necesidad funcional sin fijar de antemano la solución técnica.
Para: El núcleo más importante. Si no hay beneficio claro para el usuario o el negocio, la historia debe descartarse.

2. BDD y formato Gherkin

BDD conecta el lenguaje natural con los tests automatizados de aceptación:

Dado que (Given): Establece el punto de partida (ej. sesión iniciada, saldo disponible).
Cuando (When): La acción concreta que ejecuta el usuario (ej. pulsar el botón de transferir).
Entonces (Then): La consecuencia verificable en la interfaz o base de datos.

3. Los 6 principios INVEST

Antes de incorporar una historia al sprint backlog, valida que cumpla el estándar INVEST:

Independiente: No bloqueada por otras historias simultáneas.
Negociable: Abierta al diálogo con desarrolladores y diseñadores.
Valiosa: Genera retorno tangible.
Estimable: Suficientemente clara para calcular su esfuerzo.
Pequeña: Cabe cómodamente dentro de 1 sprint.
Testable: Permite escribir pruebas automáticas o manuales.

4. Integración fluida con Jira y Linear

Exporta el resultado formateado directamente con un clic:

Linear y GitHub: Copia la salida en Markdown limpio con tablas de escenarios y checklist.
Jira / Confluence: Copia en sintaxis nativa de Atlassian (`h2`, paneles de color y bloques `{code}`).
Cucumber / Behave: Copia en sintaxis `.feature` pura en español.

Preguntas frecuentes sobre historias de usuario

¿Cuál es la diferencia entre una Historia de Usuario y un Caso de Uso?

Un Caso de Uso es un documento exhaustivo que describe paso a paso todas las interacciones técnicas y excepciones del sistema. Una Historia de Usuario es intencionadamente corta y orientada al valor desde la perspectiva de la persona, postergando los detalles finos hasta la reunión de refinamiento del sprint.

¿Qué hacer cuando una historia es demasiado grande para un sprint?

Si una historia se estima en 13 o 21 puntos, viola el principio «Small» de INVEST. Se debe dividir en historias más pequeñas utilizando técnicas de partición: por pasos del flujo de usuario, por tipos de datos, por plataformas (web vs móvil) o implementando primero una versión simplificada (*Happy Path*) y dejando las excepciones complejas para historias posteriores.

¿Se guardan mis historias en la nube o en un servidor?

No. Esta herramienta opera con privacidad total y arquitectura 100 % local en tu navegador. Tu backlog se guarda exclusivamente en el almacenamiento local (LocalStorage) de tu dispositivo.