# MAPA DE CONTEXTO POR AGENTE

**Versión:** 2.1.0
**Sistema:** SIMCO + CAPVED + Niveles Jerárquicos + Economía de Tokens
**Propósito:** Trazabilidad completa de qué debe leer cada agente según perfil, proyecto y tarea

---

## ESTRUCTURA DE CARGA: GENERAL → ESPECÍFICO

```
┌─────────────────────────────────────────────────────────────────────────┐
│                         NIVEL 1: CORE (Universal)                        │
│            Aplica a TODOS los agentes, TODOS los proyectos              │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐       │
│  │   PRINCIPIOS     │  │     PERFILES     │  │    REFERENCIAS   │       │
│  │  (5 Obligatorios)│  │  (Según tipo)    │  │   (Navegación)   │       │
│  ├──────────────────┤  ├──────────────────┤  ├──────────────────┤       │
│  │ CAPVED           │  │ PERFIL-DATABASE  │  │ ALIASES.yml      │       │
│  │ Doc-Primero      │  │ PERFIL-BACKEND   │  │ _INDEX.md        │       │
│  │ Anti-Duplicación │  │ PERFIL-FRONTEND  │  │ SIMCO-TAREA.md   │       │
│  │ Validación-Oblig │  │ PERFIL-ORQUEST.  │  │ SIMCO-NIVELES.md │       │
│  │ Economía-Tokens🆕│  │                  │  │ QUICK-REF.md 🆕  │       │
│  └──────────────────┘  └──────────────────┘  └──────────────────┘       │
│                                                                          │
└───────────────────────────────────┬─────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                      NIVEL 2: PROYECTO (Por proyecto)                    │
│                    Específico del proyecto asignado                      │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐       │
│  │    CONTEXTO      │  │   INVENTARIOS    │  │     TRAZAS       │       │
│  │   (Obligatorio)  │  │  (Estado actual) │  │   (Historial)    │       │
│  ├──────────────────┤  ├──────────────────┤  ├──────────────────┤       │
│  │ CONTEXTO-PROY.md │  │ MASTER_INV.yml   │  │ TRAZA-DB.md      │       │
│  │ PROXIMA-ACCION   │  │ DATABASE_INV.yml │  │ TRAZA-BE.md      │       │
│  │                  │  │ BACKEND_INV.yml  │  │ TRAZA-FE.md      │       │
│  │                  │  │ FRONTEND_INV.yml │  │                  │       │
│  └──────────────────┘  └──────────────────┘  └──────────────────┘       │
│                                                                          │
└───────────────────────────────────┬─────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                     NIVEL 3: OPERACIÓN (Por tipo de tarea)               │
│                      Según lo que vas a hacer                            │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐       │
│  │  SIMCO TAREA(🆕) │  │  SIMCO OPERACIÓN │  │  SIMCO DOMINIO   │       │
│  │  (Ciclo CAPVED)  │  │  (Según acción)  │  │  (Según capa)    │       │
│  ├──────────────────┤  ├──────────────────┤  ├──────────────────┤       │
│  │ SIMCO-TAREA.md   │  │ SIMCO-CREAR      │  │ SIMCO-DDL        │       │
│  │ (Punto entrada   │  │ SIMCO-MODIFICAR  │  │ SIMCO-BACKEND    │       │
│  │  para toda HU)   │  │ SIMCO-VALIDAR    │  │ SIMCO-FRONTEND   │       │
│  │                  │  │ SIMCO-DOCUMENTAR │  │                  │       │
│  │                  │  │ SIMCO-BUSCAR     │  │                  │       │
│  │                  │  │ SIMCO-DELEGACION │  │                  │       │
│  └──────────────────┘  └──────────────────┘  └──────────────────┘       │
│                                                                          │
└───────────────────────────────────┬─────────────────────────────────────┘
                                    │
                                    ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                       NIVEL 4: TAREA (Específico)                        │
│                   Lo que necesitas para ESTA tarea                       │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐       │
│  │  DOCUMENTACIÓN   │  │ CÓDIGO EXISTENTE │  │  DEPENDENCIAS    │       │
│  │  (Specs/Diseño)  │  │   (Patrones)     │  │  (Pre-requisitos)│       │
│  ├──────────────────┤  ├──────────────────┤  ├──────────────────┤       │
│  │ docs/diseño/*.md │  │ Módulos similar. │  │ Tablas requerid. │       │
│  │ docs/api/*.md    │  │ Entities similar.│  │ Endpoints req.   │       │
│  │ docs/wireframes/ │  │ Components sim.  │  │ Types requeridos │       │
│  │ docs/adr/*.md    │  │ Hooks similares  │  │                  │       │
│  └──────────────────┘  └──────────────────┘  └──────────────────┘       │
│                                                                          │
└─────────────────────────────────────────────────────────────────────────┘
```

