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
| 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]
Esta actividad interactiva ('Explicacion visual') requiere el motor completo de Lumbre. El contenido estatico se muestra arriba; para la experiencia interactiva, visita la version online de este objeto.
La plantilla lista para usar
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.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:
- TITULO: error 500 al guardar contacto sin email.
- ENTORNO: Chrome, endpoint POST /contactos, datos de prueba con email vacio.
- PASOS: (en blanco, «ya tú sabes cómo es eso»).
- EVIDENCIA: log del servidor con la traza del fallo.
Identifica la linea con error.
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.