# AGENTES DEL SISTEMA NEXUS

**Versión:** 1.4.0
**Fecha:** 2025-12-08
**Sistema:** SIMCO v2.2.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
├── perfiles/                 # 🆕 PERFILES SIMCO (ligeros, ~100-200 líneas)
│   ├── PERFIL-DATABASE.md
│   ├── PERFIL-BACKEND.md
│   ├── PERFIL-FRONTEND.md
│   ├── PERFIL-ORQUESTADOR.md
│   ├── PERFIL-ARCHITECTURE-ANALYST.md
│   ├── PERFIL-REQUIREMENTS-ANALYST.md
│   ├── PERFIL-CODE-REVIEWER.md
│   ├── PERFIL-BUG-FIXER.md
│   ├── PERFIL-DOCUMENTATION-VALIDATOR.md
│   └── PERFIL-WORKSPACE-MANAGER.md
│
└── legacy/                   # Prompts legacy (referencia extendida)
    ├── PROMPT-DATABASE-AGENT.md
    ├── PROMPT-BACKEND-AGENT.md
    ├── PROMPT-FRONTEND-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/Express | Entities, Services, Controllers, API |
| **Frontend-Agent** | PERFIL-FRONTEND.md | React | Componentes, Pages, Stores, Hooks |

### Agentes de Coordinación

| Agente | Perfil | Dominio | Responsabilidades |
|--------|--------|---------|-------------------|
| **Orquestador** | PERFIL-ORQUESTADOR.md | Coordinación | Ciclo CAPVED, delegación, gates |
| **Architecture-Analyst** | PERFIL-ARCHITECTURE-ANALYST.md | Arquitectura | Validación, alineación, ADRs |

### Agentes Especializados

| Agente | Perfil | Dominio | Responsabilidades |
|--------|--------|---------|-------------------|
| **Requirements-Analyst** | PERFIL-REQUIREMENTS-ANALYST.md | Análisis | Gap analysis, specs, user stories |
| **Code-Reviewer** | PERFIL-CODE-REVIEWER.md | Calidad | Revisión de código, code smells |
| **Bug-Fixer** | PERFIL-BUG-FIXER.md | Corrección | Diagnóstico y fix de bugs |
| **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 |

---

## 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.4.0 | **Sistema:** SIMCO v2.2.0 + CAPVED | **Actualizado:** 2025-12-08