---

## MAPA DETALLADO POR PERFIL

### DATABASE-AGENT

```yaml
# ═══════════════════════════════════════════════════════════════
# MAPA DE CONTEXTO: DATABASE-AGENT
# ═══════════════════════════════════════════════════════════════

NIVEL_1_CORE:
  obligatorio:
    - path: "core/orchestration/directivas/principios/PRINCIPIO-CAPVED.md"
      proposito: "🆕 Ciclo de vida de tareas (C-A-P-V-E-D)"
      tiempo: "2 min"

    - path: "core/orchestration/directivas/principios/PRINCIPIO-DOC-PRIMERO.md"
      proposito: "Consultar docs/ antes de crear DDL"
      tiempo: "1 min"

    - path: "core/orchestration/directivas/principios/PRINCIPIO-ANTI-DUPLICACION.md"
      proposito: "Verificar tabla no existe en inventario"
      tiempo: "1 min"

    - path: "core/orchestration/directivas/principios/PRINCIPIO-VALIDACION-OBLIGATORIA.md"
      proposito: "Carga limpia DEBE pasar"
      tiempo: "1 min"

    - path: "core/orchestration/agents/perfiles/PERFIL-DATABASE.md"
      proposito: "Mi identidad, responsabilidades, qué delegar"
      tiempo: "2 min"

    - path: "core/orchestration/directivas/simco/_INDEX.md"
      proposito: "Entender sistema SIMCO"
      tiempo: "1 min"

    - path: "core/orchestration/directivas/simco/SIMCO-TAREA.md"
      proposito: "🆕 Proceso CAPVED completo para toda HU"
      tiempo: "3 min"

    - path: "core/orchestration/referencias/ALIASES.yml"
      proposito: "Resolver @ALIAS"
      tiempo: "1 min"

NIVEL_2_PROYECTO:
  obligatorio:
    - path: "projects/{PROYECTO}/orchestration/00-guidelines/CONTEXTO-PROYECTO.md"
      proposito: "Variables: DB_NAME, DB_DDL_PATH, SCHEMAS"
      tiempo: "3 min"

    - path: "projects/{PROYECTO}/orchestration/PROXIMA-ACCION.md"
      proposito: "Verificar prioridad y contexto previo"
      tiempo: "1 min"

    - path: "projects/{PROYECTO}/orchestration/inventarios/DATABASE_INVENTORY.yml"
      proposito: "Estado actual de tablas, funciones, triggers"
      tiempo: "2 min"

  opcional:
    - path: "projects/{PROYECTO}/orchestration/trazas/TRAZA-TAREAS-DATABASE.md"
      proposito: "Historial de cambios en BD"
      cuando: "Si necesito contexto de cambios previos"

NIVEL_3_OPERACION:
  segun_tarea:
    crear_tabla:
      - path: "core/orchestration/directivas/simco/SIMCO-CREAR.md"
        proposito: "Proceso de creación"
      - path: "core/orchestration/directivas/simco/SIMCO-DDL.md"
        proposito: "Reglas específicas DDL"

    modificar_tabla:
      - path: "core/orchestration/directivas/simco/SIMCO-MODIFICAR.md"
        proposito: "Análisis de impacto"
      - path: "core/orchestration/directivas/simco/SIMCO-DDL.md"
        proposito: "Reglas específicas DDL"

    crear_funcion:
      - path: "core/orchestration/directivas/simco/SIMCO-CREAR.md"
      - path: "core/orchestration/directivas/simco/SIMCO-DDL.md"

    crear_indice:
      - path: "core/orchestration/directivas/simco/SIMCO-CREAR.md"
      - path: "core/orchestration/directivas/simco/SIMCO-DDL.md"

NIVEL_4_TAREA:
  documentacion:
    - path: "projects/{PROYECTO}/docs/{spec-entidad}.md"
      proposito: "Especificación de la entidad a crear"

    - path: "projects/{PROYECTO}/docs/01-fase-*/diseño-base-datos.md"
      proposito: "Diseño general de BD"

  codigo_existente:
    - path: "@DDL/{schema}/"
      proposito: "DDL existente del schema para seguir convenciones"

    - path: "@DDL_ROOT/00-init.sql"
      proposito: "Estructura base y extensiones"

  dependencias:
    - verificar: "Schema existe"
      donde: "@DDL_ROOT/00-init.sql"

    - verificar: "Extensiones requeridas habilitadas"
      donde: "@DDL_ROOT/00-init.sql"

# ═══════════════════════════════════════════════════════════════
# RESUMEN: ~17 archivos, ~20 minutos de lectura inicial (con CAPVED)
# ═══════════════════════════════════════════════════════════════
```

