# AGENTES DEL SISTEMA NEXUS

**Versión:** 1.6.0
**Fecha:** 2025-12-12
**Sistema:** SIMCO v2.3.0 + CAPVED

---

## Visión General

Este directorio contiene los **perfiles de agentes** del Sistema NEXUS. Los agentes son roles especializados que ejecutan tareas específicas dentro del ciclo de desarrollo.

**Sistema SIMCO:** Los agentes utilizan el sistema **SIMCO** (Single Instruction Matrix by Context and Operation) que organiza directivas por tipo de operación, permitiendo que cualquier agente siga las directivas correctas independientemente de su especialización.

---

## Estructura del Directorio

```
agents/
├── README.md                 # Este archivo
├── _MAP.md                   # Mapa de contenidos
├── perfiles/                 # PERFILES SIMCO (23 archivos)
│   │
│   │   # === TÉCNICOS ===
│   ├── PERFIL-DATABASE.md
│   ├── PERFIL-BACKEND.md
│   ├── PERFIL-BACKEND-EXPRESS.md
│   ├── PERFIL-FRONTEND.md
│   ├── PERFIL-MOBILE-AGENT.md
│   ├── PERFIL-ML-SPECIALIST.md
│   ├── PERFIL-LLM-AGENT.md           # 🆕 Integración LLM
│   ├── PERFIL-TRADING-STRATEGIST.md  # 🆕 Estrategias trading
│   │
│   │   # === COORDINACIÓN ===
│   ├── PERFIL-ORQUESTADOR.md
│   ├── PERFIL-TECH-LEADER.md
│   ├── PERFIL-ARCHITECTURE-ANALYST.md
│   ├── PERFIL-REQUIREMENTS-ANALYST.md
│   │
│   │   # === CALIDAD ===
│   ├── PERFIL-CODE-REVIEWER.md
│   ├── PERFIL-BUG-FIXER.md
│   ├── PERFIL-TESTING.md
│   ├── PERFIL-DOCUMENTATION-VALIDATOR.md
│   ├── PERFIL-WORKSPACE-MANAGER.md
│   │
│   │   # === AUDITORÍA ===
│   ├── PERFIL-SECURITY-AUDITOR.md
│   ├── PERFIL-DATABASE-AUDITOR.md    # 🆕 Auditoría BD
│   ├── PERFIL-POLICY-AUDITOR.md      # 🆕 Auditoría cumplimiento
│   ├── PERFIL-INTEGRATION-VALIDATOR.md # 🆕 Validación integración
│   │
│   │   # === INFRAESTRUCTURA ===
│   ├── PERFIL-DEVOPS.md
│   └── PERFIL-DEVENV.md
│
└── legacy/                   # Prompts legacy (referencia extendida)
    ├── PROMPT-DATABASE-AGENT.md
    ├── PROMPT-BACKEND-AGENT.md
    └── ...
```

---

## Tipos de Agentes

### Agentes de Capa (Implementación)

| Agente | Perfil | Dominio | Responsabilidades |
|--------|--------|---------|-------------------|
| **Database-Agent** | PERFIL-DATABASE.md | PostgreSQL | DDL, schemas, tablas, RLS, seeds |
| **Backend-Agent** | PERFIL-BACKEND.md | NestJS | Entities, Services, Controllers, API |
| **Backend-Express-Agent** | PERFIL-BACKEND-EXPRESS.md | Express | Prisma/Drizzle, APIs |
| **Frontend-Agent** | PERFIL-FRONTEND.md | React | Componentes, Pages, Stores, Hooks |
| **Mobile-Agent** | PERFIL-MOBILE-AGENT.md | React Native | Apps móviles |
| **ML-Specialist** | PERFIL-ML-SPECIALIST.md | Python/ML | Modelos, pipelines, inferencia |
| **LLM-Agent** | PERFIL-LLM-AGENT.md | LLM/AI | Integración LLM, tools, chat |
| **Trading-Strategist** | PERFIL-TRADING-STRATEGIST.md | Trading | Estrategias, backtesting, señales |

### Agentes de Coordinación

| Agente | Perfil | Dominio | Responsabilidades |
|--------|--------|---------|-------------------|
| **Orquestador** | PERFIL-ORQUESTADOR.md | Coordinación | Ciclo CAPVED, delegación, gates |
| **Tech-Leader** | PERFIL-TECH-LEADER.md | Liderazgo | Decisiones técnicas, mentoring |
| **Architecture-Analyst** | PERFIL-ARCHITECTURE-ANALYST.md | Arquitectura | Validación, alineación, ADRs |
| **Requirements-Analyst** | PERFIL-REQUIREMENTS-ANALYST.md | Análisis | Gap analysis, specs, user stories |

### Agentes de Calidad

| Agente | Perfil | Dominio | Responsabilidades |
|--------|--------|---------|-------------------|
| **Code-Reviewer** | PERFIL-CODE-REVIEWER.md | Revisión | Revisión de código, code smells |
| **Bug-Fixer** | PERFIL-BUG-FIXER.md | Corrección | Diagnóstico y fix de bugs |
| **Testing-Agent** | PERFIL-TESTING.md | QA | Tests unitarios, integración, E2E |
| **Documentation-Validator** | PERFIL-DOCUMENTATION-VALIDATOR.md | Documentación | Validación PRE-implementación |
| **Workspace-Manager** | PERFIL-WORKSPACE-MANAGER.md | Gobernanza | Limpieza, organización, propagación |

### Agentes de Auditoría

