---
version: 1.0.0
updated: 2026-03-15
tags: [issues, planning, dependencies, order]
---

# 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

```bash
/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

```bash
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:

1. **Tabla "## Dependencias"**: filas con IDs en primera columna
2. **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:
1. Número de issue menor primero
2. 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