reversa

/dc:reversa

Objetivo

Analizar un codebase existente y extraer su arquitectura implícita: componentes, conexiones, flujos de datos, tecnologías y propiedad de código. Convierte código desorganizado en un mapa arquitectónico explícito.

Adaptado de DevilDev (lak7/devildev) — Reverse Architecture.

Uso

/dc:reversa                          # Analizar el proyecto actual
/dc:reversa @ruta/al/proyecto        # Analizar un proyecto específico
/dc:reversa --profundidad superficial # Solo estructura de alto nivel
/dc:reversa --profundidad profunda    # Incluir flujo de datos y dependencias

Por Qué Existe

El 80% del trabajo de desarrollo es sobre codebases existentes, no greenfield. Antes de modificar un sistema, necesitas entender:

• ¿Cuáles son los componentes principales?
• ¿Cómo se conectan entre sí?
• ¿Qué tecnologías usa cada componente?
• ¿Dónde vive el código de cada componente?

Sin esta herramienta, un agente IA empieza a modificar código sin entender la arquitectura, generando inconsistencias y duplicación.

Comportamiento

Paso 1: Escaneo Estructural

Escaneando proyecto...
├── Detectando framework: Next.js 15 + TypeScript
├── Identificando dependencias: 24 directas, 8 dev
├── Mapeando estructura de directorios
└── Analizando imports y exports

Paso 2: Identificación de Componentes

Aplica estas reglas (de DevilDev):

1. Solo componentes con evidencia — No inventar lo que no existe
2. Test de valor de negocio — ¿Un stakeholder no-técnico lo entendería?
3. Test de significancia — ¿Si falla, requiere una solución técnica diferente?
4. Test de independencia — ¿Se podría reemplazar con otra tecnología?

Paso 3: Mapeo de Propiedad de Código

Para cada componente:

{
  "codeOwnership": {
    "primaryImplementation": {
      "directories": ["src/services/auth/"],
      "files": ["src/middleware/jwt.ts"],
      "confidence": 0.9,
      "rationale": "Contiene toda la lógica de autenticación"
    },
    "supportingRelated": {
      "directories": ["src/utils/crypto/"],
      "confidence": 0.6,
      "rationale": "Helpers de encriptación usados por auth"
    },
    "sharedDependencies": {
      "files": ["src/db/prisma.ts"],
      "confidence": 0.3,
      "rationale": "Cliente de BD compartido con otros servicios"
    }
  }
}