Odiaba crear tickets (hasta que probé la IA)

Ilustración generada por IA de un ordenador y una lista de tareas para acompañar al post "Crear mejores tickets con IA" de Orbitant

Odio crear tickets. No sé qué valor aporta escribir una explicación extensa.
Sé lo que hay que hacer, así que siento que estoy perdiendo un tiempo valioso de desarrollo dedicándole tanto esfuerzo a anotar todos los detalles.

DAVID RUEDA
Software Engineer

¿Te suena familiar? En algún momento, si has trabajado como desarrollador de software, la creación de tickets ha sido uno de los principales temas de discusión en sesiones de refinamiento y retrospectivas. Muchos tendemos a pensar que los tickets descriptivos son una pérdida de tiempo. Con versiones más simples podríamos hacer aquello para lo que se supone que sirven los tickets: organizar el trabajo.

Pero… ¿cuáles son las desventajas de los tickets más simples? Enumeremos algunas:

  • Colaboración más difícil: ¿Qué pasa si tu compañero abre un ticket, pero tú eres el encargado de implementarlo? ¿Qué pasa si no tienes el contexto en el que se creó ese ticket?
  • Trazabilidad: ¿Qué decisiones se han tomado?
  • Definición de «Hecho» (DoD) difusa: ¿Estás seguro de que realmente se cumplen los criterios de aceptación de ese ticket? ¿Te falta algo?
  • Valor proporcionado: ¿El ticket es realmente valioso para el usuario? ¿Mejorará su experiencia?

Estoy seguro de que cualquiera podría enumerar algunas desventajas más con facilidad. Sin embargo, necesitamos encontrar un equilibrio entre la descripción del ticket y el tiempo dedicado a crearlo. Hoy en día, la Inteligencia Artificial Generativa es una herramienta casi indispensable que está integrada en todos nuestros flujos de trabajo. Y la creación de tickets no debería ser la excepción.

¿La buena noticia? Puedes crear mejores tickets con IA sin sacrificar velocidad ni contexto. Las herramientas modernas de dictado cierran la brecha entre tomar notas rápidas y la documentación completa.

Crear tickets con Superwhisper

El dictado impulsado por IA ayuda a los equipos de desarrollo a crear mejores tickets con IA capturando el contexto hablado, estructurándolo automáticamente y estandarizando formatos en todo el backlog.

Superwhisper es un «dictado ultrarrápido impulsado por IA que entiende lo que quieres decir y cómo quieres decirlo». Es capaz de traducir tus ideas en formatos predefinidos (como correos electrónicos formales o mensajes) o formatos personalizados (abordaremos esto en este artículo) que se pueden definir mediante una serie de reglas y llevarlos a las aplicaciones que necesites.

¿Y cómo se aplica esto a la creación de tickets? Con un poco de creatividad, ¡podrás transformar fácilmente ideas de funcionalidades o requisitos de negocio en tickets detallados en segundos!

Configurar Superwhisper

  1. Descarga Superwhisper desde su página principal. Es compatible con Windows, MacOS e iOS.
  2. Ve a Modes (Modos). En esta pestaña, podrás definir modos personalizados o predefinidos y en qué aplicaciones (e incluso páginas) se aplicarán estos modos.
Pantalla de Modos de Superwhisper que enumera los modos existentes y las opciones para crear o gestionar modos personalizados y predefinidos
  • Crea un nuevo modo haciendo clic en el botón ‘Create mode‘ (Crear modo) y seleccionando ‘Custom‘ (Personalizado).
Cuadro de diálogo de Superwhisper después de hacer clic en Crear modo, mostrando la opción Personalizado para crear un nuevo modo personalizado
  • Define tus reglas. Este es el prompt que he estado usando hasta ahora, que ha funcionado muy bien. ¡Siéntete libre de modificarlo para satisfacer las necesidades de tu equipo o personales!
You are a Senior Product Owner.

I will describe a software requirement in Spanish.  // Añade aquí tu idioma materno! 
Your task is to:
1. Understand the requirement.
2. Translate it into clear Spanish. // O el idioma en el que desees crear el ticket!
3. Rewrite it as a backlog ticket using the exact template below.

