Reportar bugs como un profesional: la IA te arregla lo que le sabes describir

Un buen reporte es la mitad de la corrección

Cuando reportas un bug a una IA (o a un equipo humano), no estás «quejándote»: estás entregando un caso de prueba. Un reporte incompleto genera adivinanzas y regresiones. Uno completo permite corregir sin tocar nada más. La calidad de tu reporte define la calidad del arreglo.

Las siete partes de un reporte profesional

Si falta «esperado», la IA no sabe qué es «arreglado».
Parte	Qué contiene	Error común
Título	Una frase que resume el fallo	«no funciona» / «bug raro»
Entorno	Dónde pasa: navegador, servidor, versión, datos	omitirlo y asumir que «en mi máquina» basta
Pasos	Cómo reproducirlo, en orden y numerado	saltarse un paso clave
Esperado	Qué debió ocurrir según tu requisito	no decir qué querías lograr
Real	Qué ocurrió de verdad	interpretar en vez de describir
Evidencia	Mensaje literal, captura, log, petición	decir «sale error» sin copiarlo
Frecuencia	Siempre, a veces, o con un dato concreto	no indicar si es intermitente

De vago a profesional

El mismo bug, dos reportes

Reporte vago
«El login está roto, arréglalo.» La IA no sabe ni dónde ni cuándo.
Reporte profesional
Cadena exacta, entorno, esperado vs real y log: la IA reproduce y corrige.

La plantilla lista para usar

Un reporte que la IA puede cerrar sin preguntas

texto

TITULO: Al guardar un contacto sin email, la app muestra 500 en vez del aviso de campo obligatorio.\nENTORNO: Chrome 1xx · backend en /contactos POST · datos de prueba: nombre "Ana", email vacio.\nPASOS:\n1. Abrir Nuevo contacto.\n2. Escribir solo el nombre.\n3. Pulsar Guardar.\nESPERADO: aviso "El email es obligatorio" y el formulario sigue abierto.\nREAL: pantalla de error 500; el contacto no se guarda.\nEVIDENCIA: log -> "ERROR validacion: email era null; se llamo .trim() sobre null".\nFRECUENCIA: siempre con email vacio; con email valido funciona.

Cada parte elimina una suposición. Copia esta plantilla y rellénala: es tu seguro contra el «creí que ya estaba arreglado».

Prueba

Tu reporte dice «la app falla al guardar». ¿Qué pieza crítica falta para que la IA corrija sin adivinar?

Indicar la frecuencia (siempre / a veces / con un dato concreto) ayuda a distinguir un fallo lógico de uno intermitente.

Detecta el reporte que no sirve

Un alumno reporta así a la IA. Señala la línea que hace imposible reproducir el bug:

Marca la línea o las líneas con error y pulsa Comprobar.

Elige un fallo real de tu proyecto y escríbelo con las siete partes. Entrégaselo a la IA y observa si necesita hacerte preguntas para corregirlo: cero preguntas es señal de un reporte profesional.

La madurez de un builder se ve en cómo reporta, no solo en cómo pide.

Tu texto se guarda sólo en este dispositivo.