# 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-08
**Versión:** 2.0

---

## 📋 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 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-08
**Autor:** Sistema NEXUS
**Versión:** 2.0
**Cambios v2.0:** Reorganización completa - archivos legacy movidos a `legacy/`, nueva estructura basada en SIMCO + CAPVED.
