# Mapeo: Sistema NEXUS (Gamilit) ↔ Sistema SIMCO (Workspace)

**Fecha:** 2026-01-10
**Versión:** 1.0
**Propósito:** Documentar la relación entre el sistema NEXUS de Gamilit y el sistema SIMCO del Workspace

---

## Arquitectura de Relación

```
WORKSPACE (orchestration/)
└── Sistema SIMCO v3.6
    ├── 42 Directivas
    ├── 6 Principios
    └── 35 Perfiles de Agentes
         │
         │ HERENCIA
         ▼
GAMILIT (projects/gamilit/.claude/)
└── Sistema NEXUS v1.0
    ├── 11 Directivas (especializadas)
    ├── 12 Perfiles NEXUS (especializados)
    └── Configuración específica del proyecto
```

**Tipo de Relación:** ESPECIALIZACIÓN (no duplicación)

---

## Equivalencias de Directivas

### Directivas NEXUS → Equivalentes SIMCO

| Directiva NEXUS | Equivalente SIMCO | Relación |
|-----------------|-------------------|----------|
| DIRECTIVA-VALIDACION-DOCUMENTACION.md | SIMCO-VALIDAR.md + SIMCO-DOCUMENTAR.md | ESPECIALIZA |
| DIRECTIVAS-PRINCIPALES.md | INDICE-DIRECTIVAS-WORKSPACE.yml | HEREDA |
| GUIA-ORQUESTACION.md | SIMCO-DELEGACION.md | COMPLEMENTA |
| DIRECTIVAS-FLUJOS.md | PRINCIPIO-CAPVED.md | HEREDA |
| DIRECTIVAS-MICROCICLOS-ANIDADOS.md | (único en NEXUS) | EXTIENDE |
| DIRECTIVAS-PARALELIZACION.md | SIMCO-DELEGACION-PARALELA.md | HEREDA |
| POLITICAS-MODULARIZACION.md | (único en NEXUS) | EXTIENDE |
| PRINCIPIOS-SOLID-DOCS.md | PRINCIPIO-ANTI-DUPLICACION.md | HEREDA |
| DELIMITACION-PERFILES.md | SIMCO-ASIGNACION-PERFILES.md | HEREDA |
| PROCESO-VALIDACION.md | SIMCO-VALIDAR.md | HEREDA |
| POLITICA-TESTING.md | PRINCIPIO-VALIDACION-OBLIGATORIA.md | HEREDA |

### Directivas Únicas de NEXUS

| Directiva | Propósito | ¿Debería existir en Workspace? |
|-----------|-----------|--------------------------------|
| DIRECTIVAS-MICROCICLOS-ANIDADOS.md | Ciclos hasta 5 niveles | Sí - Generalizable |
| POLITICAS-MODULARIZACION.md | Archivos <400 líneas | Ya existe implícito |

---

## Equivalencias de Perfiles

### Perfiles NEXUS → Perfiles Workspace

| Perfil NEXUS | Perfil Workspace | Relación |
|--------------|-----------------|----------|
| INIT-NEXUS-BACKEND | PERFIL-BACKEND | ESPECIALIZA |
| INIT-NEXUS-BACKEND-AVANZADO | PERFIL-BACKEND | EXTIENDE |
| INIT-NEXUS-FRONTEND | PERFIL-FRONTEND | ESPECIALIZA |
| INIT-NEXUS-FRONTEND-AVANZADO | PERFIL-FRONTEND | EXTIENDE |
| INIT-NEXUS-DATABASE | PERFIL-DATABASE | ESPECIALIZA |
| INIT-NEXUS-DATABASE-AVANZADO | PERFIL-DATABASE | EXTIENDE |
| INIT-NEXUS-DEVOPS | PERFIL-DEVOPS | ESPECIALIZA |
| INIT-NEXUS-INTEGRATION | PERFIL-INTEGRATION-VALIDATOR | EQUIVALENTE |
| INIT-NEXUS-TESTING | PERFIL-TESTING | ESPECIALIZA |
| INIT-NEXUS-VALIDATION | PERFIL-REQUIREMENTS-ANALYST | SIMILAR |
| INIT-NEXUS-COMPLETITUD | (único en NEXUS) | EXTIENDE |

