# AVISO: ARCHIVOS LEGACY INIT-NEXUS-*.md

**Fecha:** 2025-12-08
**Estado:** DEPRECATED (pero funcional)

---

## CONTEXTO

Los archivos `INIT-NEXUS-*.md` en este directorio representan el **sistema anterior** de inicialización de agentes. Estos archivos son extensos (~800+ líneas cada uno) y contenían toda la información de contexto, directivas y procedimientos en un solo documento.

---

## NUEVO SISTEMA RECOMENDADO

El sistema actual **SIMCO + CAPVED** reemplaza estos archivos con:

```
ANTES (Legacy):                      AHORA (Recomendado):
───────────────────────────────────────────────────────────
INIT-NEXUS-BACKEND.md (800+ líneas)  → PERFIL-BACKEND.md (ligero)
                                       + SIMCO-TAREA.md (ciclo CAPVED)
                                       + SIMCO-BACKEND.md (operaciones)
                                       + @CATALOG (funcionalidades)
```

### Estructura Actual

```
core/orchestration/
├── agents/
│   ├── perfiles/                    # 🆕 PERFILES LIGEROS (usar estos)
│   │   ├── PERFIL-DATABASE.md
│   │   ├── PERFIL-BACKEND.md
│   │   ├── PERFIL-FRONTEND.md
│   │   └── PERFIL-ORQUESTADOR.md
│   │
│   ├── INIT-NEXUS-*.md              # ⚠️ LEGACY (referencia extendida)
│   └── LEGACY-NOTICE.md             # Este archivo
│
├── directivas/
│   └── simco/                       # 🆕 DIRECTIVAS POR OPERACIÓN
│       ├── SIMCO-TAREA.md           # Punto de entrada (CAPVED)
│       ├── SIMCO-REUTILIZAR.md      # Verificar catálogo PRIMERO
│       ├── SIMCO-CREAR.md
│       ├── SIMCO-BACKEND.md
│       └── ...
│
└── core/catalog/                    # 🆕 CATÁLOGO DE FUNCIONALIDADES
    ├── CATALOG-INDEX.yml            # Índice para búsqueda
    ├── auth/
    ├── session-management/
    ├── rate-limiting/
    ├── notifications/
    ├── multi-tenancy/
    ├── feature-flags/
    ├── websocket/
    └── payments/
```

---

## CÓMO INICIALIZAR UN AGENTE (NUEVO SISTEMA)

### Prompt Mínimo Recomendado

```
Serás Backend-Agent trabajando en el proyecto {PROYECTO}
para realizar: {TAREA}

Carga tu perfil de: @PERFILES/PERFIL-BACKEND.md
Sigue el ciclo CAPVED de: @SIMCO/SIMCO-TAREA.md
Consulta @CATALOG_INDEX antes de implementar funcionalidades comunes.
```

### Flujo del Nuevo Sistema

```
1. Cargar perfil ligero (PERFIL-*.md)
2. Seguir ciclo CAPVED (SIMCO-TAREA.md)
3. Verificar catálogo ANTES de implementar (@REUTILIZAR)
4. Usar directiva SIMCO según operación
5. Documentar y propagar cambios
```

---

## ¿CUÁNDO USAR LOS ARCHIVOS LEGACY?

Los archivos `INIT-NEXUS-*.md` siguen siendo útiles como:

1. **Referencia extendida** - Si necesitas detalles que no están en perfiles ligeros
2. **Contexto histórico** - Para entender decisiones anteriores
3. **Ejemplos detallados** - Contienen más ejemplos de código

**SIN EMBARGO**, para trabajo diario se recomienda usar:
- Perfiles ligeros + SIMCO + Catálogo

---

## ARCHIVOS LEGACY EN ESTE DIRECTORIO

| Archivo | Uso Recomendado | Reemplazado Por |
|---------|-----------------|-----------------|
| INIT-NEXUS-BACKEND.md | Referencia | PERFIL-BACKEND.md + SIMCO-BACKEND.md |
| INIT-NEXUS-BACKEND-AVANZADO.md | Referencia | PERFIL-BACKEND.md |
| INIT-NEXUS-DATABASE.md | Referencia | PERFIL-DATABASE.md + SIMCO-DDL.md |
| INIT-NEXUS-DATABASE-AVANZADO.md | Referencia | PERFIL-DATABASE.md |
| INIT-NEXUS-FRONTEND.md | Referencia | PERFIL-FRONTEND.md + SIMCO-FRONTEND.md |
| INIT-NEXUS-FRONTEND-AVANZADO.md | Referencia | PERFIL-FRONTEND.md |
| INIT-NEXUS-DEVOPS.md | Referencia | (sin reemplazo directo) |
| INIT-NEXUS-TESTING.md | Referencia | SIMCO-VALIDAR.md |
| INIT-NEXUS-INTEGRATION.md | Referencia | SIMCO-VALIDAR.md |
| INIT-NEXUS-VALIDATION.md | Referencia | SIMCO-VALIDAR.md |
| INIT-NEXUS-COMPLETITUD.md | Referencia | SIMCO-DOCUMENTAR.md |
| INIT-NEXUS-DEVENV.md | Referencia | (mantener para setup) |
| INIT-NEXUS-PYTHON.md | Referencia | (sin reemplazo - especializado) |
| INIT-NEXUS-ML-ENGINE.md | Referencia | (sin reemplazo - especializado) |
| INIT-NEXUS-LLM-AGENT.md | Referencia | (sin reemplazo - especializado) |
| INIT-NEXUS-TRADING-STRATEGIST.md | Referencia | (sin reemplazo - especializado) |

---

## PLAN DE MIGRACIÓN

**Estado actual:** Los archivos legacy NO serán eliminados inmediatamente.

**Próximos pasos:**
1. ✅ Crear sistema SIMCO con directivas por operación
2. ✅ Crear perfiles ligeros en `agents/perfiles/`
3. ✅ Crear catálogo de funcionalidades reutilizables
4. ⏳ Gradualmente migrar proyectos al nuevo sistema
5. ⏳ Archivar archivos legacy después de validar migración

---

## REFERENCIAS

- **Índice SIMCO:** core/orchestration/directivas/simco/_INDEX.md
- **Perfiles de Agentes:** core/orchestration/agents/perfiles/
- **Catálogo:** core/catalog/
- **Aliases:** core/orchestration/referencias/ALIASES.yml

---

**Versión:** 1.0.0 | **Sistema:** NEXUS SIMCO v3.0