### BACKEND-AGENT

```yaml
# ═══════════════════════════════════════════════════════════════
# MAPA DE CONTEXTO: BACKEND-AGENT
# ═══════════════════════════════════════════════════════════════

NIVEL_1_CORE:
  obligatorio:
    - path: "core/orchestration/directivas/principios/PRINCIPIO-CAPVED.md"
      proposito: "🆕 Ciclo de vida de tareas (C-A-P-V-E-D)"
      tiempo: "2 min"

    - path: "core/orchestration/directivas/principios/PRINCIPIO-DOC-PRIMERO.md"
      proposito: "Consultar docs/ y DDL antes de crear Entity"
      tiempo: "1 min"

    - path: "core/orchestration/directivas/principios/PRINCIPIO-ANTI-DUPLICACION.md"
      proposito: "Verificar entity/service no existe"
      tiempo: "1 min"

    - path: "core/orchestration/directivas/principios/PRINCIPIO-VALIDACION-OBLIGATORIA.md"
      proposito: "npm run build + lint DEBEN pasar"
      tiempo: "1 min"

    - path: "core/orchestration/agents/perfiles/PERFIL-BACKEND.md"
      proposito: "Mi identidad, responsabilidades, qué delegar"
      tiempo: "2 min"

    - path: "core/orchestration/directivas/simco/_INDEX.md"
      proposito: "Entender sistema SIMCO"
      tiempo: "1 min"

    - path: "core/orchestration/directivas/simco/SIMCO-TAREA.md"
      proposito: "🆕 Proceso CAPVED completo para toda HU"
      tiempo: "3 min"

    - path: "core/orchestration/referencias/ALIASES.yml"
      proposito: "Resolver @ALIAS"
      tiempo: "1 min"

NIVEL_2_PROYECTO:
  obligatorio:
    - path: "projects/{PROYECTO}/orchestration/00-guidelines/CONTEXTO-PROYECTO.md"
      proposito: "Variables: BACKEND_ROOT, BACKEND_SRC, MODULES"
      tiempo: "3 min"

    - path: "projects/{PROYECTO}/orchestration/PROXIMA-ACCION.md"
      proposito: "Verificar prioridad y contexto previo"
      tiempo: "1 min"

    - path: "projects/{PROYECTO}/orchestration/inventarios/BACKEND_INVENTORY.yml"
      proposito: "Estado actual de entities, services, controllers"
      tiempo: "2 min"

    - path: "projects/{PROYECTO}/orchestration/inventarios/DATABASE_INVENTORY.yml"
      proposito: "Conocer tablas existentes para alinear entities"
      tiempo: "2 min"

  opcional:
    - path: "projects/{PROYECTO}/orchestration/trazas/TRAZA-TAREAS-BACKEND.md"
      proposito: "Historial de cambios en Backend"
      cuando: "Si necesito contexto de cambios previos"

NIVEL_3_OPERACION:
  segun_tarea:
    crear_modulo:
      - path: "core/orchestration/directivas/simco/SIMCO-CREAR.md"
        proposito: "Proceso de creación"
      - path: "core/orchestration/directivas/simco/SIMCO-BACKEND.md"
        proposito: "Reglas específicas NestJS"

    crear_entity:
      - path: "core/orchestration/directivas/simco/SIMCO-CREAR.md"
      - path: "core/orchestration/directivas/simco/SIMCO-BACKEND.md"

    crear_endpoint:
      - path: "core/orchestration/directivas/simco/SIMCO-CREAR.md"
      - path: "core/orchestration/directivas/simco/SIMCO-BACKEND.md"

    modificar_service:
      - path: "core/orchestration/directivas/simco/SIMCO-MODIFICAR.md"
        proposito: "Análisis de impacto"
      - path: "core/orchestration/directivas/simco/SIMCO-BACKEND.md"

NIVEL_4_TAREA:
  documentacion:
    - path: "projects/{PROYECTO}/docs/{spec-api}.md"
      proposito: "Especificación de endpoints"

    - path: "projects/{PROYECTO}/docs/01-fase-*/diseño-api.md"
      proposito: "Diseño general de API"

  codigo_existente:
    - path: "@DDL/{schema}/{tabla}.sql"
      proposito: "DDL de la tabla para alinear Entity"
      critico: true

    - path: "@BACKEND/{modulo-similar}/"
      proposito: "Módulo similar para seguir patrones"

    - path: "@BACKEND_SHARED/"
      proposito: "Utilidades compartidas"

  dependencias:
    - verificar: "Tabla existe en DDL"
      donde: "@INV_DB"
      si_no_existe: "Delegar a Database-Agent"

    - verificar: "Módulo padre existe"
      donde: "@INV_BE"

# ═══════════════════════════════════════════════════════════════
# RESUMEN: ~20 archivos, ~22 minutos de lectura inicial (con CAPVED)
# ═══════════════════════════════════════════════════════════════
```

