Qué debe contener un ticket
Describe el problema, la persona o proceso afectado, el comportamiento esperado y el alcance. Añade fuentes relevantes, dependencias y criterios de aceptación verificables. Marca las decisiones abiertas y quién debe resolverlas. La longitud no mide la calidad: un error pequeño no necesita una plantilla extensa, mientras que una integración arriesgada sí requiere más contexto.
Función: exportación de clientes
Antes: «Añadir un botón para exportar clientes». No aclara permisos, filtros, formato ni datos.
Después: «En Clientes, una persona autorizada debe poder exportar la lista filtrada, incluidas filas fuera de la página visible. Quedan fuera los envíos por correo y las exportaciones recurrentes. Antes de empezar, Product Ownership confirmará qué permiso existente se aplica, qué columnas con datos personales se permiten y qué sucede si no hay resultados. Se enlazan la documentación de la API y el diseño de los estados de carga y error». Los criterios definitivos vendrán después de estas decisiones.
Error: el formulario no guarda siempre
Antes: «Guardar falla a veces».
Después: «En pruebas, editar la dirección de un cliente devuelve ocasionalmente HTTP 409. Esperado: nueva dirección y confirmación. Real: dirección anterior sin mensaje de error. Pasos: abrir un cliente, cambiar la dirección y pulsar Guardar dos veces en cinco segundos; ocurrió en tres de cinco intentos. Se adjuntan el identificador de petición y la versión del navegador». Permite investigar sin inventar una causa.
Tarea técnica: actualizar el framework
Antes: «Actualizar Laravel».
Después: «Actualizar la aplicación desde Laravel 10 hasta una versión acordada de Laravel 11. Antes, confirmar la compatibilidad de PHP y paquetes. Mantener los contratos de la API pública, actualizar el archivo de dependencias y ejecutar pruebas unitarias y de integración. En staging, comprobar acceso y creación de facturas. Documentar paquetes incompatibles para una decisión aparte». No hace falta convertirla en una historia de usuario artificial.
Cambio de interfaz: mostrar un error junto al campo
Antes: «Hacer el formulario más intuitivo».
Después: «En móviles se pasa por alto el error del código postal obligatorio porque aparece debajo del botón de compra. Mostrarlo junto al campo según el patrón existente y trasladar allí el foco. Con una entrada válida, continuar la compra. Confirmar texto y diseño antes de implementar».
Usa la lista de preparación para detectar lagunas. Redacta resultados confirmados con la guía de criterios y utiliza la herramienta de preparación de tareas antes del refinamiento.