Crear Historia de Usuario

Las historias de usuario capturan requisitos desde la perspectiva del usuario final. Cada historia sigue el formato: "Como [quién], quiero [qué], para que [por qué]." Esta estructura asegura que cada característica tenga propósito claro y valor medible.

Abrir el Modal

Accede al modal de creación a través de múltiples caminos:

• Encabezado del proyecto: Haz clic en el botón "Nuevo" en la sección de historias de usuario
• Atajo de teclado: Cmd/Ctrl + Shift + U desde cualquier lugar en el proyecto
• Estado vacío: Haz clic en el enlace "Crea tu primera historia de usuario"
• Creación rápida: Usa el menú de creación rápida global y selecciona "Historia de Usuario"

El modal se abre con tu proyecto actual preseleccionado. Si lo abriste desde el menú global, selecciona primero el espacio de trabajo y proyecto.

Modos de Creación

Modo Tradicional

Escribe historias de usuario en el formato estándar:

Estructura de la plantilla:

Como [tipo de usuario],
Quiero [algún objetivo],
Para que [alguna razón].

Ejemplo:

Como gerente de proyecto,
Quiero ver gráficos de burndown del sprint,
Para que pueda rastrear la velocidad del equipo.

El formato tradicional asegura:

• Identificación clara de la persona usuaria
• Declaración de objetivo específica y accionable
• Justificación del valor de negocio

Escribir historias efectivas:

1. Sé específico sobre el usuario. "Como usuario" es muy vago. Usa "Como administrador de facturación" o "Como visitante por primera vez"

1. Enfócate en un objetivo. Si escribes "y" en la cláusula de quiero, considera dividir en múltiples historias

1. Declara valor medible. "Para que pueda ahorrar tiempo" es débil. "Para que pueda procesar 50% más facturas" es accionable

Modo IA

Describe lo que necesitas en lenguaje natural. La IA genera una historia de usuario correctamente formateada:

Entrada:

Necesito una forma para que los managers aprueben entradas de tiempo antes de que vayan a facturación

Historia generada:

Como gerente de equipo,
Quiero revisar y aprobar entradas de tiempo antes de exportar,
Para que mejore la precisión de facturación y disminuyan las disputas.

El modo IA sobresale cuando:

• Conviertes solicitudes de stakeholders en formato de historia de usuario
• Transformas reportes de bugs en historias de mejora
• Descompones requisitos vagos en necesidades específicas

Campos del Modal

Título (Requerido)

En modo Tradicional, este es tu texto completo de historia de usuario. En modo IA, esta es tu descripción en lenguaje natural.

Límite de caracteres: 500 caracteres Mejor práctica: Mantén los títulos escaneables. La primera línea debe resumir la historia.

Criterios de Aceptación

Define qué significa "hecho" para esta historia. Usa condiciones comprobables:

Criterios débiles:

- Debe funcionar correctamente
- Debe ser rápido
- Debe verse bien

Criterios fuertes:

- Las entradas de tiempo se muestran en orden cronológico
- El manager puede aprobar/rechazar entradas individuales
- Las entradas rechazadas regresan al remitente con comentario requerido
- Las entradas aprobadas se marcan con timestamp y nombre del aprobador
- La página carga en menos de 2 segundos para hasta 500 entradas

Opciones de formato:

Dado/Cuando/Entonces:

Dado que soy un manager logueado
Cuando veo las entradas de tiempo pendientes
Entonces veo las entradas agrupadas por miembro del equipo

Estilo de lista de verificación:

- [ ] Filtrar por rango de fechas funciona
- [ ] Aprobar masivamente entradas seleccionadas funciona
- [ ] Exportar entradas aprobadas a CSV funciona

Información Adicional

Contexto que ayuda durante la implementación:

• Enlaces a mockups de diseño
• Restricciones técnicas
• Documentación relacionada
• Contactos de stakeholders
• Casos límite a considerar

Este campo soporta formato Markdown completo incluyendo enlaces, bloques de código e imágenes.

Prioridad