### FRONTEND-AGENT

```yaml
# ═══════════════════════════════════════════════════════════════
# MAPA DE CONTEXTO: FRONTEND-AGENT
# ═══════════════════════════════════════════════════════════════

NIVEL_1_CORE:
  obligatorio:
    - path: "core/orchestration/directivas/principios/PRINCIPIO-CAPVED.md"
      proposito: "🆕 Ciclo de vida de tareas (C-A-P-V-E-D)"
      tiempo: "2 min"

    - path: "core/orchestration/directivas/principios/PRINCIPIO-DOC-PRIMERO.md"
      proposito: "Consultar wireframes/mockups antes de crear componente"
      tiempo: "1 min"

    - path: "core/orchestration/directivas/principios/PRINCIPIO-ANTI-DUPLICACION.md"
      proposito: "Verificar componente/hook no existe"
      tiempo: "1 min"

    - path: "core/orchestration/directivas/principios/PRINCIPIO-VALIDACION-OBLIGATORIA.md"
      proposito: "npm run build + lint + typecheck DEBEN pasar"
      tiempo: "1 min"

    - path: "core/orchestration/agents/perfiles/PERFIL-FRONTEND.md"
      proposito: "Mi identidad, responsabilidades, qué delegar"
      tiempo: "2 min"

    - path: "core/orchestration/directivas/simco/_INDEX.md"
      proposito: "Entender sistema SIMCO"
      tiempo: "1 min"

    - path: "core/orchestration/directivas/simco/SIMCO-TAREA.md"
      proposito: "🆕 Proceso CAPVED completo para toda HU"
      tiempo: "3 min"

    - path: "core/orchestration/referencias/ALIASES.yml"
      proposito: "Resolver @ALIAS"
      tiempo: "1 min"

NIVEL_2_PROYECTO:
  obligatorio:
    - path: "projects/{PROYECTO}/orchestration/00-guidelines/CONTEXTO-PROYECTO.md"
      proposito: "Variables: FRONTEND_ROOT, API_BASE_URL, APPS"
      tiempo: "3 min"

    - path: "projects/{PROYECTO}/orchestration/PROXIMA-ACCION.md"
      proposito: "Verificar prioridad y contexto previo"
      tiempo: "1 min"

    - path: "projects/{PROYECTO}/orchestration/inventarios/FRONTEND_INVENTORY.yml"
      proposito: "Estado actual de componentes, pages, hooks"
      tiempo: "2 min"

    - path: "projects/{PROYECTO}/orchestration/inventarios/BACKEND_INVENTORY.yml"
      proposito: "Conocer endpoints disponibles y DTOs"
      tiempo: "2 min"

  opcional:
    - path: "projects/{PROYECTO}/orchestration/trazas/TRAZA-TAREAS-FRONTEND.md"
      proposito: "Historial de cambios en Frontend"
      cuando: "Si necesito contexto de cambios previos"

NIVEL_3_OPERACION:
  segun_tarea:
    crear_componente:
      - path: "core/orchestration/directivas/simco/SIMCO-CREAR.md"
        proposito: "Proceso de creación"
      - path: "core/orchestration/directivas/simco/SIMCO-FRONTEND.md"
        proposito: "Reglas específicas React"

    crear_pagina:
      - path: "core/orchestration/directivas/simco/SIMCO-CREAR.md"
      - path: "core/orchestration/directivas/simco/SIMCO-FRONTEND.md"

    crear_hook:
      - path: "core/orchestration/directivas/simco/SIMCO-CREAR.md"
      - path: "core/orchestration/directivas/simco/SIMCO-FRONTEND.md"

    modificar_componente:
      - path: "core/orchestration/directivas/simco/SIMCO-MODIFICAR.md"
        proposito: "Análisis de impacto"
      - path: "core/orchestration/directivas/simco/SIMCO-FRONTEND.md"

NIVEL_4_TAREA:
  documentacion:
    - path: "projects/{PROYECTO}/docs/{wireframe}.md"
      proposito: "Diseño visual del componente"

    - path: "projects/{PROYECTO}/docs/01-fase-*/diseño-ui.md"
      proposito: "Diseño general de UI"

  codigo_existente:
    - path: "@BACKEND/{modulo}/dto/*.dto.ts"
      proposito: "DTOs para alinear types del frontend"
      critico: true

    - path: "@FRONTEND_SHARED/components/"
      proposito: "Componentes reutilizables existentes"

    - path: "@FRONTEND/{app-similar}/"
      proposito: "App similar para seguir patrones"

  dependencias:
    - verificar: "Endpoint existe"
      donde: "@INV_BE"
      si_no_existe: "Delegar a Backend-Agent"

    - verificar: "Types base existen"
      donde: "@FRONTEND_SHARED/types/"

# ═══════════════════════════════════════════════════════════════
# RESUMEN: ~20 archivos, ~22 minutos de lectura inicial (con CAPVED)
# ═══════════════════════════════════════════════════════════════
```

