# Mapa de Contenidos: Perfiles de Agentes NEXUS

**Propósito:** Define los perfiles de agentes especializados para desarrollo multi-proyecto
**Sistema:** SIMCO v3.2 + CAPVED
**Última actualización:** 2025-12-12
**Versión:** 2.1

---

## 📋 Estructura de Archivos (Reorganizada 2025-12-08)

```
agents/
├── _MAP.md                    # ⭐ Este archivo
├── README.md                  # Guía general de agentes
│
├── perfiles/                  # 🆕 PERFILES LIGEROS (USAR ESTOS)
│   ├── PERFIL-DATABASE.md     # Database-Agent (~100 líneas)
│   ├── PERFIL-BACKEND.md      # Backend-Agent (~100 líneas)
│   ├── PERFIL-FRONTEND.md     # Frontend-Agent (~100 líneas)
│   └── PERFIL-ORQUESTADOR.md  # Tech-Leader (~100 líneas)
│
└── legacy/                    # ⚠️ REFERENCIA EXTENDIDA
    ├── README.md              # Guía de archivos legacy
    ├── INIT-NEXUS-*.md        # Prompts extensos (800+ líneas)
    ├── PROMPT-*-AGENT.md      # Definiciones detalladas
    └── LEGACY-NOTICE.md       # Aviso de deprecación
```

---

## 🆕 SISTEMA ACTUAL: PERFILES LIGEROS + SIMCO

Los agentes ahora usan **perfiles ligeros** (~100 líneas) combinados con directivas SIMCO.

### Cómo Inicializar un Agente (Nuevo Sistema)

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

Carga tu perfil de: @PERFILES/PERFIL-{TIPO}.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. Ejecutar CCA (Carga de Contexto Automática)
3. Seguir ciclo CAPVED (SIMCO-TAREA.md)
4. Verificar catálogo ANTES de implementar (@REUTILIZAR)
5. Usar directiva SIMCO según operación
6. Documentar y propagar cambios
```

---

## 🤖 Perfiles Activos (SIMCO)

### PERFIL-ORQUESTADOR (Tech-Leader)
**Archivo:** `perfiles/PERFIL-ORQUESTADOR.md`
**Responsabilidades:**
- Ejecutar plan de desarrollo siguiendo documentación
- Coordinar subagentes (Database, Backend, Frontend)
- Validar resultados contra especificaciones
- Ejecutar fases C, A, P, V, D del ciclo CAPVED (no delegar)
- Delegar fase E a subagentes especializados

**NO hace:** Implementación técnica directa

---

### PERFIL-DATABASE
**Archivo:** `perfiles/PERFIL-DATABASE.md`
**Responsabilidades:**
- Diseño de esquemas SQL (PostgreSQL)
- Migrations versionadas
- Seeds de datos
- Row Level Security (RLS)
- Tests de integridad

**Directiva SIMCO:** `SIMCO-DDL.md`

---

### PERFIL-BACKEND
**Archivo:** `perfiles/PERFIL-BACKEND.md`
**Responsabilidades:**
- Desarrollo de servicios backend (NestJS/TypeScript)
- APIs REST con Swagger
- Lógica de negocio
- Testing backend (coverage ≥60%)

**Directiva SIMCO:** `SIMCO-BACKEND.md`

---

### PERFIL-FRONTEND
**Archivo:** `perfiles/PERFIL-FRONTEND.md`
**Responsabilidades:**
- Desarrollo de componentes React/TypeScript
- Hooks personalizados
- State management
- Testing frontend

**Directiva SIMCO:** `SIMCO-FRONTEND.md`

---

## 🤖 Perfiles Trading/ML (SIMCO)

### PERFIL-TECH-LEADER
**Archivo:** `perfiles/PERFIL-TECH-LEADER.md`
**Responsabilidades:**
- Orquestar desarrollo del proyecto
- Coordinar equipo de agentes
- Delegar a agentes especializados
- Validar entregas y resultados
- Tomar decisiones técnicas

**Colabora con:** Trading-Strategist, ML-Specialist, LLM-Agent

---

### PERFIL-TRADING-STRATEGIST
**Archivo:** `perfiles/PERFIL-TRADING-STRATEGIST.md`
**Versión:** 2.0.0
**Responsabilidades:**
- Validar estrategias de trading
- Analizar flujo de predicciones
- Ejecutar backtests
- Coordinar correcciones post-análisis
- Reportar a Tech-Leader

**Colabora con:** ML-Specialist, LLM-Agent
**Reporta a:** Tech-Leader

---

### PERFIL-ML-SPECIALIST
**Archivo:** `perfiles/PERFIL-ML-SPECIALIST.md`
**Responsabilidades:**
- Diseñar y entrenar modelos ML
- Optimizar hiperparámetros
- Feature engineering
- APIs de inferencia (FastAPI)
- Atender solicitudes de Trading-Strategist

**Colabora con:** Trading-Strategist, LLM-Agent

---

### PERFIL-LLM-AGENT
**Archivo:** `perfiles/PERFIL-LLM-AGENT.md`
**Responsabilidades:**
- Integración con Claude/OpenAI APIs
- Tool calling y function execution
- RAG pipelines
- Validación semántica de estrategias
- Análisis de coherencia para Trading-Strategist

**Colabora con:** Trading-Strategist, ML-Specialist

---

## 🔄 Matriz de Colaboración Trading/ML

```
┌─────────────────────────────────────────────────────────────┐
│                      TECH-LEADER                             │
│                 (Orquesta el desarrollo)                     │
└─────────────────────────┬───────────────────────────────────┘
                          │ Delega/Recibe reportes
          ┌───────────────┼───────────────┐
          │               │               │
          ▼               ▼               ▼
   ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
   │  TRADING-    │ │    ML-       │ │    LLM-      │
   │  STRATEGIST  │◄┼►  SPECIALIST │◄┼►   AGENT     │
   │              │ │              │ │              │
   │ - Validar    │ │ - Entrenar   │ │ - Interpretar│
   │ - Analizar   │ │ - Optimizar  │ │ - Validar    │
   │ - Corregir   │ │ - Evaluar    │ │ - Explicar   │
   └──────────────┘ └──────────────┘ └──────────────┘

