workspace-v1/orchestration/analisis/GAMILIT-NEXUS-WORKSPACE-MAPPING.md
rckrdmrd e56e927a4d [MAINT-001] docs(orchestration): Actualizacion directivas SIMCO, perfiles y documentacion
Cambios incluidos:
- INDICE-DIRECTIVAS-WORKSPACE.yml actualizado
- Perfiles de agentes: PERFIL-ML.md, PERFIL-SECURITY.md
- Directivas SIMCO actualizadas:
  - SIMCO-ASIGNACION-PERFILES.md
  - SIMCO-CCA-SUBAGENTE.md
  - SIMCO-CONTEXT-ENGINEERING.md
  - SIMCO-CONTEXT-RESOLUTION.md
  - SIMCO-DELEGACION-PARALELA.md
- Inventarios actualizados: DEVENV-MASTER, DEVENV-PORTS
- Documentos de analisis agregados:
  - Analisis y planes de fix student portal
  - Analisis scripts BD
  - Analisis achievements, duplicados, gamification
  - Auditoria documentacion gamilit
  - Backlog discrepancias NEXUS
  - Planes maestros de resolucion
- Reportes de ejecucion agregados
- Knowledge base gamilit README actualizado
- Referencia submodulo gamilit actualizada (commit beb94f7)

Validaciones:
- Plan validado contra directivas SIMCO-GIT
- Dependencias verificadas
- Build gamilit: EXITOSO
2026-01-10 04:51:28 -06:00

178 lines
7.4 KiB
Markdown

# 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