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

7.4 KiB

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