Flujo de colaboración:
1. Tech-Leader asigna tarea de validación
2. Trading-Strategist analiza y ejecuta backtest
3. Si problema ML → coordina con ML-Specialist
4. Si problema lógico → coordina con LLM-Agent
5. Trading-Strategist reporta a Tech-Leader
```

---

## 📂 Perfiles Legacy (Referencia Extendida)

> **Ubicación:** `agents/legacy/`
> **Estado:** DEPRECATED pero válidos como referencia

### Archivos Movidos a Legacy

| Archivo | Reemplazado Por |
|---------|-----------------|
| `INIT-NEXUS-BACKEND.md` | `PERFIL-BACKEND.md` + `SIMCO-BACKEND.md` |
| `INIT-NEXUS-DATABASE.md` | `PERFIL-DATABASE.md` + `SIMCO-DDL.md` |
| `INIT-NEXUS-FRONTEND.md` | `PERFIL-FRONTEND.md` + `SIMCO-FRONTEND.md` |
| `PROMPT-TECH-LEADER.md` | `PERFIL-ORQUESTADOR.md` |
| `PROMPT-*-AGENT.md` | Perfiles + SIMCO |

### Archivos Especializados (Sin reemplazo directo)

Estos siguen siendo útiles para casos específicos:
- `INIT-NEXUS-PYTHON.md` - Python/FastAPI
- `INIT-NEXUS-ML-ENGINE.md` - Machine Learning
- `INIT-NEXUS-LLM-AGENT.md` - Integración LLM
- `INIT-NEXUS-TRADING-STRATEGIST.md` - Trading
- `INIT-NEXUS-DEVENV.md` - Ambiente de desarrollo

**Para lista completa:** Ver `legacy/README.md`

---

## 🔄 Migración Legacy → SIMCO

| Antes (Legacy) | Ahora (SIMCO) |
|----------------|---------------|
| Leer prompt de 800+ líneas | Leer perfil (~100L) + SIMCO relevante |
| Directivas duplicadas en cada prompt | Directivas centralizadas en SIMCO |
| Buscar en múltiples archivos | Aliases claros (@CREAR, @VALIDAR, etc.) |
| Inconsistencia entre perfiles | 5 Principios compartidos |
| Sin catálogo | @CATALOG con 8 funcionalidades |

---

## 🔗 Referencias

- **Perfiles actuales:** `perfiles/PERFIL-*.md`
- **Directivas SIMCO:** `../directivas/simco/`
- **Principios:** `../directivas/principios/`
- **Catálogo:** `../../catalog/`
- **Aliases:** `../referencias/ALIASES.yml`
- **Templates:** `../templates/`

---

**Creado:** 2025-11-02
**Actualizado:** 2025-12-12
**Autor:** Sistema NEXUS
**Versión:** 2.1
**Cambios v2.1:** Agregados perfiles Trading/ML con matriz de colaboración (Tech-Leader ↔ Trading-Strategist ↔ ML-Specialist ↔ LLM-Agent).
**Cambios v2.0:** Reorganización completa - archivos legacy movidos a `legacy/`, nueva estructura basada en SIMCO + CAPVED.
