Issue
Una tarjeta en GitHub para registrar un problema, una mejora o una tarea pendiente de un proyecto, con su hilo de conversación.
✦Apagada: responde bien la pregunta del final para encenderla
También lo verás como: issues · incidencia · incidencias · ticket · tickets
Analogía
Un post-it en el tablón de la obra, pero con número, estado (abierto/cerrado) y comentarios debajo.
Cómo se usa en un proyecto real
- Cada cosa que pide el cliente (negocio) → un issue. "Cambiar el horario de verano", "El formulario no envía en iPhone".
- Cada issue tiene un número (
#3). Si un commit que llega amaindiceCloses #3en el mensaje, GitHub cierra el issue solo y lo enlaza con el cambio. - Desde la terminal:
gh issue create,gh issue list.
Por qué te interesa con IA
Un issue bien escrito —qué pasa, qué se espera, cómo comprobar que está resuelto— es casi un prompt listo para delegar. Escribir buenos issues es escribir buenas instrucciones (Fases 2 y 13).
Un paso más: anatomía de un buen issue
Un issue útil responde a tres preguntas, y se nota enseguida cuando falta alguna:
- Qué pasa (o qué se quiere): "El botón de WhatsApp no abre el chat en iPhone".
- Qué se esperaba: "Que abra WhatsApp con el número del restaurante".
- Cómo se comprueba que está resuelto: "En un iPhone, al tocar el botón se abre el chat con el mensaje escrito".
Fíjate en que el punto 3 es un criterio de aceptación. Por eso un issue bien escrito se convierte casi sin cambios en una tarea para la IA.
Además sirve de memoria: dentro de un año, el issue #14 cuenta por qué se cambió aquello, quién lo pidió y qué se decidió.
¿Para qué sirve un issue?
Ver también
pull request · GitHub · commit