### ORQUESTADOR (Tech-Leader)

```yaml
# ═══════════════════════════════════════════════════════════════
# MAPA DE CONTEXTO: ORQUESTADOR
# ═══════════════════════════════════════════════════════════════

NIVEL_1_CORE:
  obligatorio:
    - path: "core/orchestration/directivas/principios/PRINCIPIO-CAPVED.md"
      proposito: "🆕 Ciclo de vida de tareas - CRÍTICO para orquestación"
      tiempo: "3 min"

    - path: "core/orchestration/directivas/principios/PRINCIPIO-DOC-PRIMERO.md"
      proposito: "Asegurar que subagentes consulten docs/"
      tiempo: "1 min"

    - path: "core/orchestration/directivas/principios/PRINCIPIO-ANTI-DUPLICACION.md"
      proposito: "Validar que no se duplique trabajo"
      tiempo: "1 min"

    - path: "core/orchestration/directivas/principios/PRINCIPIO-VALIDACION-OBLIGATORIA.md"
      proposito: "Exigir validaciones a subagentes"
      tiempo: "1 min"

    - path: "core/orchestration/agents/perfiles/PERFIL-ORQUESTADOR.md"
      proposito: "Mi rol: coordinar, NO implementar"
      tiempo: "2 min"

    - path: "core/orchestration/directivas/simco/_INDEX.md"
      proposito: "Entender sistema para delegar correctamente"
      tiempo: "1 min"

    - path: "core/orchestration/directivas/simco/SIMCO-TAREA.md"
      proposito: "🆕 Proceso CAPVED completo - ejecutar fases V directamente"
      tiempo: "3 min"

    - path: "core/orchestration/referencias/ALIASES.yml"
      proposito: "Resolver @ALIAS para subagentes"
      tiempo: "1 min"

NIVEL_2_PROYECTO:
  obligatorio:
    - path: "projects/{PROYECTO}/orchestration/00-guidelines/CONTEXTO-PROYECTO.md"
      proposito: "Visión completa del proyecto"
      tiempo: "5 min"

    - path: "projects/{PROYECTO}/orchestration/PROXIMA-ACCION.md"
      proposito: "Prioridades y estado actual"
      tiempo: "2 min"

    - path: "projects/{PROYECTO}/orchestration/inventarios/MASTER_INVENTORY.yml"
      proposito: "Estado completo de todas las capas"
      tiempo: "3 min"

  opcional:
    - path: "projects/{PROYECTO}/orchestration/inventarios/DATABASE_INVENTORY.yml"
    - path: "projects/{PROYECTO}/orchestration/inventarios/BACKEND_INVENTORY.yml"
    - path: "projects/{PROYECTO}/orchestration/inventarios/FRONTEND_INVENTORY.yml"
      proposito: "Detalle por capa si necesario"

NIVEL_3_OPERACION:
  segun_tarea:
    planificar_feature:
      - path: "core/orchestration/directivas/simco/SIMCO-BUSCAR.md"
        proposito: "Investigar estado actual"
      - path: "core/orchestration/directivas/simco/SIMCO-DELEGACION.md"
        proposito: "Preparar delegación"

    coordinar_epic:
      - path: "core/orchestration/directivas/simco/SIMCO-DELEGACION.md"
        proposito: "Delegar a múltiples agentes"

    validar_entregas:
      - path: "core/orchestration/directivas/simco/SIMCO-VALIDAR.md"
        proposito: "Criterios de aceptación"

NIVEL_4_TAREA:
  documentacion:
    - path: "projects/{PROYECTO}/docs/"
      proposito: "Documentación completa del proyecto"
      leer: "Visión general y especificaciones relevantes"

  dependencias_entre_tareas:
    - mapear: "Qué debe existir antes de qué"
    - ejemplo: "DDL → Entity → Service → Controller → Frontend"

# ═══════════════════════════════════════════════════════════════
# RESUMEN: ~14 archivos core, +N según complejidad (con CAPVED)
# NOTA: Orquestador ejecuta fases V (Validación) DIRECTAMENTE
# ═══════════════════════════════════════════════════════════════
```

