Initial commit

commands/analyze-dependencies.md

@@ -0,0 +1,158 @@
+## Análisis de Dependencias
+
+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