Triaje de Issue
Investiga un problema reportado, encuentra su causa raíz y crea un issue de GitHub con un plan de corrección TDD. Este es un flujo de trabajo mayormente autónomo: minimiza las preguntas al usuario.
Proceso
1. Capturar el problema
Obtén una breve descripción del problema del usuario. Si no la han proporcionado, haz UNA pregunta: "¿Cuál es el problema que estás viendo?"
NO hagas preguntas de seguimiento todavía. Comienza a investigar de inmediato.
2. Explorar y diagnosticar
Usa la herramienta Agent con subagent_type=Explore para investigar profundamente el código base. Tu objetivo es encontrar:
- Dónde se manifiesta el error (puntos de entrada, interfaz de usuario, respuestas de API)
- Qué ruta de código está involucrada (sigue el flujo)
- Por qué falla (la causa raíz, no solo el síntoma)
- Qué código relacionado existe (patrones similares, pruebas, módulos adyacentes)
Examina:
- Archivos fuente relacionados y sus dependencias
- Pruebas existentes (qué está probado, qué falta)
- Cambios recientes en los archivos afectados (
git logen archivos relevantes) - Manejo de errores en la ruta de código
- Patrones similares en otras partes del código base que funcionan correctamente
3. Identificar el enfoque de corrección
Basándote en tu investigación, determina:
- El cambio mínimo necesario para corregir la causa raíz
- Qué módulos/interfaces están afectados
- Qué comportamientos deben ser verificados mediante pruebas
- Si se trata de una regresión, una funcionalidad faltante o un defecto de diseño
4. Diseñar el plan de corrección TDD
Crea una lista concreta y ordenada de ciclos ROJO-VERDE. Cada ciclo es una porción vertical:
- ROJO: Describe una prueba específica que capture el comportamiento roto o faltante
- VERDE: Describe el cambio de código mínimo para que esa prueba pase
Reglas:
- Las pruebas verifican el comportamiento a través de interfaces públicas, no detalles de implementación
- Una prueba a la vez, porciones verticales (NO todas las pruebas primero, luego todo el código)
- Cada prueba debe sobrevivir a refactorizaciones internas
- Incluye un paso final de refactorización si es necesario
- Durabilidad: Solo sugiere correcciones que sobrevivan a cambios radicales en el código base. Describe comportamientos y contratos, no estructura interna. Las pruebas verifican resultados observables (respuestas de API, estado de la interfaz de usuario, efectos visibles para el usuario), no estado interno. Una buena sugerencia se lee como una especificación; una mala se lee como un diff.
5. Crear el issue de GitHub
Crea un issue de GitHub usando gh issue create con la plantilla a continuación. NO le pidas al usuario que revise antes de crearlo; simplemente créalo y comparte la URL.
Problema
Una descripción clara del error o problema, incluyendo:
- Qué ocurre (comportamiento real)
- Qué debería ocurrir (comportamiento esperado)
- Cómo reproducirlo (si aplica)
Análisis de Causa Raíz
Describe lo que encontraste durante la investigación:
- La ruta de código involucrada
- Por qué falla el código actual
- Factores contribuyentes
NO incluyas rutas de archivo específicas, números de línea o detalles de implementación que estén acoplados al diseño actual del código. Describe módulos, comportamientos y contratos en su lugar. El issue debe seguir siendo útil incluso después de refactorizaciones importantes.
Plan de Corrección TDD
Una lista numerada de ciclos ROJO-VERDE:
-
ROJO: Escribe una prueba que [describe el comportamiento esperado] VERDE: [Cambio mínimo para que pase]
-
ROJO: Escribe una prueba que [describe el siguiente comportamiento] VERDE: [Cambio mínimo para que pase]
...
REFACTORIZAR: [Cualquier limpieza necesaria después de que todas las pruebas pasen]
Criterios de Aceptación
- Criterio 1
- Criterio 2
- Todas las pruebas nuevas pasan
- Las pruebas existentes aún pasan
Después de crear el issue, imprime la URL del issue y un resumen de una línea de la causa raíz.