Rules:
- Use a clear USER TYPE.
- Acceptance criteria must be written as simple bullet points, not Gherkin.
- Each criterion must be testable and explicit.
- Do not invent requirements.

Template:

> [!IMPORTANT]
> _AS A_ `<USER TYPE>`
> _I WANT TO_ <user goal>
> _SO THAT_ <business value>

### Acceptance Criteria

- ...
- ...
- ...

### Technical Approach (optional)

- ...
  • Define cuándo quieres aplicar estas reglas. Por ejemplo, si usas el navegador Brave y tu plataforma de tickets es Github, puedes definirlo fácilmente en la Configuración Avanzada (en ‘Activate when using’ – Activar cuando se use).
Pantalla de Modos de Superwhisper que muestra cómo acceder a la Configuración Avanzada haciendo clic en el icono de engranaje en la parte inferior derecha al expandir los detalles del Modo Personalizado y Pantalla de Modos de Superwhisper que muestra la sección de Configuración Avanzada y el campo "Activate when using" para elegir cuándo se aplica el modo

Creando tickets con IA: Ejemplo práctico

Imagina que estás trabajando en una aplicación SaaS que muestra información sobre los documentos que subiste, en formato de tabla. Ahora mismo, se muestra el campo Fecha de vencimiento y está ocupando mucho espacio de la tabla cuando no se necesita inmediatamente. Quieres crear un ticket para eliminarlo.

  1. Usas tu atajo para abrir Superwhisper.
  2. Dices: «No quiero que los usuarios vean la fecha de vencimiento en la tabla de documentos»
  3. Superwhisper devuelve lo siguiente:
> [!IMPORTANT]
> _AS A_ `Usuario final`
> _I WANT TO_ no ver la columna de fecha de caducidad en la tabla de documentos
> _SO THAT_ el listado de documentos no muestre fechas de caducidad a los usuarios

### Acceptance Criteria

- La tabla de documentos en la interfaz ya no muestra una columna etiquetada como "Fecha de caducidad", "Fecha de vencimiento", "Due Date" o similar.
- Ningún valor de fecha de caducidad es visible en ninguna fila de la tabla de documentos para ningún documento.
- Eliminar la columna no elimina ni altera otras columnas o datos en la tabla de documentos.
- El diseño del encabezado de la tabla se ajusta correctamente (sin espacio de columna vacío) y se alinea con las columnas restantes en los puntos de interrupción de escritorio y móvil compatibles con el producto.
- La ordenación, el filtrado y la paginación en la tabla de documentos siguen funcionando como antes para las columnas restantes.
- Si hay un panel de detalles/vista previa accesible desde la tabla, todavía muestra la fecha de caducidad si ese es un requisito separado; de lo contrario, indica si la fecha de caducidad también debe ocultarse allí (no se requiere cambio según este ticket).
- Los cambios están cubiertos por una comprobación visual de la interfaz y una prueba end-to-end automatizada que confirma que la columna de fecha de caducidad no está presente.

### Technical Approach (optional)

- Eliminar u ocultar la columna de fecha de caducidad del componente de tabla y cualquier configuración de columna de tabla.
- Actualizar el CSS/diseño de la tabla para eliminar el espacio y garantizar un comportamiento responsive en las ventanas compatibles.
- Actualizar las pruebas frontend y añadir una aserción end-to-end para confirmar la ausencia de la columna.
- Asegurarse de que las APIs backend sigan devolviendo la fecha de caducidad (si se necesita en otro lugar); no modificar la API a menos que sea requerido por decisiones de producto.

Voilà ✨ ¡Has creado tu ticket refinado!

Si te has peleado con la calidad de los tickets o el tiempo dedicado a la documentación, crear mejores tickets con IA se convierte en una solución práctica. Herramientas como Superwhisper transforman el proceso de un impuesto a la productividad en una inversión ligera en la claridad del equipo.

Escribir tickets no tiene que ser un impuesto a la productividad. Con las herramientas adecuadas y un poco de automatización, se convierte en una inversión ligera en claridad, colaboración y velocidad a largo plazo. Si la IA puede ayudarnos a dedicar menos tiempo a documentar y más tiempo a construir, eso no es sobrecarga, es apalancamiento.

DAVID RUEDA
Software Engineer

Sigue nuestro viaje construyendo agentes IA desde dentro