Saltar al contenido

Plantilla de reporte de bugs para Jira, GitHub y Linear

Una plantilla de reporte de bugs gratuita para copiar y pegar, versiones para GitHub, Linear y Jira, un formulario de GitHub y un ejemplo completo.

Una plantilla de reporte de bugs es un conjunto fijo de campos que hace que cada reporte responda a las mismas preguntas: qué falló, dónde, cómo reproducirlo, qué debería haber pasado y qué pruebas lo demuestran. La plantilla de abajo incluye título, resumen, entorno, pasos para reproducir, resultado esperado y resultado real, frecuencia, severidad, adjuntos y logs. Cópiala en tu gestor de incidencias, en un formulario de soporte o en un mensaje de chat y rellena los huecos. Más abajo tienes versiones listas para GitHub, Linear y Jira, incluido un formulario de incidencia de GitHub.

Las plantillas existen porque los desarrolladores pierden la mayor parte del tiempo en los detalles que faltan, no en la corrección. Un reporte con los pasos exactos, la versión del navegador y el error de consola a menudo se puede corregir el mismo día. Un reporte que dice «el checkout está roto» se convierte en un largo hilo de preguntas.

La plantilla

Título: [Qué está roto] al [acción] en [página o función]

Resumen
Una o dos frases en lenguaje sencillo. Qué pasó y a quién afecta.

Entorno
- URL:
- Navegador y versión:
- Sistema operativo:
- Dispositivo / tamaño de pantalla:
- Versión o build de la app (si se conoce):
- Cuenta / rol / usuario de prueba:
- Fecha y hora en que ocurrió (con zona horaria):

Pasos para reproducir
1.
2.
3.

Resultado esperado
Lo que debería haber pasado.

Resultado real
Lo que pasó en su lugar. Incluye el mensaje de error exacto, copiado como texto.

Frecuencia
Siempre / A veces (unas X de cada Y veces) / Ocurrió una vez

Severidad
Bloqueante / Mayor / Menor / Estético

Alternativa
Cualquier forma de evitarlo, o «No se ha encontrado».

Adjuntos
- Captura o grabación de pantalla:
- Errores de consola:
- Petición de red que falló (URL, estado, respuesta):
- Archivo HAR (saneado), si se pide:

Notas
Cualquier otra cosa: cuándo empezó, qué cambió hace poco, tickets relacionados.

Cómo rellenar cada campo

Título

El título es lo que la gente repasa en una lista de cincuenta tickets, así que hazlo concreto. Un patrón útil es «qué está roto» más «cuándo» más «dónde». «El botón Pagar sigue desactivado tras introducir una tarjeta válida en el checkout» es mejor que «Bug en el checkout». Evita palabras como «urgente» o «roto» por sí solas; eso ya lo expresa el campo de severidad.

Resumen

Una o dos frases que un compañero sin perfil técnico pueda entender. Di a quién afecta si lo sabes: a todos los usuarios, solo a los administradores, solo a quienes usan Safari, solo a un cliente.

Entorno

Muchos bugs dependen del navegador, del dispositivo, de la cuenta o de los datos. Apunta la URL exacta, el nombre y la versión del navegador, el sistema operativo y la cuenta o el rol que usaste. Si la app muestra un número de versión o de build, inclúyelo. La hora del fallo, con tu zona horaria, permite al desarrollador encontrar las entradas correspondientes en los logs del servidor.

Pasos para reproducir

Este es el campo más importante. Numera los pasos, empieza desde un estado conocido («con sesión iniciada como un usuario con el carrito vacío») e incluye los datos exactos que usaste. Escribe una acción por paso. Si no pudiste reproducirlo una segunda vez, dilo y describe lo que hiciste la primera vez con la mayor precisión posible.

Resultado esperado y resultado real

Ponlos uno al lado del otro para que la diferencia salte a la vista. Copia los mensajes de error como texto en lugar de parafrasearlos; el desarrollador buscará esa cadena exacta en el código. «No pasa nada» es un resultado real válido, pero añade lo que comprobaste, por ejemplo «ningún mensaje de error, el botón sigue activo».

Frecuencia

Los bugs que pasan «siempre» son los más fáciles de corregir. Los que pasan «a veces» necesitan más datos, así que estima la proporción («3 de cada 10 intentos») y anota cualquier cosa que parezca influir, como una conexión lenta o un archivo grande.

Severidad

La severidad trata del impacto, no de lo molesto que estés. Una escala habitual:

SeveridadSignificadoEjemplo
BloqueanteEl flujo principal es imposible, sin alternativaNadie puede iniciar sesión
MayorUna función importante está rota o los datos son incorrectos, la alternativa es penosaLas facturas muestran un total incorrecto
MenorLa función funciona con un pequeño problema o una alternativa sencillaLa ordenación se reinicia al recargar la página
EstéticoProblema visual, sin impacto funcionalEl texto del botón se solapa en pantallas pequeñas

La prioridad, que decide cuándo se corrige, suele fijarla el equipo responsable del backlog, no quien reporta.

Alternativa