---

## FLUJO VISUAL DE CARGA

```
                    ┌─────────────────────────────────┐
                    │    PROMPT DE INICIALIZACIÓN     │
                    │  "Serás X en proyecto Y para Z" │
                    └──────────────┬──────────────────┘
                                   │
                    ┌──────────────▼──────────────────┐
                    │  PASO_0: IDENTIFICAR NIVEL 🆕   │
                    │  Leer: SIMCO-NIVELES.md         │
                    │  Determinar: NIVEL_0|1|2A|2B|3  │
                    │  Calcular: orchestration_path   │
                    │  Definir: propagate_to          │
                    └──────────────┬──────────────────┘
                                   │
                    ┌──────────────▼──────────────────┐
                    │     PASO_1: IDENTIFICACIÓN      │
                    │  Extraer: PERFIL, PROYECTO,     │
                    │  TAREA, OPERACIÓN, DOMINIO      │
                    └──────────────┬──────────────────┘
                                   │
        ┌──────────────────────────┼──────────────────────────┐
        │                          │                          │
        ▼                          ▼                          ▼
┌───────────────┐        ┌───────────────┐        ┌───────────────┐
│   PRINCIPIOS  │        │   MI PERFIL   │        │    ALIASES    │
│  (5 archivos) │        │ PERFIL-X.md   │        │  ALIASES.yml  │
│  incl. CAPVED │        │               │        │ SIMCO-TAREA   │
│  incl. TOKENS │        │               │        │ SIMCO-NIVELES │
└───────┬───────┘        └───────┬───────┘        └───────┬───────┘
        │                        │                        │
        └────────────────────────┼────────────────────────┘
                                 │
                    ┌────────────▼────────────────┐
                    │   NIVEL 2: PROYECTO         │
                    │  CONTEXTO-PROYECTO.md       │
                    │  PROXIMA-ACCION.md          │
                    │  {INVENTARIO}_INVENTORY.yml │
                    └────────────┬────────────────┘
                                 │
                    ┌────────────▼────────────────┐
                    │   NIVEL 3: OPERACIÓN        │
                    │  SIMCO-{OPERACION}.md       │
                    │  SIMCO-{DOMINIO}.md         │
                    └────────────┬────────────────┘
                                 │
                    ┌────────────▼────────────────┐
                    │   NIVEL 4: TAREA            │
                    │  docs/{especificaciones}    │
                    │  código existente similar   │
                    │  dependencias identificadas │
                    └────────────┬────────────────┘
                                 │
                    ┌────────────▼────────────────┐
                    │      READY TO EXECUTE       │
                    │  Contexto completo cargado  │
                    │  Sin alucinaciones posibles │
                    └────────────┬────────────────┘
                                 │
                    ┌────────────▼────────────────┐
                    │   POST-EJECUCIÓN: PROPAGAR  │
                    │  Ejecutar SIMCO-PROPAGACION │
                    │  Actualizar niveles super.  │
                    │  Verificar coherencia docs  │
                    └─────────────────────────────┘
```

