Contenido del curso
Estructura y evaluación de historias de usuario con criterio INVEST
Crear historias de usuario efectivas evita construir soluciones sin problema real. Aquí entenderás cómo redactarlas con enfoque en valor, cómo se comparan con casos de uso y cómo la IA puede acelerar la escritura sin perder criterio del equipo y del product owner.
¿Qué es una historia de usuario y cómo se escribe para generar valor?
Las historias de usuario no son un contrato ni un requisito técnico. Son habilitadores de conversación que describen funcionalidades desde la perspectiva del usuario para alinear necesidades con valor.
¿Qué significa INVEST y por qué importa?
Un buen enunciado se valida con INVEST:
¿Cómo aplicar el formato cómo/quiero/para?
¿En qué se diferencian historias de usuario y casos de uso?
Ambos aportan, pero resuelven necesidades distintas. Las historias impulsan valor y conversación; los casos de uso documentan el comportamiento del sistema con detalle.
¿Cómo aplicar IA y ejemplos prácticos para escribir historias de usuario?
La IA acelera la redacción, pero se requiere criterio humano. Define un prompt que asigne el rol de product owner, pida crear tres historias que cumplan INVEST, incluya contexto del producto y priorice el valor con criterios de aceptación claros.
Ejemplo válido de historia de usuario:
Ejemplo inválido (requisito técnico):
Ideas que la IA puede proponer y cómo validarlas con criterios de aceptación:
Lecciones cortas de 5 minutos para “victorias tempranas”.
Conexión social y reconocimiento para motivar.
Vocabulario vinculado a intereses personales para relevancia práctica.
Consejo clave: usa la IA como base, pero el criterio del product owner —con conocimiento del producto, mercado y negocio— decide qué entra a la lista de producto y cómo se refina.
¿Tienes un caso como Saludtech o un proyecto personal? Comparte tus tres primeras historias de usuario y cuéntanos cómo priorizarías el valor para tus usuarios.
Julián Darío Bermúdez Trujillo
Estudiante
Angela María García Tangarife
Profesor
Ixcoatl Francisco Pérez
EstudianteIxcoatl Francisco Pérez
Estudiante
Izael Ruelas Garcia
EstudianteIxcoatl Francisco Pérez
EstudianteIxcoatl Francisco Pérez
Estudiante
José David Calderón Serrano
Estudiante
Condor Agency
Estudiante
ORLANDO ERNESTO ARBAIZA AVILES
Estudiante
Platzi Team
Estudiante
Diego Mauricio Zuluaga Rodríguez
Estudiantecómo haces que una HU sea independiente de otras? por ejemplo. Recuperar contraseña depende de una HU en la que ya exista un registro de usuario.
Hola Julian,
En ocasiones se puede presentar que tengamos dependencias para implementar HU que tiene alta relación, pero en definitiva hay que decidir cuál hacer primero. Que puede pasar, que construyamos una HU con algunos criterios de aceptación para poder conectar con la otra HU, y luego volver a refinar y terminar de implementar ambas HU (para que queden completas)
Ejemplo: En este caso de recuperar contraseña, deberás priorizar primero la creación de la contraseña, sin ello no podrás hacer la recuperación. Acá lo que puede revisar es priorizar el backog y adicional recuerda que las HU también se caracterizan por ser Negociables, estratégicamente con el PO puedes revisar. O buscar opciones técnicas como, crear el registro en la base de datos manual hasta que la funcionalidad de crear contraseña esté lista. Creo que con el conocimiento del equipo y del PO revisar estratégicamente la mejor forma de hacerlo.
Ambos aportan, pero resuelven necesidades distintas. Las historias impulsan valor y conversación; los casos de uso documentan el comportamiento del sistema con detalle.
Un buen enunciado se valida con INVEST:
¿Cuál sería una buena práctica para conocer cuando utilizar Historias de Usuario vs Casos de Uso?
¿Qué es una historia de usuario y cómo se escribe para generar valor?
Las historias de usuario no son un contrato ni un requisito técnico. Son habilitadores de conversación que describen funcionalidades desde la perspectiva del usuario para alinear necesidades con valor.
¿En qué se diferencian historias de usuario y casos de uso?
Ambos aportan, pero resuelven necesidades distintas. Las historias impulsan valor y conversación; los casos de uso documentan el comportamiento del sistema con detalle.
Dado el caso de negocio Salud Tech:
i. Teniendo en cuenta el product backlog identificado, selecciona 3 funcionalidades que hayan sido priorizadas como Must Have y escríbelas en formato de historia de usuario, siguiendo el formato que vimos en clase
Permitir el registro e inicio de sesión seguro (pacientes y médicos)
Configurar mi disponibilidad horaria para citas (médico)
Solicitar y agendar una nueva cita (paciente)
ii. Te invito a usar el prompt que encontrarás en la sección de recursos y ajústalo según lo consideres. Recuerda, la Inteligencia artificial es la herramienta, tú eres su co-piloto
Formato Clásico:
Como paciente o médico, quiero registrarme e iniciar sesión de forma segura mediante identificación verificada, para acceder al sistema inmediatamente sin perder tiempo en procesos manuales y así poder gestionar/agendar citas en menos de una semana sin barreras de entrada.
Criterios de Aceptación (Done):
# Criterio Tipo
1 El sistema permite registro completo con validación de correo electrónico en ≤ 2 minutos Funcional
2 El inicio de sesión requiere autenticación de dos factores (2FA) para proteger datos sensibles de salud Seguridad
3 Los datos de identidad del usuario se almacenan cifrados y son consistentes entre registros previos y sesiones futuras Consistencia Datos
Historia de Usuario 2: Configuración de Disponibilidad Horaria (Médico)
Formato Clásico:
Como médico, quiero configurar y actualizar mi disponibilidad horaria en tiempo real, para que los pacientes vean solo los espacios reales disponibles y puedan reservar citas en menos de una semana sin contactar por teléfono ni esperar confirmaciones lentas.
Criterios de Aceptación (Done):
# Criterio Tipo
1 El médico puede establecer bloques horarios disponibles por día de la semana con visualización inmediata en el calendario Funcional
2 Cuando un paciente reserva una cita, ese espacio se bloquea automáticamente en la disponibilidad del médico, evitando doble reservas Consistencia Datos
3 El médico tiene opción de marcar "fuera de servicio" temporalmente, notificando a todos los pacientes afectados Seguridad/Estado
Historia de Usuario 3: Solicitar y Agendar Nueva Cita (Paciente)
Formato Clásico:
Como paciente, quiero buscar y agendar automáticamente una cita médica disponible dentro de los próximos 7 días, para resolver mis necesidades de salud urgentes sin incertidumbre y sin tener que llamar repetidamente buscando vacantes.
Criterios de Aceptación (Done):
# Criterio Tipo
1 El paciente puede filtrar búsquedas por especialidad, ubicación y disponibilidad máxima de 7 días desde hoy Funcional
2 Al confirmar la cita, el paciente recibe confirmación inmediata por email/SMS con ID de reserva único Consistencia Datos
3 El sistema valida que no exista conflicto horario previo antes de completar la reservación y muestra errores claros si hay duplicados Seguridad Transaccional
Evaluación INVEST Aplicada
Criterio HU-1 HU-2 HU-3 Explicación Breve
Independiente ✅ ✅ ✅ Cada historia puede desarrollarse sin dependencia secuencial obligatoria
Negociable ✅ ✅ ✅ Detalles pueden refinarse durante grooming/sprint planning
Valiosa ✅ ✅ ✅ Todas conectan directamente al problema central de acceso rápido
Estimable ✅ ✅ ✅ Equipo técnico puede estimar esfuerzo con criterios claros
Suficientemente pequeña ✅ ✅ ✅ Cada una cabe en un sprint estándar (semana típicamente)
Testeable ✅ ✅ ✅ Criterios de aceptación son verificables objetivamente
j. Dado tu Proyecto personal:
i. Haz lo mismo para tu proyecto personal
Historia de Usuario 1: La Narrativa Inmersiva (Lore)
(Corresponde a la necesidad de "Crear historia de juego")
Formato Clásico:
Como jugador universitario con poco tiempo libre, quiero recibir una narrativa de ciencia ficción fragmentada pero atractiva durante las cargas de pantalla o al iniciar sesiones rápidas, para sentirme inmerso inmediatamente en el universo exótico sin tener que leer párrafos largos antes de empezar a jugar, aprovechando mis ventanas de 40-80 minutos al máximo.
Criterios de Aceptación (Done):
# Criterio Tipo
1 El sistema entrega "pistas" de la historia (lore) visuales o de audio de menos de 15 segundos al iniciar cada sesión. Funcional/Valor
2 La historia avanza progresivamente solo si el jugador completa niveles, manteniendo la consistencia del guion (sin contradicciones). Consistencia Datos
3 El acceso a la historia está protegido por una cuenta única de usuario para guardar el progreso narrativo entre diferentes dispositivos (seguridad de sesión). Seguridad
Historia de Usuario 2: Identidad Visual Rápida (Personajes)
(Corresponde a la necesidad de "Diseñar personajes/sprites")
Formato Clásico:
Como jugador casual, quiero reconocer visualmente a mi personaje y a mis amigos en el mapa multijugador en menos de 1 segundo al entrar al nivel, para poder coordinarnos rápidamente en nuestros pocos minutos de juego sin confundirnos entre tantos mundos exóticos complejos.
Criterios de Aceptación (Done):
# Criterio Tipo
1 Los sprites de los personajes tienen tamaños diferenciados y paletas de color únicas que permiten identificación inmediata bajo estrés de juego. Usabilidad/Diseño
2 El sistema guarda y sincroniza la elección de skin/personaje en la base de datos de usuario, asegurando que aparezca igual en todas las sesiones. Consistencia Datos
3 Las imágenes de los sprites están validadas contra malware o contenido externo no autorizado antes de renderizarse en el cliente. Seguridad
Historia de Usuario 3: Exploración Ágil de Mundos (Mapa)
(Corresponde a la necesidad de "Diseñar el mundo/sprites")
Formato Clásico:
Como jugador que tiene entre 40 y 80 minutos disponibles, quiero navegar por niveles de entorno exótico que carguen instantáneamente y tengan objetivos claros a corto plazo, para evitar tiempos de espera frustrantes y completar misiones completas dentro de mi ventana de tiempo limitada sin sentir que "perdí el partido".
Criterios de Aceptación (Done):
# Criterio Tipo
1 El mapa se carga completamente en menos de 3 segundos en dispositivos móviles estándar, permitiendo jugar inmediatamente. Rendimiento/Valor
2 La geometría del mundo y los objetos interactivos mantienen coordenadas consistentes entre jugadores en tiempo real (evitar desincronización). Consistencia Datos
3 El acceso a los servidores de los mundos requiere autenticación segura para prevenir trampas (hacks) que arruinen la experiencia grupal. Seguridad
Evaluación INVEST y Alineación con el Problema
Independiente: Cada historia se puede desarrollar por separado (primero los mapas, luego los personajes, etc.) sin bloquear la entrega de valor parcial.
Negociable: Puedes ajustar la cantidad de "lore" o el tamaño de los sprites según lo que el equipo pueda hacer en un sprint.
Valiosa: Crucial aquí. A diferencia de decir "quiero dibujar un sprite", estas historias dicen "quiero reconocer rápido" o "quiero cargar veloz". Esto ataca directamente la frustración de tener poco tiempo (40-80 min). Si el juego tarda en cargar o es confuso, pierden su tiempo disponible.
Estimable: Un equipo de desarrollo sabe cuánto cuesta programar un sistema de carga de 3 segundos o implementar autenticación.
Suficientemente pequeña: Cada una representa un incremento de funcionalidad que se puede probar en una semana.
Testeable: Los criterios de aceptación son medibles (tiempo de carga <3s, sincronización valida, identificación en <1s).
Nota del Product Owner sobre "Seguridad/Consistencia" en Videojuegos
En tu ejercicio pediste incluir seguridad o consistencia de datos. En videojuegos de plataforma, esto es vital:
Consistencia: Si tú y tu amigo ven a un enemigo en lugares distintos debido a un error de datos, la partida se rompe.
Seguridad: Proteger la identidad del jugador y evitar trampas (cheats) mantiene la equidad del juego entre amigos, lo cual es esencial para que vuelvan a jugar en su próximo descanso.
Respuesta asistida por AI 1. Historia de Usuario: Agendamiento Ágil (Crear Cita)
Formato Clásico:
Como paciente frustrado por la falta de agenda, quiero visualizar y seleccionar espacios disponibles en tiempo real dentro de los próximos 7 días, para asegurar mi atención médica inmediata y eliminar la incertidumbre de una espera prolongada.
Criterios de Aceptación:
2. Historia de Usuario: Flexibilidad de Agenda (Modificar Cita)
Formato Clásico:
Como paciente con horarios cambiantes, quiero reprogramar mi cita existente hacia un espacio más cercano o conveniente de forma autónoma, para no perder mi turno de atención rápida y evitar el proceso burocrático de llamadas telefónicas.
Criterios de Aceptación:
3. Historia de Usuario: Liberación Responsable (Cancelar Cita)
Formato Clásico:
Como paciente consciente del sistema, quiero cancelar mi cita de forma sencilla desde la aplicación, para liberar ese espacio inmediatamente para otra persona que necesite atención urgente y mantener el ciclo de disponibilidad de 7 días funcional.
Criterios de Aceptación:
TRES HISTORIAS DE USUARIO BRINDADAS POR IA
1. Historia de Usuario: Crear Cita
Formato Clásico: Como paciente con una enfermedad crónica, quiero poder seleccionar y agendar una cita médica visualizando la disponibilidad real en tiempo real, para asegurar mi atención en menos de una semana y eliminar la incertidumbre de no saber cuándo seré atendido.
Criterios de Aceptación:
2. Historia de Usuario: Modificar Cita
Formato Clásico: Como paciente, quiero reprogramar mi cita agendada de manera autónoma desde la aplicación, para ajustar mi atención a imprevistos personales sin tener que esperar días por una nueva llamada telefónica o perder mi cupo de atención.
Criterios de Aceptación:
3. Historia de Usuario: Cancelar Cita
Formato Clásico: Como paciente, quiero cancelar mi cita médica con un solo clic desde la aplicación, para liberar el espacio para otro paciente que lo necesite y evitar el estigma de ser un "no-show" por falta de canales de comunicación efectivos.
Criterios de Aceptación:
Historia de Usuario 1 — Acceso inmediato y confiable a orientación médica
Como paciente con una afectación física o psicológica urgente, quiero ser atendido virtualmente por un profesional de la salud calificado en el menor tiempo posible, para reducir mi ansiedad e incertidumbre, recibir orientación confiable y tomar decisiones seguras sobre mi salud cuando más lo necesito.
Valor para el usuario (enfoque clave)
Criterios de Aceptación
Validación INVEST
Historia de Usuario 2 — Confianza clínica y continuidad del cuidado
Como paciente que recibe orientación médica urgente, quiero que el profesional tenga acceso inmediato a un contexto clínico básico mío, para recibir una guía más precisa, personalizada y segura, que me haga confiar en la calidad del servicio.
Valor para el usuario (enfoque clave)
Criterios de Aceptación
Validación INVEST
Historia de Usuario 3 — Seguridad emocional y claridad post-atención
Como paciente que atraviesa una situación física o psicológica delicada, quiero recibir un cierre claro y empático de la atención médica, para sentirme acompañado, tranquilo y seguro sobre los pasos que debo seguir después de la consulta.
Valor para el usuario (enfoque clave)
Criterios de Aceptación
Validación INVEST
Clase 18 – Historias de Usuario
i. CASO SALUD TECH (3 funcionalidades Must Have)
---
Historia 1: Agendar Cita Rápida
Formato clásico:
Como paciente crónico frustrado, quiero solicitar y confirmar una cita médica en menos de 2 minutos, para dejar de esperar semanas por teléfono y sentir que tengo control sobre mi salud.
Criterios de Aceptación (3 mínimos):
1. El paciente selecciona médico, fecha y hora disponibles y confirma la cita con un solo clic, sin recargar la página.
2. El sistema valida en tiempo real que el horario no haya sido ocupado por otro paciente (bloqueo optimista) y reserva el slot por 2 minutos mientras confirma.
3. Al confirmar, el paciente y el médico reciben una notificación push y email con los detalles de la cita en menos de 10 segundos.
4. Seguridad: Todos los accesos al endpoint de creación de citas se registran en el log de auditoría con timestamp, IP y ID de usuario.
---
Historia 2: Publicar Disponibilidad Médica
Formato clásico:
Como médico principal, quiero configurar mis horarios de atención semanal de forma flexible, para garantizar que los pacientes vean solo espacios reales y evitar el riesgo de sobrecarga o huecos vacíos.
Criterios de Aceptación (3 mínimos):
1. El médico puede crear, editar o eliminar bloques de disponibilidad de 30 minutos arrastrando en un calendario visual (drag-and-drop).
2. Al publicar cambios, el sistema verifica conflictos con citas ya agendadas y alerta si alguna quedaría inválida (consistencia de datos).
3. Los nuevos horarios son visibles para pacientes en menos de 60 segundos sin necesidad de recargar la app.
4. Seguridad: Se requiere autenticación de doble factor para guardar cambios de disponibilidad, protegiendo la agenda de modificaciones no autorizadas.
---
Historia 3: Cancelar Cita sin Fricción
Formato clásico:
Como paciente con una agenda impredecible, quiero cancelar mi cita con un clic y que el espacio se libere al instante, para liberar el horario para otro paciente que lo necesite urgente y evitar ser sancionado por "no-show".
Criterios de Aceptación (3 mínimos):
1. El paciente cancela desde la app móvil o web con una confirmación "¿Estás seguro?" y recibe un ticket de cancelación inmediato.
2. La cita cancelada libera el slot en el calendario del médico al instante y vuelve a aparecer como disponible para el resto de pacientes.
3. El sistema envía notificación push al médico con el motivo de cancelación y le sugiere re-agendar al paciente.
4. Consistencia: Solo el paciente dueño de la cita (verificado por JWT) o un administrador pueden ejecutar la cancelación; intentos no autorizados lanzan alerta de seguridad.
---
j. PROYECTO PERSONAL – APP "FINZ"
---
Historia 1: Conectar Broker
Como inversor novato, quiero conectar mi cuenta de broker ingresando solo una API key, para ver mi portfolio actualizado automáticamente sin tener que transcribir manualmente cada operación.
Criterios de Aceptación:
1. El usuario ingresa API key en un campo encriptado y la app valida conexión con el broker en menos de 5 segundos.
2. Al conectar exitosamente, se muestra balance actual y lista de posiciones con P&L en tiempo real.
3. El sistema guarda la key encriptada localmente y nunca la transmite a servidores externos (privacy first).
4. Si la key es inválida, se muestra mensaje específico: "Revisa permisos de lectura en tu broker".
---
Historia 2: Alerta de Caída
Como inversor con trabajo de tiempo completo, quiero recibir una alerta si cualquier acción de mi portfolio cae más del 5% en un día, para decidir si detener pérdidas sin estar todo el día mirando la pantalla.
Criterios de Aceptación:
1. El usuario activa alertas con un toggle y define el umbral % por activo o global.
2. La app consulta precios cada 5 minutos en background y envía notificación push si se cumple la condición.
3. Al recibir la alerta, el usuario puede ver el gráfico intradía con 1 clic.
4. Límite: Máximo 1 notificación por activo cada 24h para evitar spam.
---
Historia 3: Proyección a Meta
Como persona con meta de libertad financiera, quiero ver una proyección realista de cuántos meses me falta alcanzar mi meta basado en mi rendimiento actual, para motivarme a mantener la disciplina de ahorro.
Criterios de Aceptación:
1. El usuario establece meta en USD y tasa de ahorro mensual en una pantalla simple.
2. La app calcula meses restantes usando fórmula de interés compuesto con rendimiento promedio ponderado del portfolio.
3. El resultado se muestra como "Faltan 14 meses (estimado: Mayo 2026)".
4. Testeable: Al cambiar meta o ahorro, la proyección se actualiza en tiempo real sin recargar.
