# Mapa de Contenidos: Directivas y Políticas

**Propósito:** Define directivas, políticas y procesos compartidos para todos los agentes NEXUS
**Sistema:** SIMCO + CAPVED
**Última actualización:** 2025-12-08
**Versión:** 3.1

---

## 🆕 CATÁLOGO DE FUNCIONALIDADES (CONSULTAR PRIMERO)

**ANTES de implementar funcionalidades comunes**, verificar si existe código probado:

```
core/catalog/                  # FUNCIONALIDADES REUTILIZABLES
├── CATALOG-INDEX.yml          # Índice para búsqueda rápida
├── auth/                      # Autenticación y autorización
├── session-management/        # Gestión de sesiones
├── rate-limiting/             # Limitación de tasa
├── notifications/             # Sistema de notificaciones
├── multi-tenancy/             # Soporte multi-tenant
├── feature-flags/             # Feature flags dinámicos
├── websocket/                 # Comunicación WebSocket
└── payments/                  # Integración de pagos
```

**Alias:** `@CATALOG`, `@CATALOG_INDEX`, `@REUTILIZAR`

---

## 🆕 SISTEMA SIMCO (RECOMENDADO)

El sistema SIMCO reorganiza las directivas **por tipo de operación** en lugar de por perfil de agente. Esto permite que cualquier agente siga las directivas correctas independientemente de su especialización.

### Acceso Rápido SIMCO

```
directivas/simco/              # DIRECTIVAS POR OPERACIÓN
├── _INDEX.md                  # ⭐ LEER PRIMERO - Índice del sistema
├── SIMCO-TAREA.md             # 🆕 Punto de entrada HU/Tareas (CAPVED)
├── SIMCO-REUTILIZAR.md        # Reutilizar del catálogo
├── SIMCO-CREAR.md             # Crear cualquier archivo
├── SIMCO-MODIFICAR.md         # Modificar archivos existentes
├── SIMCO-VALIDAR.md           # Validar código (build, lint)
├── SIMCO-DOCUMENTAR.md        # Documentar trabajo realizado
├── SIMCO-BUSCAR.md            # Buscar archivos e información
├── SIMCO-DELEGACION.md        # Delegar a subagentes
├── SIMCO-DDL.md               # Operaciones PostgreSQL
├── SIMCO-BACKEND.md           # Operaciones NestJS
└── SIMCO-FRONTEND.md          # Operaciones React

directivas/principios/         # PRINCIPIOS FUNDAMENTALES (5)
├── PRINCIPIO-CAPVED.md        # Ciclo de vida de tareas (C-A-P-V-E-D)
├── PRINCIPIO-DOC-PRIMERO.md   # Documentación antes de implementación
├── PRINCIPIO-ANTI-DUPLICACION.md  # Verificar @CATALOG antes de crear
├── PRINCIPIO-VALIDACION-OBLIGATORIA.md  # Build/lint obligatorios
└── PRINCIPIO-ECONOMIA-TOKENS.md  # 🆕 Desglose de tareas para evitar overload
```

### Aliases SIMCO

```yaml
# Operaciones
@CREAR:      directivas/simco/SIMCO-CREAR.md
@MODIFICAR:  directivas/simco/SIMCO-MODIFICAR.md
@VALIDAR:    directivas/simco/SIMCO-VALIDAR.md
@DOCUMENTAR: directivas/simco/SIMCO-DOCUMENTAR.md
@BUSCAR:     directivas/simco/SIMCO-BUSCAR.md
@DELEGAR:    directivas/simco/SIMCO-DELEGACION.md

# Especializados
@OP_DDL:     directivas/simco/SIMCO-DDL.md
@OP_BACKEND: directivas/simco/SIMCO-BACKEND.md
@OP_FRONTEND: directivas/simco/SIMCO-FRONTEND.md

# Principios
@PRINCIPIOS: directivas/principios/

# Sistema de aliases completo
@ALIASES:    referencias/ALIASES.yml
```

---

## 🆕 Directivas de Alto Nivel

```
directivas/
├── DIRECTIVA-REFERENCIAS-PROYECTOS.md       # 🆕 Control de referencias entre proyectos
```