---

## RESOLUCIÓN DE DEPENDENCIAS

### Si algo NO existe, delegar:

```yaml
Database-Agent necesita:
  - Schema no existe → Error: debe existir en 00-init.sql
  - Extensión no habilitada → Error: agregar a 00-init.sql

Backend-Agent necesita:
  - Tabla no existe → DELEGAR a Database-Agent
  - Entity relacionada no existe → Crear primero (mismo agente)

Frontend-Agent necesita:
  - Endpoint no existe → DELEGAR a Backend-Agent
  - Type no existe → Crear primero (mismo agente)
  - Componente base no existe → Crear primero (mismo agente)

Orquestador necesita:
  - Cualquier implementación → DELEGAR a agente especializado
  - Validaciones → Ejecutar directamente (no delegar)
```

---

## TEMPLATE: REPORTE DE CONTEXTO CARGADO

Al completar CCA, generar este reporte:

```yaml
# REPORTE DE CONTEXTO CARGADO
# ═══════════════════════════════════════════════════════════════

agente: "{PERFIL}"
proyecto: "{PROYECTO}"
tarea: "{DESCRIPCION}"
timestamp: "{YYYY-MM-DD HH:MM}"

archivos_leidos:
  nivel_0_jerarquico:
    - [x] SIMCO-NIVELES.md  # 🆕 Identificación de nivel
    nivel_identificado: "{NIVEL_X}"
    orchestration_path: "{ruta}"
    propagate_to: ["{niveles superiores}"]

  nivel_core:
    - [x] PRINCIPIO-CAPVED.md  # Ciclo de vida de tareas
    - [x] PRINCIPIO-DOC-PRIMERO.md
    - [x] PRINCIPIO-ANTI-DUPLICACION.md
    - [x] PRINCIPIO-VALIDACION-OBLIGATORIA.md
    - [x] PRINCIPIO-ECONOMIA-TOKENS.md  # 🆕 Límites y desglose
    - [x] PERFIL-{TIPO}.md
    - [x] SIMCO-TAREA.md  # Proceso CAPVED
    - [x] _INDEX.md (o SIMCO-QUICK-REFERENCE.md para contexto limitado)
    - [x] ALIASES.yml

  nivel_proyecto:
    - [x] CONTEXTO-PROYECTO.md
    - [x] PROXIMA-ACCION.md
    - [x] {INVENTARIO}_INVENTORY.yml

  nivel_operacion:
    - [x] SIMCO-{OPERACION}.md
    - [x] SIMCO-{DOMINIO}.md (si aplica)

  nivel_tarea:
    - [x] {docs consultados}
    - [x] {código existente revisado}

variables_resueltas:
  DB_NAME: "{valor}"
  BACKEND_ROOT: "{valor}"
  # ... otras variables del CONTEXTO-PROYECTO.md

dependencias_identificadas:
  existentes:
    - "{dependencia 1}: OK"
    - "{dependencia 2}: OK"
  faltantes:
    - "{dependencia 3}: Delegar a {Agente}"

restricciones:
  no_hacer:
    - "{lista de lo que NO debo hacer según mi perfil}"
  delegar:
    - "{lista de qué delegar y a quién}"

validaciones_requeridas:
  - "{validación 1}"
  - "{validación 2}"

estado: "READY_TO_EXECUTE"

post_ejecucion:
  propagacion:
    ejecutar: "SIMCO-PROPAGACION.md"
    actualizar:
      - "{orchestration_path}/inventarios/"
      - "{orchestration_path}/trazas/"
    propagar_a: ["{niveles superiores desde propagate_to}"]
```

---

## ARCHIVOS CLAVE DEL SISTEMA

| Archivo | Propósito | Cuándo Usar |
|---------|-----------|-------------|
| `SIMCO-NIVELES.md` | Identificar nivel jerárquico | PASO_0 - Siempre primero |
| `SIMCO-PROPAGACION.md` | Actualizar documentación en cascada | Post-ejecución |
| `SIMCO-QUICK-REFERENCE.md` | Referencia rápida (~100 líneas) | Contexto limitado |
| `PRINCIPIO-ECONOMIA-TOKENS.md` | Límites y desglose de tareas | Antes de delegar |
| `SIMCO-TAREA.md` | Ciclo CAPVED completo | Toda HU/tarea |

---

**Versión:** 2.1.0 | **Sistema:** SIMCO + CAPVED + Niveles + Tokens | **Tipo:** Mapa de Trazabilidad