Una alternativa le dice al equipo lo urgente que es la corrección y ayuda a soporte a responder a los clientes mientras tanto.

Adjuntos y logs

Las pruebas son lo que más tiempo ahorra. Adjunta una captura con la zona del problema marcada o una grabación de pantalla corta que muestre los pasos. En aplicaciones web, añade los errores de consola y la petición de red que falla. Nuestras guías sobre cómo exportar los logs de consola en Chrome y cómo capturar el tráfico de red en Chrome explican cómo hacerlo. Si alguien te pide un archivo HAR, sigue cómo obtener un archivo HAR y límpialo antes con el sanitizador de HAR, porque los archivos HAR contienen cookies y tokens.

Un ejemplo completo

Título: El botón Pagar sigue desactivado tras introducir una tarjeta válida en el checkout

Resumen
En la página de checkout, el botón Pagar nunca se puede pulsar después de
introducir una tarjeta de prueba válida, así que no se puede hacer el pedido.
Visto en Chrome y Edge.

Entorno
- URL: https://staging.example.com/checkout
- Navegador y versión: Chrome 154 en Windows 11; también Edge 154
- Dispositivo / tamaño de pantalla: portátil, 1920x1080
- Versión o build de la app: web 4.18.0 (pie de página)
- Cuenta / rol / usuario de prueba: [email protected], cliente estándar
- Fecha y hora: 2026-11-10 14:32 CET

Pasos para reproducir
1. Inicia sesión como [email protected].
2. Añade «Plan Starter, anual» al carrito.
3. Ve a /checkout.
4. Introduce la tarjeta de prueba 4242 4242 4242 4242, caducidad 12/30, CVC 123.
5. Haz clic fuera del campo de la tarjeta.

Resultado esperado
El botón Pagar se activa y muestra «Pagar 120,00 $».

Resultado real
El botón Pagar sigue gris y desactivado. No aparece ningún mensaje de error.
La consola muestra: Uncaught TypeError: Cannot read properties of
undefined (reading 'postalCode') at validateCard (checkout.js:214)

Frecuencia
Siempre (5 de 5 intentos)

Severidad
Bloqueante: los clientes no pueden pagar

Alternativa
No se ha encontrado. Funciona en el build de producción 4.17.2.

Adjuntos
- Grabación de pantalla: enlace en los comentarios
- Errores de consola: checkout-console.log
- Red: POST /api/cart/validate devolvió 200; ningún otro fallo

Notas
Empezó después del despliegue de esta mañana en staging.

Fíjate en qué hace que este ejemplo funcione. Los pasos parten de una cuenta conocida. La tarjeta de prueba está indicada. El error de consola se cita tal cual. Quien reporta comprobó otro navegador y el build anterior, lo que ya acota la causa al último cambio.

Versiones más cortas

No todos los bugs necesitan todos los campos. Para un mensaje rápido en el chat del equipo, basta con una versión compacta:

Bug: [título]
Dónde: [URL], [navegador/SO]
Pasos: 1) ... 2) ... 3) ...
Esperado: ...
Real: ...
Pruebas: [captura / grabación / error de consola]

Los equipos de atención al cliente que reenvían el reporte de un usuario deberían añadir el ID de cuenta del cliente, el enlace al ticket y las palabras del propio cliente, e indicar qué partes han reproducido ellos mismos.

En las ejecuciones de pruebas de QA, añade el ID del caso de prueba y el build probado para que el bug quede vinculado a la prueba que lo encontró.

Plantillas para GitHub, Linear y Jira

La plantilla en texto plano funciona en cualquier sitio. Si tu gestor de incidencias muestra Markdown, esta versión mantiene legibles los encabezados y las checklists:

## Resumen
<!-- Una o dos frases: qué pasó y a quién afecta. -->

## Entorno
- URL:
- Navegador y versión:
- Sistema operativo:
- Versión o build de la app:
- Cuenta / rol:

## Pasos para reproducir
1.
2.
3.

## Resultado esperado

## Resultado real
<!-- Pega el mensaje de error exacto como texto. -->

## Frecuencia
<!-- Siempre / A veces (X de cada Y) / Una vez -->

## Severidad
<!-- Bloqueante / Mayor / Menor / Estético -->

## Pruebas
- [ ] Captura o grabación de pantalla
- [ ] Errores de consola
- [ ] Petición de red que falló

GitHub Issues

Guarda la versión en Markdown como .github/ISSUE_TEMPLATE/bug_report.md en tu repositorio, con una cabecera corta para que GitHub la ofrezca en el selector de «New issue»:

---
name: Reporte de bug
about: Algo está roto
labels: bug
---

GitHub también admite formularios de incidencia (issue forms), que convierten la plantilla en campos con etiqueta que nadie puede saltarse. Guarda esto como .github/ISSUE_TEMPLATE/bug_report.yml:

name: Reporte de bug
description: Algo está roto
labels: ["bug"]
body:
  - type: textarea
    id: summary
    attributes:
      label: Resumen
      description: ¿Qué pasó y a quién afecta?
    validations:
      required: true
  - type: input
    id: url
    attributes:
      label: URL
  - type: input
    id: environment
    attributes:
      label: Navegador, sistema operativo y versión de la app
      placeholder: Chrome 154 en macOS 26, web 4.18.0
  - type: textarea
    id: steps
    attributes:
      label: Pasos para reproducir
      value: |
        1.
        2.
        3.
    validations:
      required: true
  - type: textarea
    id: expected
    attributes:
      label: Resultado esperado
    validations:
      required: true
  - type: textarea
    id: actual
    attributes:
      label: Resultado real
      description: Pega el mensaje de error exacto como texto.
    validations:
      required: true
  - type: dropdown
    id: severity
    attributes:
      label: Severidad
      options:
        - Bloqueante
        - Mayor
        - Menor
        - Estético
  - type: textarea
    id: evidence
    attributes:
      label: Capturas, grabación y logs
      description: Arrastra archivos aquí o pega el enlace a una grabación.

Linear

Linear tiene plantillas de incidencia en los ajustes de cada equipo. Crea una llamada «Bug», pega la versión en Markdown en su descripción y asigna la etiqueta Bug y el estado de triaje del equipo, para que cada reporte empiece con los mismos campos.

Jira

En Jira, pega la versión en texto plano o en Markdown en la descripción de un nuevo Bug. Jira Cloud no tiene una descripción por defecto integrada para cada tipo de incidencia, así que los equipos que quieren la plantilla ya rellenada usan una app de plantillas de incidencia del Atlassian Marketplace. El enlace a una grabación de pantalla con logs de consola y de red va en la descripción o en un comentario.

Errores que evita la plantilla

Una plantilla es sobre todo una checklist contra los mismos pocos errores:

  • Varios bugs en un mismo reporte. Un ticket por problema, para que cada uno se pueda corregir, probar y cerrar por separado.
  • Errores parafraseados. «Decía algo de permisos» no se puede buscar. El mensaje exacto, sí.
  • Falta el punto de partida. Los pasos que empiezan a mitad de un flujo solo le sirven a quien los escribió.
  • Opiniones en lugar de observaciones. «La API está rota» es una suposición. «POST /api/orders devolvió 500» es un hecho que el desarrollador puede comprobar.
  • Secretos en los adjuntos. Las capturas de paneles de administración, los archivos HAR y los logs de consola pueden incluir tokens y datos de clientes. Recorta, difumina o limpia antes de adjuntar.

Conviértela en la opción por defecto de tu equipo

La mayoría de los gestores de incidencias permiten guardar una descripción por defecto o una plantilla de incidencia, de modo que cada bug nuevo empieza con estos encabezados. Mantén la plantilla lo bastante corta como para que la gente la rellene de verdad. Si un campo está vacío en la mayoría de los reportes, quítalo. Si los desarrolladores siguen haciendo la misma pregunta una y otra vez, añade un campo para ella.

Deja que la herramienta rellene los campos técnicos

Los campos que más se saltan son los técnicos: la versión del navegador, los errores de consola, la petición que falla. Midge, una extensión de Chrome gratuita, los adjunta automáticamente a una grabación de pantalla o a una captura, así que quien reporta solo escribe el título, los pasos y el resultado esperado. Cada grabación incluye logs de consola, peticiones de red, acciones del usuario y datos del dispositivo. Las contraseñas, números de tarjeta, tokens y cookies se ocultan en tu navegador antes de que nada salga de tu dispositivo. Un reporte va directamente a Jira, Linear, GitHub Issues o Slack, o se comparte como un enlace que puedes pegar en cualquier sitio.

Guías relacionadas

Preguntas frecuentes

¿Qué debe incluir una plantilla de reporte de bugs?

Un título claro, el entorno (URL, navegador, sistema operativo, versión de la app, cuenta), pasos numerados para reproducir, el resultado esperado, el resultado real, con qué frecuencia ocurre, la severidad y pruebas como capturas, un vídeo, logs de consola y peticiones de red.

¿Puedo usar esta plantilla en Jira, Linear o GitHub Issues?

Sí. Es texto plano con encabezados compatibles con Markdown, así que puedes pegarla en cualquier gestor de incidencias. GitHub y Linear también permiten guardarla como plantilla de incidencia, y Jira con una app del Marketplace.

¿Dónde van las plantillas de incidencia de GitHub?

En la carpeta .github/ISSUE_TEMPLATE del repositorio. Un archivo .md añade una plantilla en Markdown, y un archivo .yml añade un formulario de incidencia con campos obligatorios. GitHub las muestra cuando alguien abre una nueva incidencia.

¿Qué diferencia hay entre severidad y prioridad?

La severidad describe cuánto afecta el bug al producto o a los usuarios. La prioridad describe cuándo lo va a corregir el equipo. Un bug grave en una pantalla de administración que casi no se usa puede tener menos prioridad que un bug estético en la página de precios.

¿Tengo que rellenar todos los campos?

No. El título, los pasos y los resultados esperado y real son imprescindibles. Rellena el resto cuando lo sepas, y escribe «desconocido» en lugar de adivinar.