**Alias:** `@REF_PROYECTOS`

Esta directiva define qué referencias son válidas entre proyectos y previene
acoplamientos no deseados. OBLIGATORIA al crear documentación de orchestration.

---

## 📋 Estructura de Archivos (Reorganizada 2025-12-08)

```
directivas/
├── _MAP.md                                  # ⭐ Este archivo
├── DIRECTIVA-REFERENCIAS-PROYECTOS.md       # 🆕 Control de refs entre proyectos
│
├── simco/                                   # 🆕 SISTEMA SIMCO (ACTIVO)
│   ├── _INDEX.md                           # Índice maestro SIMCO
│   ├── SIMCO-TAREA.md                      # Punto de entrada CAPVED
│   ├── SIMCO-INICIALIZACION.md             # Protocolo CCA
│   ├── SIMCO-CREAR.md
│   ├── SIMCO-MODIFICAR.md
│   ├── SIMCO-VALIDAR.md
│   ├── SIMCO-DOCUMENTAR.md
│   ├── SIMCO-BUSCAR.md
│   ├── SIMCO-DELEGACION.md
│   ├── SIMCO-REUTILIZAR.md                 # Usar catálogo
│   ├── SIMCO-CONTRIBUIR-CATALOGO.md        # Contribuir al catálogo
│   ├── SIMCO-NIVELES.md                    # Niveles jerárquicos
│   ├── SIMCO-PROPAGACION.md                # Propagación de docs
│   ├── SIMCO-QUICK-REFERENCE.md            # Referencia rápida
│   ├── SIMCO-DDL.md                        # Operaciones PostgreSQL
│   ├── SIMCO-BACKEND.md                    # Operaciones NestJS
│   └── SIMCO-FRONTEND.md                   # Operaciones React
│
├── principios/                              # PRINCIPIOS FUNDAMENTALES (5)
│   ├── PRINCIPIO-CAPVED.md                  # Ciclo de vida de tareas
│   ├── PRINCIPIO-DOC-PRIMERO.md
│   ├── PRINCIPIO-ANTI-DUPLICACION.md
│   ├── PRINCIPIO-VALIDACION-OBLIGATORIA.md
│   └── PRINCIPIO-ECONOMIA-TOKENS.md         # Desglose de tareas
│
└── legacy/                                  # ⚠️ REFERENCIA EXTENDIDA
    ├── README.md                            # Guía de archivos legacy
    ├── DIRECTIVA-*.md                       # Directivas del sistema anterior
    ├── DIRECTIVAS-*.md
    ├── POLITICAS-*.md
    ├── PROCESO-*.md
    ├── PROTOCOLO-*.md
    ├── ESTANDAR*.md
    ├── GUIA-*.md
    └── SISTEMA-*.md
```

---

## 🔄 Orden de Lectura Recomendado

### Con SIMCO + CAPVED (Recomendado):

```
1. simco/_INDEX.md              # Entender el sistema
2. principios/PRINCIPIO-*.md    # Los 5 principios fundamentales
3. simco/SIMCO-TAREA.md         # Para HU/Tareas que generan commit
4. simco/SIMCO-{operación}.md   # Según lo que vayas a hacer
```

### Para inicializar un agente (SIMCO + CAPVED):
1. `simco/_INDEX.md` - Entender sistema SIMCO
2. `principios/PRINCIPIO-CAPVED.md` - 🆕 Ciclo de vida de tareas
3. `principios/PRINCIPIO-DOC-PRIMERO.md`
4. `principios/PRINCIPIO-ANTI-DUPLICACION.md`
5. `principios/PRINCIPIO-VALIDACION-OBLIGATORIA.md`
6. `agents/perfiles/PERFIL-{TU-TIPO}.md` - Tu perfil específico

### Para una HU/Tarea (SIMCO + CAPVED):
1. `simco/SIMCO-TAREA.md` - 🆕 Punto de entrada (ciclo CAPVED)
2. Identificar operación → `simco/SIMCO-{operación}.md`
3. Si aplica dominio → `simco/SIMCO-{DDL|BACKEND|FRONTEND}.md`
4. Seguir checklist

---