Establece el nivel de urgencia de la lista de prioridades de tu proyecto:

La prioridad afecta:

• Ordenamiento predeterminado en vistas de backlog
• Sugerencias de planificación de sprint
• Cálculos de carga de trabajo del equipo

Épica

Vincula la historia a una épica padre para organización:

Sin Épica seleccionada: La historia aparece en el backlog sin agrupación Épica seleccionada: La historia se agrupa bajo la épica en vistas de roadmap y planificación

Crear Épica en línea: Haz clic en "Crear nueva épica" para añadir una épica sin salir del modal. Ingresa el título y guarda—la nueva épica es inmediatamente seleccionable.

Esto es valioso cuando:

• Una historia revela necesidad de una nueva iniciativa
• Un stakeholder solicita una característica fuera de épicas existentes
• Estás descomponiendo un requisito grande en épica + historias

Validación del Formulario

El botón crear se habilita cuando:

1. Proyecto seleccionado: Requerido para todas las historias
2. Título proporcionado: Mínimo 3 caracteres
3. Contenido apropiado al modo: Ya sea formato tradicional o descripción IA

Los errores de validación aparecen en línea:

• Título vacío: "El título es requerido"
• Título muy corto: "Mínimo 3 caracteres"
• Sin proyecto: "Selecciona un proyecto primero"

Después de la Creación

Estado de Éxito

El modal confirma la creación con opciones:

Ir a Historias de Usuario: Navegar al tablero de historias de usuario del proyecto Crear Otra: Limpiar formulario, permanecer en modal para creación por lotes

Qué Sucede

1. Historia creada con estado "Abierta"
2. Aparece en backlog lista para planificación de sprint
3. Vinculada a épica si se seleccionó
4. Equipo notificado via feed de actividad del proyecto
5. Sincronización en tiempo real en las vistas de todos los miembros del equipo

Atajos de Teclado

Mejores Prácticas

Escribe Independientemente

Cada historia debe ser completable sin dependencias:

Dependiente (evitar):

Como usuario, quiero ver el dashboard que fue creado en US-123

Independiente (preferido):

Como usuario, quiero ver métricas clave en mi dashboard

Dimensiona Apropiadamente

Las historias deben completarse dentro de un sprint. Si son más grandes:

• Divide en múltiples historias
• Usa épica para agrupar historias relacionadas
• Considera el patrón "Como usuario, quiero [parte 1]"

Incluye Criterios de Aceptación

Cada historia necesita condiciones comprobables. Esto no es opcional—es cómo tu equipo sabe cuándo el trabajo está completo.

Inversión de tiempo: 5 minutos escribiendo criterios ahorra 2 horas de preguntas de clarificación después.

Conecta con Épicas

Las historias huérfanas crean caos en la planificación. Incluso "mejoras misceláneas" merecen una épica para agrupar.

Patrones Comunes

Historia de Característica

Como [tipo de usuario],
Quiero [capacidad],
Para que [valor de negocio].

Conversión de Bug a Historia

Como [usuario afectado],
Quiero que [cosa rota] se arregle,
Para que [impacto cuando se arregle].

Historia Técnica

Como desarrollador,
Quiero [mejora técnica],
Para que [beneficio de mantenimiento/rendimiento].

Historia de Investigación

Como product manager,
Quiero entender [lo desconocido],
Para que [decisiones futuras].

Solución de Problemas

El modal no abre:

• Verifica permisos del proyecto (necesitas createuserstories)
• Asegura que el proyecto está seleccionado en la navegación
• Intenta actualizar la página

El modo IA no genera:

• Proporciona más detalle en la descripción
• Incluye contexto sobre tipo de usuario y objetivo
• Verifica conexión de red

No puedo seleccionar épica:

• Las épicas cargan después de la selección de proyecto
• Crea nueva épica si no existe ninguna
• Verifica que la épica no esté archivada

Desplegable de prioridad vacío:

• Las prioridades vienen de la configuración del proyecto
• El admin puede añadir prioridades en Configuración del Proyecto → Prioridades