Historias de usuario en Scrum: formato, INVEST y ejemplos
Te piden «un sistema de reservas». Es demasiado grande para empezar, demasiado vago para estimarlo y, cuando lo entregues, seguramente no será lo que el cliente imaginaba. Las historias de usuario sirven para trocear ese encargo en piezas pequeñas, cada una con sentido para quien la va a usar.
Una historia de usuario describe una necesidad desde el punto de vista de quien usa el producto, en una frase que cabe en una tarjeta. En inglés se llama user story. La tarjeta no explica todos los detalles: es el recordatorio de qué hay que hablar, y los detalles salen de la conversación. Lo acordado en esa conversación se escribe como criterios de aceptación, para que nadie tenga que fiarse de la memoria.
Qué es una historia de usuario
Una historia de usuario es una pequeña parte del producto que aporta valor por sí misma. La Agile Alliance la describe así: el equipo, junto con el cliente o el dueño de producto, divide el trabajo en incrementos funcionales pequeños, y cada uno debe aportar valor al producto, sea cual sea el orden en que se construya.
Nacieron en Extreme Programming (XP), a finales de los noventa, como alternativa a los documentos de requisitos largos. XP es uno de los métodos que dieron forma al agilismo. Tradicionalmente se escribían en una ficha de cartulina o en un pósit.
Tres ejemplos para un hotel:
- Como huésped, quiero reservar una habitación por internet para no tener que llamar por teléfono.
- Como huésped, quiero cancelar mi reserva para no pagar si cambio de planes.
- Como recepcionista, quiero ver las llegadas del día para preparar las habitaciones.
¿Las historias de usuario son parte de Scrum?
No. Es una confusión muy habitual. La Guía de Scrum (la versión vigente es la de noviembre de 2020) no menciona las historias de usuario. Habla de elementos del Product Backlog: el Product Backlog es la lista ordenada y cambiante de lo que hace falta para mejorar el producto, y Scrum no impone cómo se escribe cada elemento.
Lo que pasa es que las historias de usuario encajan muy bien con Scrum, y por eso muchos equipos las usan para escribir esos elementos:
| Lo que pide Scrum | Cómo ayudan las historias |
|---|---|
| Elementos que el equipo pueda terminar en un Sprint | Una buena historia es pequeña (la S de INVEST) |
| Un orden según el valor | Cada historia dice qué valor aporta y a quién |
| Refinar el backlog: dividir los elementos y añadirles detalle | Las historias se dividen y se completan con criterios de aceptación |
El Product Owner es quien se encarga de que el Product Backlog esté ordenado y se entienda, aunque las historias se escriben y se refinan entre todo el equipo. Si quieres repasar quién hace qué, lo tienes en Roles dentro de un equipo ágil.
Cómo se escribe: Como… quiero… para…
El formato más conocido tiene tres partes:
Como <tipo de usuario>,
quiero <hacer algo>
para <conseguir un beneficio>.
| Parte | Qué responde | Ejemplo |
|---|---|---|
| Como… | ¿Quién lo necesita? | Como huésped |
| quiero… | ¿Qué quiere poder hacer? | quiero cancelar mi reserva |
| para… | ¿Por qué le importa? | para no pagar si cambio de planes |
Esta plantilla se atribuye a Rachel Davies y a su equipo en Connextra, una empresa británica, a principios de los años 2000. En inglés es As a… I want… so that….
La parte que más se olvida es el para, y es la más útil: si nadie sabe explicar para qué sirve la historia, quizá no haga falta. Además, conocer el motivo deja al equipo proponer una solución mejor que la pedida.
Las tres C: tarjeta, conversación y confirmación
Ron Jeffries, uno de los creadores de XP, resumió en 2001 las tres partes de una historia de usuario:
- Tarjeta (Card): la frase corta que identifica la historia y sirve para planificar. Es un recordatorio, no la especificación completa.
- Conversación (Conversation): los detalles se hablan entre el cliente y quienes la van a construir, al estimarla y al planificarla.
- Confirmación (Confirmation): las pruebas de aceptación que demuestran que la historia está bien hecha.
La tarjeta es la excusa para hablar.
INVEST: cómo saber si una historia es buena
Bill Wake propuso en 2003 la regla INVEST, seis cualidades que debe tener una buena historia:
| Letra | En inglés | Qué significa | Pregunta para comprobarlo |
|---|---|---|---|
| I | Independent | Independiente: no se solapa con otras y, si es posible, se puede hacer en cualquier orden | ¿Puedo hacerla sin esperar a otra? |
| N | Negotiable | Negociable: no es un contrato cerrado; los detalles se acuerdan durante el desarrollo | ¿Recoge la idea sin fijar cada detalle? |
| V | Valuable | Valiosa: le importa al cliente o al usuario | ¿Alguien la echaría de menos si no estuviera? |
| E | Estimable | Estimable: el equipo puede calcular, aunque sea a grandes rasgos, cuánto cuesta | ¿Sabemos lo suficiente para estimarla? |
| S | Small | Pequeña: como mucho, unas pocas semanas de trabajo de una persona (en Scrum, que quepa en un Sprint) | ¿Cabe en un Sprint? |
| T | Testable | Comprobable: se puede escribir una prueba que diga si está terminada | ¿Sé cómo demostrar que funciona? |
Si una historia falla en alguna letra, normalmente se arregla reescribiéndola o dividiéndola.
Criterios de aceptación
Los criterios de aceptación son las condiciones que debe cumplir una historia para darla por buena. Son la tercera C, la confirmación, y la mejor defensa contra el «esto no es lo que yo quería».
Puedes escribirlos como una lista sencilla:
Historia: Como huésped, quiero cancelar mi reserva
para no pagar si cambio de planes.
Criterios de aceptación:
- Si cancelo con más de 48 horas de antelación, me devuelven todo el importe.
- Si cancelo con menos de 48 horas, no hay devolución y se me avisa antes de confirmar.
- Al cancelar, la habitación vuelve a estar disponible.
O con el formato Dado / Cuando / Entonces (Given / When / Then), que Dan North y Chris Matts popularizaron con BDD: dado un contexto inicial, cuando ocurre algo, entonces se espera un resultado. Escrito en Gherkin, el lenguaje de herramientas como Cucumber, se puede convertir en una prueba automática:
# language: es
Característica: Cancelar una reserva
Escenario: Cancelar con más de 48 horas de antelación
Dado que tengo una reserva para dentro de 5 días
Cuando la cancelo
Entonces recibo la devolución completa
Y la habitación vuelve a estar disponible
Escenario: Cancelar con menos de 48 horas de antelación
Dado que tengo una reserva para mañana
Cuando la cancelo
Entonces no recibo devolución
Y veo el aviso "Esta reserva ya no admite devolución"
Cómo pasar de estos escenarios a tests que fallan y luego pasan, paso a paso, está en ATDD: desarrollo dirigido por tests de aceptación. Y si quieres saber qué es BDD y de dónde sale este formato, tienes una guía rápida.
Con agentes de IA, estos criterios son la base del spec-driven development: se escriben antes de pedir el código y cada uno tiene su test.
Criterios de aceptación y Definition of Done no son lo mismo
| Criterios de aceptación | Definition of Done | |
|---|---|---|
| A qué se aplica | A una historia concreta | A todo el trabajo del equipo |
| Qué dice | Qué tiene que hacer esta funcionalidad | Qué calidad mínima debe tener cualquier incremento (por ejemplo: con tests, revisado, desplegado en pruebas) |
| ¿Es de Scrum? | No, es una práctica habitual | Sí, la Guía de Scrum la define |
Una historia está terminada cuando cumple sus criterios de aceptación y la Definition of Done del equipo.
Ejemplos: historias bien y mal escritas
Mal escritas
- «Crear la tabla de reservas en la base de datos»: es una tarea técnica; al usuario no le aporta nada por sí sola
- «Añadir un botón de cancelar»: describe un componente de la pantalla, no una necesidad
- «Como usuario, quiero gestionar reservas»: demasiado grande y vaga para estimarla
- «Como huésped, quiero que la web vaya bien»: imposible de comprobar
Mejor escritas
- «Como huésped, quiero reservar una habitación por internet para no tener que llamar»
- «Como huésped, quiero cancelar mi reserva para no pagar si cambio de planes»
- «Como recepcionista, quiero ver las llegadas del día para preparar las habitaciones»
- «Como huésped, quiero ver los resultados de búsqueda en menos de 2 segundos para no abandonar la reserva»
Otros errores frecuentes, según la Agile Alliance:
- Tratar la historia como un documento. Lo valioso es lo que el equipo entiende sobre lo que hay que construir, no el texto.
- Trocear un documento de requisitos en historias, una por apartado, en vez de pensar en lo que necesita cada usuario.
- Exigir el mismo detalle a todas. Las historias se van detallando a medida que se acerca el momento de construirlas.
- Confundirlas con casos de uso. Se parecen, pero no son lo mismo ni se corresponden uno a uno.
Cómo dividir una historia demasiado grande
«Como huésped, quiero gestionar mis reservas» no cabe en un Sprint. Hay que partirla, y la clave es partirla en vertical: cada trozo debe funcionar de principio a fin (pantalla, lógica y datos), aunque sea pequeño. Bill Wake lo compara con cortar una tarta de capas: cada porción lleva un poco de todas las capas.
Partirla en horizontal («primero la base de datos, luego la lógica, luego la pantalla») da trozos que no aportan nada hasta que están todos.
| Forma de dividir | Ejemplo |
|---|---|
| Por operación | Reservar · Cancelar · Cambiar las fechas |
| Por regla de negocio | Cancelar con devolución · Cancelar sin devolución |
| Por tipo de usuario | Huésped · Recepcionista |
| Primero el caso sencillo | Pagar con tarjeta · Más adelante, otros medios de pago |
Historias de usuario cuando programas con IA
Esto es criterio propio del enfoque IA Limpia, no una regla de Scrum: una historia bien escrita es también una buena petición para un agente de IA.
- El para le da contexto: no solo qué hacer, sino qué problema resuelve.
- Los criterios de aceptación le dicen cuándo ha terminado, y tú los puedes comprobar sin leer todo el código.
- Si están escritos como Dado / Cuando / Entonces y los conviertes en tests antes de pedirle el código, el agente tiene una forma objetiva de saber si lo ha hecho bien.
Una petición vaga a una persona produce una conversación; a un agente, suele producir código que hace otra cosa con mucha seguridad. Por eso la conversación de las tres C sigue haciendo falta: la tienes tú con el cliente antes de hablar con la máquina.
Tu chuleta
Como <quién>,
quiero <qué>
para <por qué>.
Criterios de aceptación:
- Dado <contexto>, cuando <acción>, entonces <resultado>.
- …
Antes de darla por buena (INVEST):
[ ] Independiente [ ] Negociable [ ] Valiosa
[ ] Estimable [ ] Pequeña [ ] Comprobable
Fuentes
Comprobado en noviembre de 2026:
- La Guía de Scrum, de Ken Schwaber y Jeff Sutherland, versión de noviembre de 2020 (sigue siendo la vigente): no menciona las historias de usuario; define el Product Backlog, el refinamiento y la Definition of Done.
- User Stories, glosario de la Agile Alliance: definición, origen en XP y errores frecuentes.
- Essential XP: Card, Conversation, Confirmation, de Ron Jeffries (30 de agosto de 2001).
- INVEST in Good Stories, and SMART Tasks, de Bill Wake (agosto de 2003).
- Why the Three-Part User Story Template Works So Well, de Mike Cohn: origen de la plantilla en Connextra.
- Introducing BDD, de Dan North: plantilla de historia y de escenarios Given / When / Then.
- Lecturas que enlazaba la versión original de este artículo: «Plantillas Scrum: historias de usuario y criterios de aceptación», en PMOInformatica.com (2012), sigue disponible; el artículo de Management Plaza (
managementplaza.es/blog/historias-de-usuario-en-scrum-agile/) ya no existe (la web responde «410 Gone» en noviembre de 2026) y se ha retirado el enlace.
El ejemplo en Gherkin se ha validado con Cucumber.js 13.3.0 y Node.js 24.21.0 (npx cucumber-js --dry-run: 2 escenarios y 8 pasos reconocidos). La implementación de los pasos se explica en el artículo de ATDD.