Nivel inicial12 min de lectura · Publicado el

Historias de usuario en Scrum: formato, INVEST y ejemplos

Historia de usuario en Scrum: la tarjeta «Como huésped, quiero cancelar…», dos personas que la conversan y los criterios de aceptación con ✓. Las tres C de una historiarubentejera.com Como huésped,quiero cancelarpara no pagar…tarjetaconversaciónconfirmación
La tarjeta solo recuerda de qué hay que hablar; los detalles salen de la conversación, y lo acordado se apunta como criterios de aceptación, que confirman cuándo está terminada.

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:

  1. Tarjeta (Card): la frase corta que identifica la historia y sirve para planificar. Es un recordatorio, no la especificación completa.
  2. Conversación (Conversation): los detalles se hablan entre el cliente y quienes la van a construir, al estimarla y al planificarla.
  3. 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:

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.