| Agente | Perfil | Dominio | Responsabilidades |
|--------|--------|---------|-------------------|
| **Security-Auditor** | PERFIL-SECURITY-AUDITOR.md | Seguridad | OWASP, vulnerabilidades, CVEs |
| **Database-Auditor** | PERFIL-DATABASE-AUDITOR.md | BD | Política carga limpia, integridad |
| **Policy-Auditor** | PERFIL-POLICY-AUDITOR.md | Cumplimiento | Directivas, inventarios, nomenclatura |
| **Integration-Validator** | PERFIL-INTEGRATION-VALIDATOR.md | Integración | Coherencia 3 capas, E2E |

### Agentes de Infraestructura

| Agente | Perfil | Dominio | Responsabilidades |
|--------|--------|---------|-------------------|
| **DevOps-Agent** | PERFIL-DEVOPS.md | CI/CD | Pipelines, despliegues, infra |
| **DevEnv-Agent** | PERFIL-DEVENV.md | Ambiente | Setup de desarrollo, herramientas |

---

## Sistema de Perfiles SIMCO

### ¿Qué es un Perfil SIMCO?

Un perfil SIMCO es un documento **ligero** (~100-200 líneas) que define:

1. **Protocolo CCA:** Carga de Contexto Automática (6 pasos)
2. **Identidad:** Nombre, alias, dominio
3. **Responsabilidades:** Lo que SÍ y NO hace el agente
4. **Directivas:** Qué archivos SIMCO seguir
5. **Flujo de trabajo:** Pasos típicos
6. **Aliases relevantes:** Para navegación rápida

### Diferencia con Legacy

| Aspecto | Perfiles SIMCO | Legacy |
|---------|----------------|--------|
| Líneas | ~100-200 | ~700-850 |
| Enfoque | Qué hacer | Cómo hacer todo |
| Directivas | Referencias a SIMCO | Contenido duplicado |
| Mantenimiento | Actualizar 1 fuente | Actualizar N archivos |

---

## Protocolo CCA (Carga de Contexto Automática)

Todos los perfiles SIMCO incluyen el protocolo CCA de 6 pasos:

```yaml
PASO_0: Identificar nivel jerárquico (SIMCO-NIVELES.md)
PASO_1: Identificar perfil, proyecto, tarea, operación
PASO_2: Cargar core (catálogo, principios, SIMCO)
PASO_3: Cargar proyecto (CONTEXTO-PROYECTO.md, inventarios)
PASO_4: Cargar operación (SIMCO específico según tarea)
PASO_5: Cargar tarea (docs relevantes)
PASO_6: Verificar dependencias/contexto
```

---

## Flujo de Delegación

```
┌─────────────────────────────────────────────────────────────────────┐
│                    FLUJO DE DELEGACIÓN                               │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│   ┌─────────────────────┐                                           │
│   │    ORQUESTADOR      │  Ejecuta CAPVED completo                  │
│   │  (Tech-Leader)      │  Gate Fase V: NO DELEGAR                  │
│   └─────────┬───────────┘                                           │
│             │                                                        │
│   ┌─────────▼───────────┐                                           │
│   │  AGENTES DE CAPA    │  Implementan por dominio                  │
│   │  DB / BE / FE       │  Siguen SIMCO específicos                 │
│   └─────────┬───────────┘                                           │
│             │                                                        │
│   ┌─────────▼───────────┐                                           │
│   │  AGENTES ESPECIAL.  │  Tareas específicas                       │
│   │  Reviewer, Fixer... │  Siguen sus perfiles                      │
│   └─────────────────────┘                                           │
│                                                                      │
│   VALIDACIÓN:                                                       │
│   - Architecture-Analyst → Gate Fase V (decisiones complejas)       │
│   - Documentation-Validator → PRE-implementación                    │
│   - Code-Reviewer → POST-implementación                             │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘
```

---

## Uso Rápido

### Para iniciar como agente:

```markdown
1. Leer tu perfil: agents/perfiles/PERFIL-{TU-TIPO}.md
2. Ejecutar protocolo CCA (6 pasos)
3. Seguir directivas SIMCO indicadas en tu perfil
4. Al completar: SIMCO-VALIDAR.md + SIMCO-DOCUMENTAR.md
```

### Para delegar a un agente:

```markdown
1. Leer SIMCO-DELEGACION.md
2. Usar template de delegación
3. Incluir:
   - Perfil a usar
   - Principios a leer
   - SIMCO relevantes
   - Variables resueltas
   - Criterios de aceptación
```

---

## Referencias

### Directivas SIMCO

- `directivas/simco/_INDEX.md` - Índice del sistema SIMCO
- `directivas/simco/SIMCO-TAREA.md` - Ciclo CAPVED
- `directivas/simco/SIMCO-DELEGACION.md` - Protocolo de delegación

### Principios Fundamentales

- `directivas/principios/PRINCIPIO-CAPVED.md`
- `directivas/principios/PRINCIPIO-DOC-PRIMERO.md`
- `directivas/principios/PRINCIPIO-ANTI-DUPLICACION.md`
- `directivas/principios/PRINCIPIO-VALIDACION-OBLIGATORIA.md`
- `directivas/principios/PRINCIPIO-ECONOMIA-TOKENS.md`

### Prompts Legacy (Referencia Extendida)

Para detalles adicionales específicos, consultar `agents/legacy/PROMPT-*-AGENT.md`

---

**Versión:** 1.6.0 | **Sistema:** SIMCO v2.3.0 + CAPVED | **Actualizado:** 2025-12-12