Analyze Dependencies

---
description: 'Analizar dependencias del proyecto y evaluar salud arquitectónica. Se activa con "analizar dependencias", "detectar dependencias circulares", "problemas de arquitectura", "verificar acoplamiento".'
allowed-tools:
  - Read
  - Grep
  - Glob
---

# Analizar dependencias del proyecto y evaluar salud arquitectónica

Analiza las dependencias de tu proyecto y verifica la salud de la arquitectura.

## Uso

```bash
/dependency-analysis [opciones]
```

## Opciones

- `--visual`: Mostrar dependencias visualmente
- `--circular`: Detectar solo dependencias circulares
- `--depth <número>`: Especificar profundidad de análisis (por defecto: 3)
- `--focus <ruta>`: Enfocarse en módulo/directorio específico

## Ejemplos Básicos

```bash
# Analizar dependencias de todo el proyecto
/dependency-analysis

# Detectar dependencias circulares
/dependency-analysis --circular

# Análisis detallado de módulo específico
/dependency-analysis --focus src/core --depth 5
```

## Qué Se Analiza

### 1. Matriz de Dependencias

Muestra cómo los módulos se conectan entre sí:

- Dependencias directas
- Dependencias indirectas
- Profundidad de dependencias
- Fan-in/fan-out

### 2. Violaciones de Arquitectura

- Violaciones de capas (cuando capas inferiores dependen de superiores)
- Dependencias circulares
- Acoplamiento excesivo (demasiadas conexiones)
- Módulos huérfanos

### 3. Verificación de Clean Architecture

- ¿Es independiente la capa de dominio?
- ¿Está la infraestructura separada correctamente?
- ¿Fluyen correctamente las dependencias de casos de uso?
- ¿Se están usando las interfaces correctamente?

## Ejemplo de Salida

```text
Reporte de Análisis de Dependencias
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 Resumen de Métricas
├─ Total de módulos: 42
├─ Dependencias promedio: 3.2
├─ Profundidad máxima de dependencias: 5
└─ Dependencias circulares: 2 detectadas

⚠️  Violaciones de Arquitectura
├─ [ALTO] src/domain/user.js → src/infra/database.js
│  └─ Capa de dominio depende directamente de capa de infraestructura
├─ [MED] src/api/auth.js ⟲ src/services/user.js
│  └─ Dependencia circular detectada
└─ [BAJO] src/utils/helper.js → 12 módulos
   └─ Fan-out excesivo

✅ Acciones Recomendadas
1. Introducir interfaz UserRepository
2. Rediseñar responsabilidades del servicio de autenticación
3. Dividir funciones helper por funcionalidad

📈 Gráfico de Dependencias
[Diagrama visual de dependencias mostrado en arte ASCII]
```

## Ejemplos de Uso Avanzado

```bash
# Verificaciones automáticas CI/CD
/dependency-analysis --circular --fail-on-violation

# Verificar contra reglas de arquitectura
/dependency-analysis --rules .architecture-rules.yml

# Ver cómo cambiaron las dependencias
/dependency-analysis --compare HEAD~10
```

## Ejemplo de Archivo de Configuración (.dependency-analysis.yml)

```yaml
rules:
  - name: "Independencia de Dominio"
    source: "src/domain/**"
    forbidden: ["src/infra/**", "src/api/**"]

  - name: "Dependencias de Capa API"
    source: "src/api/**"
    allowed: ["src/domain/**", "src/application/**"]
    forbidden: ["src/infra/**"]

thresholds:
  max_dependencies: 8
  max_depth: 4
  coupling_threshold: 0.7

ignore:
  - "**/test/**"
  - "**/mocks/**"
```

## Herramientas Que Usamos

- `madge`: Muestra dependencias de JavaScript/TypeScript visualmente
- `dep-cruiser`: Verifica reglas de dependencias
- `nx`: Gestiona dependencias de monorepo
- `plato`: Analiza complejidad y dependencias juntas

## Colaboración con Claude

```bash
# Verificar dependencias con package.json
cat package.json
/analyze-dependencies
"Encontrar problemas de dependencias en este proyecto"

# Profundizar en un módulo específico
ls -la src/core/
/analyze-dependencies --focus src/core
"Verificar las dependencias del módulo core en detalle"

# Comparar diseño vs realidad
cat docs/architecture.md
/analyze-dependencies --visual
"¿Nuestra implementación coincide con los documentos de arquitectura?"
```

## Notas

- **Ejecutar desde**: Directorio raíz del proyecto
- **Ten paciencia**: Los proyectos grandes toman tiempo para analizar
- **Actúa rápido**: Corrige las dependencias circulares tan pronto como las encuentres

## Mejores Prácticas

1. **Verificar semanalmente**: Mantén un ojo en la salud de las dependencias
2. **Escribir reglas**: Pon las reglas de arquitectura en archivos de configuración
3. **Pasos pequeños**: Corrige las cosas gradualmente, no todo a la vez
4. **Seguir tendencias**: Observa cómo cambia la complejidad a lo largo del tiempo