Command: sort-issues (issues)

Analiza las issues en dev/issues/ del repositorio Dataforge (parent), construye el grafo de dependencias y muestra el orden de ejecución recomendado. Detecta dependencias circulares y las reporta claramente.

Para el usuario

Cuándo usar este comando

Cuando quieres saber en qué orden ejecutar las issues del proyecto padre
Antes de empezar a trabajar para entender el flujo crítico
Cuando hay dudas sobre bloqueos entre issues
Invocado desde TUI con la tecla s en el selector de issues

Sintaxis

/issues:sort-issues

Para Claude

Precondiciones

Directorio dev/issues/ existe
Hay archivos .md en dev/issues/ (al menos uno)

Flujo obligatorio

1. Listar todas las issues pendientes

ls dev/issues/*.md | grep -E '^dev/issues/[0-9]{4}[a-z]?-.*\.md$' | sort

Excluir README.md y otros archivos que no sean issues numeradas.

2. Para cada issue, extraer dependencias

Leer cada archivo y buscar:

Tabla "## Dependencias": filas con IDs en primera columna
Línea "Bloqueada por": **Bloqueada por:** \#NNNN, #NNNN``

Construir lista: {id: "0003", deps: ["0001", "0002"]}

3. Construir grafo y detectar ciclos

Verificar si hay dependencias circulares (A → B → A).

Si hay ciclos:

❌ Dependencias circulares detectadas:

   0010 → 0011 → 0012 → 0010

Solución: Revisar dependencias en:
- dev/issues/0010-*.md
- dev/issues/0011-*.md
- dev/issues/0012-*.md

Si no hay ciclos: continuar al paso 4.

4. Calcular orden topológico

Aplicar Kahn's algorithm o DFS post-order. Criterios de desempate:

Número de issue menor primero
Issues sin dependencias primero (nivel 0)

5. Mostrar resultado

Orden de ejecución recomendado para Dataforge:

1. [0001] Título issue 1
2. [0002] Título issue 2
3. [0003] Título issue 3 (depende de: 0001, 0002)
4. [0004] Título issue 4 (depende de: 0002, 0003)
5. [0005] Título issue 5 (depende de: 0004)

⚠️  Issues con dependencias circulares: Ninguna
✓  Todas las issues pueden ejecutarse en este orden

Issues paralelizables (misma capa):
- Capa 1 (sin deps): 0001
- Capa 2: 0002
- Capa 3: 0003, 0004
- Capa 4: 0005

Convenciones

Solo leer: nunca modificar los archivos de issues
Análisis exhaustivo: leer TODAS las issues antes de generar el orden
Detectar ambos formatos: tabla Dependencias + línea Bloqueada por
Reportar claramente los ciclos con los IDs involucrados

2.6 KiB Raw Blame History