workspace-v1/core/orchestration/agents/README.md

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:

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:

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:

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