### Perfiles Únicos

| Sistema | Perfil Único | Propósito |
|---------|--------------|-----------|
| NEXUS | INIT-NEXUS-COMPLETITUD | Validación de completitud de módulos |
| Workspace | PERFIL-SECURITY-AUDITOR | Auditoría de seguridad |
| Workspace | PERFIL-MCP-ARCHITECT | Diseño MCP Servers |

---

## Flujo de Herencia

```
1. AGENTE INICIA EN GAMILIT
   ↓
2. CARGA PERFIL NEXUS (projects/gamilit/.claude/agents/)
   ↓
3. HEREDA DIRECTIVAS BASE (orchestration/directivas/simco/)
   ↓
4. APLICA DIRECTIVAS ESPECÍFICAS (projects/gamilit/.claude/directivas/)
   ↓
5. EJECUTA CON CONTEXTO COMBINADO
```

---

## Cuándo Usar Cada Sistema

### Usar Sistema NEXUS cuando:
- Trabajas exclusivamente en el proyecto Gamilit
- Necesitas contexto específico del proyecto (paths, esquemas, etc.)
- Requieres validación contra `/docs/` de Gamilit

### Usar Sistema SIMCO cuando:
- Trabajas a nivel de Workspace (múltiples proyectos)
- Creas nuevos proyectos
- Defines estándares globales
- Necesitas perfiles genéricos

---

## Resolución de Conflictos

Si una directiva NEXUS contradice una directiva SIMCO:

1. **NEXUS tiene precedencia** para el proyecto Gamilit
2. Documentar la diferencia en el archivo de directiva NEXUS
3. Considerar si el cambio debería propagarse al Workspace

---

## Propagación de Cambios

### De SIMCO a NEXUS:
- Cambios en principios fundamentales se propagan automáticamente
- Cambios en directivas deben evaluarse para impacto en NEXUS

### De NEXUS a SIMCO:
- Mejoras probadas en NEXUS pueden proponerse como estándares
- Directivas únicas exitosas pueden generalizarse

---

## Diagrama de Arquitectura

```
┌─────────────────────────────────────────────────────────────┐
│                    WORKSPACE (orchestration/)               │
│  ┌──────────────────────────────────────────────────────┐  │
│  │              SISTEMA SIMCO v3.6                      │  │
│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  │  │
│  │  │ 42 Directivas│  │ 6 Principios│  │ 35 Perfiles │  │  │
│  │  └─────────────┘  └─────────────┘  └─────────────┘  │  │
│  └──────────────────────────┬───────────────────────────┘  │
│                             │                              │
│                    HEREDA Y ESPECIALIZA                    │
│                             │                              │
│  ┌──────────────────────────▼───────────────────────────┐  │
│  │        GAMILIT (projects/gamilit/.claude/)           │  │
│  │  ┌──────────────────────────────────────────────┐   │  │
│  │  │           SISTEMA NEXUS v1.0                 │   │  │
│  │  │  ┌──────────┐ ┌──────────┐ ┌──────────────┐ │   │  │
│  │  │  │11 Direct.│ │12 Perfiles│ │Config Espec.│ │   │  │
│  │  │  └──────────┘ └──────────┘ └──────────────┘ │   │  │
│  │  └──────────────────────────────────────────────┘   │  │
│  └──────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘
```

---

## Referencias

- **Índice SIMCO:** `/orchestration/INDICE-DIRECTIVAS-WORKSPACE.yml`
- **Índice NEXUS:** `/projects/gamilit/.claude/README.md`
- **Perfiles SIMCO:** `/orchestration/agents/perfiles/`
- **Perfiles NEXUS:** `/projects/gamilit/.claude/agents/`

---

**Mantenido por:** Documentation-Architect
**Última actualización:** 2026-01-10