Cómo escribir historias de usuario efectivas: guía paso a paso

Escribir una buena historia de usuario parece sencillo, pero hay una diferencia enorme entre una historia útil y una que genera confusión. En esta guía te mostramos cómo escribir historias de usuario efectivas, con ejemplos prácticos y errores comunes que debes evitar.

La plantilla: Como... Quiero... Para...

Toda historia de usuario sigue una estructura de tres partes:

Como [rol del usuario], quiero [acción o funcionalidad], para [beneficio o resultado esperado].

Cada parte tiene un propósito específico:

• Como: define quién necesita la funcionalidad. No siempre es "el usuario" — puede ser un administrador, un cliente, un visitante, un vendedor.
• Quiero: describe la acción concreta que la persona necesita realizar.
• Para: explica el valor o beneficio que obtiene. Esta es la parte más importante porque justifica por qué vale la pena construirla.

Paso 1: Identifica los roles de tu aplicación

Antes de escribir historias, piensa en quién va a usar tu aplicación. Cada tipo de persona tendrá necesidades diferentes.

Ejemplo para una tienda en línea:

• Visitante (no registrado)
• Cliente (registrado)
• Administrador de la tienda
• Repartidor

Ejemplo para una app de reservas:

• Paciente
• Doctor
• Recepcionista

Cuanto más específico seas con los roles, más claras serán tus historias.

Paso 2: Escribe la acción de forma concreta

La parte "Quiero..." debe ser una acción específica, no una descripción vaga.

Mal escrito:

• Como usuario, quiero que la app sea fácil de usar, para estar contento.

Bien escrito:

• Como cliente, quiero filtrar productos por precio y categoría, para encontrar rápidamente lo que busco.

La diferencia es clara: la segunda historia describe algo que un desarrollador puede construir.

Paso 3: Justifica con el beneficio

La parte "Para..." es lo que da contexto. Sin ella, el equipo técnico no sabe por qué es importante.

Sin beneficio (incompleta):

• Como administrador, quiero exportar datos a Excel.

Con beneficio (completa):

• Como administrador, quiero exportar datos a Excel, para compartir reportes con el equipo de finanzas.

El beneficio ayuda a tomar decisiones: si el equipo de finanzas ya tiene acceso directo a los datos, quizá esta historia no es prioritaria.

Ejemplos por tipo de proyecto

App de delivery

• Como cliente, quiero ver el tiempo estimado de entrega, para decidir si hago el pedido ahora o después.
• Como repartidor, quiero ver la ruta optimizada en el mapa, para llegar más rápido.
• Como restaurante, quiero pausar mi menú temporalmente, para no recibir pedidos cuando estoy lleno.

Plataforma educativa

• Como estudiante, quiero retomar un curso donde lo dejé, para no perder mi progreso.
• Como profesor, quiero ver qué porcentaje de alumnos completó cada lección, para identificar contenido difícil.

App de finanzas personales

• Como usuario, quiero categorizar mis gastos automáticamente, para entender en qué gasto más.
• Como usuario, quiero recibir una alerta cuando supere mi presupuesto mensual, para controlar mis gastos.

Errores comunes al escribir historias

1. Historias demasiado grandes

"Como usuario, quiero gestionar toda mi cuenta" — esto no es una historia, es un proyecto. Divídela en historias más pequeñas: cambiar contraseña, actualizar foto de perfil, editar datos personales.

2. Historias técnicas

"Como sistema, quiero usar una base de datos NoSQL" — las historias son desde la perspectiva del usuario, no del sistema. La tecnología es una decisión del equipo técnico.

3. Saltarse el "Para..."

Sin el beneficio, la historia pierde contexto y es difícil priorizarla.

4. Roles genéricos

Siempre que puedas, usa roles específicos. "Como administrador" es mejor que "como usuario" si la funcionalidad es solo para administradores.

Criterios de aceptación

Una vez que tengas la historia, puedes agregar criterios de aceptación: condiciones específicas que deben cumplirse para considerar la historia terminada.

Historia: Como cliente, quiero recuperar mi contraseña por correo, para acceder a mi cuenta si la olvidé.

Criterios:

• El usuario recibe un correo con un enlace de recuperación en menos de 2 minutos
• El enlace expira después de 24 horas
• La nueva contraseña debe tener al menos 8 caracteres

Empieza a escribir las tuyas

La mejor forma de aprender es practicando. Piensa en tu proyecto, identifica los roles y empieza a escribir historias con la plantilla Como... Quiero... Para...

Con EasyStories puedes crear historias usando plantillas guiadas que te ayudan en cada paso, con roles predefinidos y consejos contextuales.