## 📂 Directivas Legacy (Referencia Extendida)

> **Ubicación:** `directivas/legacy/`
> **Estado:** DEPRECATED pero válidos como referencia

Estos archivos fueron movidos a `legacy/` el 2025-12-08. Contienen información detallada y siguen siendo válidos como referencia extendida.

### Mapeo Legacy → SIMCO

| Archivo Legacy | Reemplazado Por |
|----------------|-----------------|
| `DIRECTIVA-FLUJO-5-FASES.md` | `PRINCIPIO-CAPVED.md` + `SIMCO-TAREA.md` |
| `DIRECTIVA-VALIDACION-DOCUMENTACION.md` | `PRINCIPIO-DOC-PRIMERO.md` |
| `DIRECTIVA-ANALISIS-IMPACTO-DEPENDENCIAS.md` | `PRINCIPIO-ANTI-DUPLICACION.md` |
| `DIRECTIVA-POLITICA-CARGA-LIMPIA.md` | `SIMCO-DDL.md` |
| `GUIA-ORQUESTACION.md` | `SIMCO-DELEGACION.md` |
| `PROCESO-VALIDACION.md` | `SIMCO-VALIDAR.md` |
| `ESTANDARES-NOMENCLATURA-BASE.md` | `SIMCO-CREAR.md` (sección nomenclatura) |
| `POLITICAS-USO-AGENTES.md` | `SIMCO-DELEGACION.md` |
| `DELIMITACION-PERFILES.md` | `agents/perfiles/PERFIL-*.md` |

**Para lista completa:** Ver `legacy/README.md`

---

## 🗺️ Perfiles de Agentes (SIMCO)

```
agents/perfiles/               # PERFILES LIGEROS
├── PERFIL-DATABASE.md         # Database-Agent condensado
├── PERFIL-BACKEND.md          # Backend-Agent condensado
├── PERFIL-FRONTEND.md         # Frontend-Agent condensado
└── PERFIL-ORQUESTADOR.md      # Tech-Leader condensado
```

---

## 🔗 Referencias Cruzadas

- **Perfiles SIMCO:** `agents/perfiles/PERFIL-*.md`
- **Perfiles Legacy:** `agents/INIT-NEXUS-*.md`, `agents/PROMPT-*-AGENT.md`
- **Templates:** `templates/TEMPLATE-*.md`
- **Aliases:** `referencias/ALIASES.yml`
- **Checklists:** `checklists/CHECKLIST-*.md`

---

## ⚠️ Principios Obligatorios (SIMCO + CAPVED)

Estos **5 principios** son **OBLIGATORIOS** y aplican a TODOS los agentes:

| Principio | Archivo | Resumen |
|-----------|---------|---------|
| **CAPVED** | `principios/PRINCIPIO-CAPVED.md` | Toda tarea pasa por C→A→P→V→E→D |
| Doc Primero | `principios/PRINCIPIO-DOC-PRIMERO.md` | Consultar docs/ ANTES de implementar |
| Anti-Duplicación | `principios/PRINCIPIO-ANTI-DUPLICACION.md` | Verificar que NO existe ANTES de crear |
| Validación | `principios/PRINCIPIO-VALIDACION-OBLIGATORIA.md` | Build + Lint DEBEN pasar |
| **Tokens** | `principios/PRINCIPIO-ECONOMIA-TOKENS.md` | 🆕 Desglosar tareas para evitar overload |

---

## 📊 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 | Principios compartidos |

---

**Creado:** 2025-11-02
**Actualizado:** 2025-12-12
**Autor:** Sistema NEXUS
**Versión:** 3.3
**Cambios v3.3:** Nueva DIRECTIVA-REFERENCIAS-PROYECTOS.md para control de referencias entre proyectos.
**Cambios v3.2:** Integración del principio ECONOMIA-TOKENS (5º principio), SIMCO-QUICK-REFERENCE.md para optimización.
**Cambios v3.1:** Integración del principio CAPVED (4º principio), SIMCO-TAREA.md como punto de entrada para HUs.
**Cambios v3.0:** Implementación del sistema SIMCO con directivas por operación, principios fundamentales, perfiles ligeros y sistema de aliases.
