Triage
Mueve los issues del rastreador de issues del proyecto a través de una pequeña máquina de estados con roles de triaje.
Cada comentario o issue publicado en el rastreador durante el triaje debe comenzar con este descargo de responsabilidad:
> *Esto fue generado por IA durante el triaje.*
Documentos de referencia
- AGENT-BRIEF.md — cómo escribir briefs duraderos para agentes
- OUT-OF-SCOPE.md — cómo funciona la base de conocimiento
.out-of-scope/
Roles
Dos roles de categoría:
bug— algo está rotoenhancement— nueva funcionalidad o mejora
Cinco roles de estado:
needs-triage— el mantenedor necesita evaluarloneeds-info— esperando que el reportero proporcione más informaciónready-for-agent— completamente especificado, listo para un agente AFKready-for-human— necesita implementación humanawontfix— no se va a aplicar
Cada issue triaje debe llevar exactamente un rol de categoría y un rol de estado. Si hay conflictos entre roles de estado, márcalo y pregunta al mantenedor antes de hacer cualquier otra cosa.
Estos son nombres canónicos de roles — las etiquetas reales en el rastreador de issues pueden diferir. Deberías tener el mapeo disponible; si no, ejecuta /setup-matt-pocock-skills.
Transiciones de estado: un issue sin etiqueta normalmente va a needs-triage primero; desde allí pasa a needs-info, ready-for-agent, ready-for-human o wontfix. needs-info vuelve a needs-triage cuando el reportero responde. El mantenedor puede anular en cualquier momento — señala transiciones que parezcan inusuales y pregunta antes de proceder.
Invocación
El mantenedor invoca /triage y describe lo que quiere en lenguaje natural. Interpreta la solicitud y actúa. Ejemplos:
- "Muéstrame todo lo que necesita mi atención"
- "Veamos el #42"
- "Mueve el #42 a ready-for-agent"
- "¿Qué está listo para que los agentes lo tomen?"
Mostrar lo que necesita atención
Consulta el rastreador de issues y presenta tres grupos, del más antiguo al más reciente:
- Sin etiqueta — nunca triaje.
needs-triage— evaluación en curso.needs-infocon actividad del reportero desde las últimas notas de triaje — necesita reevaluación.
Muestra recuentos y un resumen de una línea por issue. Deja que el mantenedor elija.
Triaje de un issue específico
-
Recopila contexto. Lee el issue completo (cuerpo, comentarios, etiquetas, reportero, fechas). Analiza cualquier nota de triaje anterior para no volver a preguntar lo ya resuelto. Explora el código usando el glosario de dominio del proyecto, respetando las ADR en el área. Lee
.out-of-scope/*.mdy resalta cualquier rechazo previo que se parezca a este issue. -
Recomienda. Informa al mantenedor tu recomendación de categoría y estado con razonamiento, además de un breve resumen del código relevante para el issue. Espera instrucciones.
-
Reproduce (solo bugs). Antes de cualquier refinamiento, intenta la reproducción: lee los pasos del reportero, rastrea el código relevante, ejecuta pruebas o comandos. Reporta qué ocurrió: reproducción exitosa con ruta de código, reproducción fallida, o detalles insuficientes (una fuerte señal de
needs-info). Una reproducción confirmada hace un brief mucho más robusto para el agente. -
Refina (si es necesario). Si el issue necesita más detalle, ejecuta las skills
/grillingy/domain-modelingjuntas — refina el issue una pregunta a la vez, afinando los términos del dominio y actualizandoCONTEXT.md/ADR a medida que se toman decisiones. -
Aplica el resultado:
ready-for-agent— publica un comentario con un brief para agente (AGENT-BRIEF.md).ready-for-human— misma estructura que un brief para agente, pero indica por qué no se puede delegar (juicios subjetivos, acceso externo, decisiones de diseño, pruebas manuales).needs-info— publica notas de triaje (plantilla a continuación).wontfix(bug) — explicación educada y luego cierra.wontfix(mejora) — escribe en.out-of-scope/, enlázalo desde un comentario y luego cierra (OUT-OF-SCOPE.md).needs-triage— aplica el rol. Comentario opcional si hay avance parcial.
Anulación rápida de estado
Si el mantenedor dice "mueve el #42 a ready-for-agent", confía en él y aplica el rol directamente. Confirma lo que vas a hacer (cambios de rol, comentario, cierre) y luego actúa. Omite el refinamiento. Si mueves a ready-for-agent sin una sesión de refinamiento, pregunta si quieren escribir un brief para agente.
Plantilla para needs-info
## Notas de Triaje
**Lo que hemos establecido hasta ahora:**
- punto 1
- punto 2
**Lo que aún necesitamos de ti (@reporter):**
- pregunta 1
- pregunta 2
Captura todo lo resuelto durante el refinamiento bajo "establecido hasta ahora" para no perder el trabajo. Las preguntas deben ser específicas y accionables, no "proporcione más información".
Reanudar una sesión anterior
Si existen notas de triaje previas en el issue, léelas, verifica si el reportero ha respondido alguna pregunta pendiente y presenta una imagen actualizada antes de continuar. No vuelvas a preguntar lo ya resuelto.