workspace/core/orchestration/agents

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:

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