# ═══════════════════════════════════════════════════════════════════════════════
# INDICE MAESTRO DE DIRECTIVAS DEL WORKSPACE
# ═══════════════════════════════════════════════════════════════════════════════
#
# Este archivo es el SSOT para todas las directivas disponibles
# Consultar antes de cargar directivas en cualquier nivel
#
# ARQUITECTURA DE HERENCIA ESCALONADA:
# - La BASE PRINCIPAL esta en workspace-v1/orchestration/ (este directorio)
# - Los subniveles solo heredan y extienden con directivas especificas
#
# ═══════════════════════════════════════════════════════════════════════════════

version: "3.8.0"
fecha_actualizacion: "2026-01-10"
descripcion: "Indice maestro - BASE PRINCIPAL en raiz del workspace"
sistema: "SIMCO v3.8 + CAPVED + Economia de Tokens + Herencia Escalonada + Modulos + Context Engineering + Estandares Documentacion + Mantenimiento Docs"

# ═══════════════════════════════════════════════════════════════════════════════
# ARQUITECTURA DE HERENCIA ESCALONADA
# ═══════════════════════════════════════════════════════════════════════════════

arquitectura:
  descripcion: "Workspace con herencia escalonada - BASE en raiz"

  base_principal:
    ruta: "orchestration/"
    proposito: "BASE PRINCIPAL - Directivas, perfiles, templates, patrones"
    contenido:
      - directivas/principios/ (6 principios)
      - directivas/simco/ (29 directivas)  # +2 nuevas
      - agents/perfiles/ (28 perfiles)
      - templates/ (24 templates)  # +2 nuevos
      - patrones/ (11 patrones)
      - checklists/ (4 checklists)  # +1 nuevo
      - referencias/
      - inventarios/
      - procesos/

  capas_que_heredan:
    - nombre: "CONTROL-PLANE"
      ruta: "control-plane/"
      hereda_de: "orchestration/"
      extiende_con: "registries, manifests, CI/CD"

    - nombre: "CORE"
      ruta: "core/"
      hereda_de: "orchestration/"
      extiende_con: "catalog, modules, standards"

    - nombre: "PROJECTS"
      ruta: "projects/"
      hereda_de: "orchestration/"
      extiende_con: "contextos y directivas especificas"

# ═══════════════════════════════════════════════════════════════════════════════
# NIVELES Y SUS DIRECTIVAS
# ═══════════════════════════════════════════════════════════════════════════════

niveles:

  # ------------------------------------------
  # NIVEL 0: WORKSPACE
  # ------------------------------------------
  WORKSPACE:
    ruta_base: "/home/isem/workspace-v1"
    descripcion: "Coordinacion global de todos los proyectos"
    directivas:
      - archivo: "orchestration/directivas/DIRECTIVA-CARGA-CONTEXTO.md"
        alias: "@CARGA-CONTEXTO"
        tipo: "proceso"
        obligatoria: true
        descripcion: "Como cargar contexto segun nivel de trabajo"

  # ------------------------------------------
  # NIVEL 0: BASE PRINCIPAL (orchestration/)
  # ------------------------------------------
  BASE_PRINCIPAL:
    ruta_base: "/home/isem/workspace-v1/orchestration"
    descripcion: "Sistema de orquestacion de agentes NEXUS v3.5 - BASE PRINCIPAL"

    principios:
      - archivo: "directivas/principios/PRINCIPIO-CAPVED.md"
        alias: "@CAPVED"
        obligatoria: true
        descripcion: "Ciclo de vida de tareas (6 fases)"

      - archivo: "directivas/principios/PRINCIPIO-DOC-PRIMERO.md"
        alias: "@DOC-PRIMERO"
        obligatoria: true
        descripcion: "Documentar antes de implementar"

      - archivo: "directivas/principios/PRINCIPIO-ANTI-DUPLICACION.md"
        alias: "@ANTI-DUP"
        obligatoria: true
        descripcion: "Verificar catalogo antes de crear"

      - archivo: "directivas/principios/PRINCIPIO-VALIDACION-OBLIGATORIA.md"
        alias: "@VALIDAR"
        obligatoria: true
        descripcion: "Build/lint obligatorios"

      - archivo: "directivas/principios/PRINCIPIO-ECONOMIA-TOKENS.md"
        alias: "@ECONOMIA"
        obligatoria: true
        descripcion: "Optimizar uso de tokens"

      - archivo: "directivas/principios/PRINCIPIO-NO-ASUMIR.md"
        alias: "@NO-ASUMIR"
        obligatoria: true
        descripcion: "Verificar antes de asumir"

    operaciones_simco:
      - archivo: "directivas/simco/SIMCO-TAREA.md"
        alias: "@TAREA"
        obligatoria: true
        descripcion: "Proceso completo para HU/tareas"

      - archivo: "directivas/simco/SIMCO-INICIALIZACION.md"
        alias: "@INIT"
        obligatoria: false
        descripcion: "Protocolo CCA de inicializacion"

      - archivo: "directivas/simco/SIMCO-CREAR.md"
        alias: "@CREAR"
        obligatoria: false
        descripcion: "Crear nuevos componentes"

      - archivo: "directivas/simco/SIMCO-MODIFICAR.md"
        alias: "@MODIFICAR"
        obligatoria: false
        descripcion: "Modificar componentes existentes"

      - archivo: "directivas/simco/SIMCO-VALIDAR.md"
        alias: "@VALIDAR-OP"
        obligatoria: false
        descripcion: "Validar implementaciones"

      - archivo: "directivas/simco/SIMCO-DOCUMENTAR.md"
        alias: "@DOCUMENTAR"
        obligatoria: false
        descripcion: "Documentar cambios"

      - archivo: "directivas/simco/SIMCO-BUSCAR.md"
        alias: "@BUSCAR"
        obligatoria: false
        descripcion: "Buscar en codebase"

      - archivo: "directivas/simco/SIMCO-DELEGACION.md"
        alias: "@DELEGAR"
        obligatoria: false
        descripcion: "Delegar a subagentes"

    # DIRECTIVAS DE SUBAGENTES Y TOKENS (v2.5.0+)
    operaciones_subagentes:
      - archivo: "directivas/simco/SIMCO-SUBAGENTE.md"
        alias: "@SUBAGENTE"
        obligatoria: false
        descripcion: "Protocolo cuando recibes delegacion"
        version: "1.0.0"
        fecha: "2026-01-07"

      - archivo: "directivas/simco/SIMCO-CCA-SUBAGENTE.md"
        alias: "@CCA_SUBAGENTE"
        obligatoria: false
        descripcion: "CCA ligero para subagentes (~1500 tokens)"
        version: "1.4.0"
        fecha: "2026-01-07"

      - archivo: "directivas/simco/SIMCO-CONTROL-TOKENS.md"
        alias: "@CONTROL_TOKENS"
        obligatoria: false
        descripcion: "Gestion de limites de tokens"
        version: "1.0.0"
        fecha: "2026-01-07"

      - archivo: "directivas/simco/SIMCO-DELEGACION-PARALELA.md"
        alias: "@DELEGACION_PARALELA"
        obligatoria: false
        descripcion: "Delegacion paralela a multiples agentes"
        version: "1.0.0"
        fecha: "2026-01-07"

    # DIRECTIVAS DE CONTEXT ENGINEERING (v2.4.0+)
    operaciones_context:
      - archivo: "directivas/simco/SIMCO-CONTEXT-ENGINEERING.md"
        alias: "@CONTEXT_ENGINEERING"
        obligatoria: false
        descripcion: "Ingenieria de contexto para agentes"
        version: "1.0.0"
        fecha: "2026-01-07"

      - archivo: "directivas/simco/SIMCO-CONTEXT-RESOLUTION.md"
        alias: "@CONTEXT_RESOLUTION"
        obligatoria: false
        descripcion: "Resolucion de contextos conflictivos"
        version: "1.0.0"
        fecha: "2026-01-07"

    # DIRECTIVAS DE GIT Y REPOSITORIOS (v2.6.0+)
    operaciones_git:
      - archivo: "directivas/simco/SIMCO-GIT.md"
        alias: "@GIT"
        obligatoria: false
        descripcion: "Control de versiones y commits"
        version: "1.0.0"
        fecha: "2026-01-07"

      - archivo: "directivas/simco/SIMCO-GIT-REMOTES.md"
        alias: "@GIT_REMOTES"
        obligatoria: false
        descripcion: "Operaciones push/pull/clone con servidores remotos"
        version: "1.0.0"
        fecha: "2026-01-07"

      - archivo: "directivas/simco/SIMCO-ESCALAMIENTO.md"
        alias: "@ESCALAMIENTO"
        obligatoria: false
        descripcion: "Escalamiento a Product Owner"
        version: "1.0.0"
        fecha: "2026-01-07"

    # DIRECTIVAS DE TOMA DE DECISIONES
    operaciones_decisiones:
      - archivo: "directivas/simco/SIMCO-ALINEACION.md"
        alias: "@ALINEACION"
        obligatoria: false
        descripcion: "Validar alineacion entre capas (DDL-Entity-DTO)"

      - archivo: "directivas/simco/SIMCO-DECISION-MATRIZ.md"
        alias: "@DECISION_MATRIZ"
        obligatoria: false
        descripcion: "Matriz de decision para agentes"
        version: "1.0.0"
        fecha: "2026-01-07"

      - archivo: "directivas/simco/SIMCO-ASIGNACION-PERFILES.md"
        alias: "@ASIGNACION_PERFILES"
        obligatoria: false
        descripcion: "Mapeo de perfiles a tareas"
        version: "1.0.0"
        fecha: "2026-01-04"

    # DIRECTIVAS ADICIONALES
    operaciones_adicionales:
      - archivo: "directivas/simco/SIMCO-CAPVED-PLUS.md"
        alias: "@CAPVED_PLUS"
        obligatoria: false
        descripcion: "Extension del ciclo CAPVED"
        version: "1.0.0"

      - archivo: "directivas/simco/SIMCO-ERROR-RECURRENTE.md"
        alias: "@ERROR_RECURRENTE"
        obligatoria: false
        descripcion: "Tratamiento de errores recurrentes"
        version: "1.0.0"

      - archivo: "directivas/simco/SIMCO-SCRUM-INTEGRATION.md"
        alias: "@SCRUM"
        obligatoria: false
        descripcion: "Integracion con Scrum"
        version: "1.0.0"

      - archivo: "directivas/simco/SIMCO-QUICK-REFERENCE.md"
        alias: "@QUICK_REF"
        obligatoria: false
        descripcion: "Referencia rapida optimizada"
        version: "1.0.0"

      - archivo: "directivas/simco/SIMCO-RAG.md"
        alias: "@RAG"
        obligatoria: false
        descripcion: "Retrieval-Augmented Generation"
        version: "1.0.0"

      - archivo: "directivas/simco/SIMCO-MCP.md"
        alias: "@MCP"
        obligatoria: false
        descripcion: "Protocolo de Contexto de Maquina"
        version: "1.0.0"

      - archivo: "directivas/simco/SIMCO-MCP-IMPORT.md"
        alias: "@MCP_IMPORT"
        obligatoria: false
        descripcion: "Importacion de componentes MCP"
        version: "1.0.0"

      - archivo: "directivas/simco/SIMCO-REUTILIZAR.md"
        alias: "@REUTILIZAR"
        obligatoria: false
        descripcion: "Reutilizar del catalogo"

      - archivo: "directivas/simco/SIMCO-CONTRIBUIR-CATALOGO.md"
        alias: "@CONTRIBUIR"
        obligatoria: false
        descripcion: "Contribuir al catalogo"

    # DIRECTIVAS DE DOCUMENTACION Y ESTANDARES (v3.7.0+)
    operaciones_documentacion:
      - archivo: "directivas/simco/SIMCO-DOCUMENTACION-PROYECTO.md"
        alias: "@DOC_PROYECTO"
        obligatoria: true
        descripcion: "Estandar base para documentacion de proyectos"
        version: "1.0.0"
        fecha: "2026-01-10"

      - archivo: "directivas/simco/SIMCO-NOMENCLATURA.md"
        alias: "@NOMENCLATURA"
        obligatoria: true
        descripcion: "Estandar de nomenclatura de archivos y directorios"
        version: "1.0.0"
        fecha: "2026-01-10"

      - archivo: "directivas/simco/SIMCO-ESTRUCTURA-DOCS.md"
        alias: "@ESTRUCTURA_DOCS"
        obligatoria: true
        descripcion: "Estructura interna de documentos MD"
        version: "1.0.0"
        fecha: "2026-01-10"

      - archivo: "directivas/simco/SIMCO-INVENTARIOS.md"
        alias: "@INVENTARIOS"
        obligatoria: false
        descripcion: "Estandar de inventarios YAML (SSOT)"
        version: "1.0.0"
        fecha: "2026-01-10"

      - archivo: "directivas/simco/SIMCO-TESTING.md"
        alias: "@TESTING"
        obligatoria: false
        descripcion: "Estandares minimos de testing"
        version: "1.0.0"
        fecha: "2026-01-10"

      - archivo: "directivas/simco/SIMCO-MIGRACIONES-BD.md"
        alias: "@MIGRACIONES"
        obligatoria: false
        descripcion: "Protocolo de migraciones de base de datos"
        version: "1.0.0"
        fecha: "2026-01-10"

      - archivo: "directivas/simco/SIMCO-INTEGRACIONES-EXTERNAS.md"
        alias: "@INTEGRACIONES"
        obligatoria: false
        descripcion: "Estandar para integraciones con APIs externas"
        version: "1.0.0"
        fecha: "2026-01-10"

      - archivo: "directivas/simco/SIMCO-MANTENIMIENTO-DOCUMENTACION.md"
        alias: "@MANTENIMIENTO_DOCS"
        obligatoria: true
        descripcion: "Mantenimiento, purga y deprecacion de documentacion"
        version: "1.0.0"
        fecha: "2026-01-10"

      - archivo: "directivas/simco/SIMCO-SINCRONIZACION-BD.md"
        alias: "@SYNC_BD"
        obligatoria: true
        descripcion: "Sincronizacion BD ↔ Codigo ↔ Documentacion"
        version: "1.0.0"
        fecha: "2026-01-10"

    # NUEVAS DIRECTIVAS (EPIC-003)
    operaciones_arquitectura:
      - archivo: "directivas/simco/SIMCO-ESTRUCTURA-REPOS.md"
        alias: "@ESTRUCTURA"
        obligatoria: false
        descripcion: "Arquitectura de repositorios anidados (4 niveles)"
        version: "1.0.0"
        fecha: "2026-01-03"

      - archivo: "directivas/simco/SIMCO-MODULOS-COMPARTIDOS.md"
        alias: "@MODULOS"
        obligatoria: false
        descripcion: "Uso de modulos en shared/modules/"
        version: "1.0.0"
        fecha: "2026-01-03"

      - archivo: "directivas/simco/SIMCO-NIVELES.md"
        alias: "@NIVELES"
        obligatoria: false
        descripcion: "Identificacion de nivel jerarquico"

      - archivo: "directivas/simco/SIMCO-PROPAGACION.md"
        alias: "@PROPAGACION"
        obligatoria: false
        descripcion: "Propagacion de documentacion"

    operaciones_dominio:
      - archivo: "directivas/simco/SIMCO-DDL.md"
        alias: "@OP_DDL"
        dominio: "database"
        descripcion: "Operaciones PostgreSQL"

      - archivo: "directivas/simco/SIMCO-BACKEND.md"
        alias: "@OP_BACKEND"
        dominio: "backend"
        descripcion: "Operaciones NestJS/Express"

      - archivo: "directivas/simco/SIMCO-FRONTEND.md"
        alias: "@OP_FRONTEND"
        dominio: "frontend"
        descripcion: "Operaciones React"

      - archivo: "directivas/simco/SIMCO-MOBILE.md"
        alias: "@OP_MOBILE"
        dominio: "mobile"
        descripcion: "Operaciones React Native"

      - archivo: "directivas/simco/SIMCO-ML.md"
        alias: "@OP_ML"
        dominio: "ml"
        descripcion: "Operaciones ML/AI"

      - archivo: "directivas/simco/SIMCO-DEVOPS.md"
        alias: "@OP_DEVOPS"
        dominio: "devops"
        descripcion: "Operaciones DevOps y CI/CD"

      - archivo: "directivas/simco/SIMCO-ARQUITECTURA.md"
        alias: "@OP_ARQUITECTURA"
        dominio: "arquitectura"
        descripcion: "Decisiones arquitectonicas"

      - archivo: "directivas/simco/SIMCO-SERVICE-DESCRIPTOR.md"
        alias: "@OP_SERVICE"
        dominio: "servicios"
        descripcion: "Descriptores de servicio"

    perfiles_agentes:
      ruta: "agents/perfiles/"
      cantidad: 28
      perfiles:
        - PERFIL-DATABASE.md
        - PERFIL-BACKEND.md
        - PERFIL-BACKEND-EXPRESS.md
        - PERFIL-FRONTEND.md
        - PERFIL-MOBILE-AGENT.md
        - PERFIL-ML.md
        - PERFIL-ML-SPECIALIST.md
        - PERFIL-LLM-AGENT.md
        - PERFIL-ORQUESTADOR.md
        - PERFIL-TECH-LEADER.md
        - PERFIL-ARCHITECTURE-ANALYST.md
        - PERFIL-REQUIREMENTS-ANALYST.md
        - PERFIL-CODE-REVIEWER.md
        - PERFIL-BUG-FIXER.md
        - PERFIL-TESTING.md
        - PERFIL-QA.md
        - PERFIL-DEVOPS.md
        - PERFIL-DEVENV.md
        - PERFIL-DOCUMENTATION.md
        - PERFIL-DOCUMENTATION-VALIDATOR.md
        - PERFIL-SECURITY.md
        - PERFIL-SECURITY-AUDITOR.md
        - PERFIL-DATABASE-AUDITOR.md
        - PERFIL-POLICY-AUDITOR.md
        - PERFIL-INTEGRATION-VALIDATOR.md
        - PERFIL-TRADING-STRATEGIST.md
        - PERFIL-WORKSPACE-MANAGER.md

    # NUEVOS TEMPLATES (EPIC-003)
    templates_nuevos:
      - archivo: "templates/TEMPLATE-MODULO-COMPARTIDO.md"
        alias: "@TPL_MODULO"
        descripcion: "Template para documentar modulos en shared/modules/"
        version: "1.0.0"
        fecha: "2026-01-03"

      - archivo: "templates/TEMPLATE-ESTRUCTURA-VERTICAL.md"
        alias: "@TPL_VERTICAL"
        descripcion: "Template para crear verticales en suites"
        version: "1.0.0"
        fecha: "2026-01-03"

    # NUEVOS CHECKLISTS (EPIC-003)
    checklists_nuevos:
      - archivo: "checklists/CHECKLIST-NUEVO-PROYECTO.md"
        alias: "@CHK_PROYECTO"
        descripcion: "Checklist completo para crear nuevos proyectos"
        version: "1.0.0"
        fecha: "2026-01-03"

    # NUEVOS SCRIPTS (EPIC-003)
    scripts_validacion:
      - archivo: "devtools/scripts/validation/validate-repo-structure.sh"
        descripcion: "Validar estructura de repositorios del workspace"
        version: "1.0.0"
        fecha: "2026-01-03"

  # ------------------------------------------
  # NIVEL 1: CORE (Catalogo y Modulos)
  # ------------------------------------------
  CORE:
    ruta_base: "/home/isem/workspace-v1/core"
    descripcion: "Catalogo de funcionalidades reutilizables y modulos compartidos"

    catalogo:
      - archivo: "catalog/CATALOG-INDEX.yml"
        alias: "@CATALOG"
        descripcion: "Indice de funcionalidades reutilizables"

      funcionalidades:
        - auth
        - session-management
        - rate-limiting
        - notifications
        - multi-tenancy
        - feature-flags
        - websocket
        - payments
        - template-saas
        - portales
        - audit-logs

    # MODULOS DOCUMENTADOS (EPIC-003)
    modulos:
      ruta: "modules/"
      cantidad: 6
      modulos_documentados:
        - nombre: "utils"
          archivo: "modules/utils/README.md"
          estado: "production-ready"
          funciones: 90

        - nombre: "auth"
          archivo: "modules/auth/README.md"
          estado: "desarrollo"
          descripcion: "Guards, decorators, JWT"

        - nombre: "notifications"
          archivo: "modules/notifications/README.md"
          estado: "desarrollo"
          descripcion: "Email, push, in-app"

        - nombre: "payments"
          archivo: "modules/payments/README.md"
          estado: "desarrollo"
          descripcion: "Stripe, suscripciones"

        - nombre: "billing"
          archivo: "modules/billing/README.md"
          estado: "desarrollo"
          descripcion: "Planes, invoices, cuotas"

        - nombre: "multitenant"
          archivo: "modules/multitenant/README.md"
          estado: "desarrollo"
          descripcion: "RLS, tenant context"

  # ------------------------------------------
  # NIVEL 2A: PROYECTOS STANDALONE
  # ------------------------------------------
  STANDALONE:
    patron_ruta: "/home/isem/workspace-v1/projects/{proyecto}"
    descripcion: "Proyectos autonomos sin subproyectos"

    directivas_obligatorias:
      - archivo: "orchestration/00-guidelines/CONTEXTO-PROYECTO.md"
        descripcion: "Variables de contexto del proyecto"

      - archivo: "orchestration/00-guidelines/HERENCIA-SIMCO.md"
        descripcion: "Define herencia de directivas SIMCO"

    proyectos:
      - nombre: "gamilit"
        descripcion: "Plataforma educativa gamificada"
        estado: "en_desarrollo"

      - nombre: "trading-platform"
        descripcion: "Plataforma de trading con ML"
        estado: "en_desarrollo"

      - nombre: "betting-analytics"
        descripcion: "Analytics de apuestas deportivas"
        estado: "planificacion"

      - nombre: "orbiquantia"
        descripcion: "Plataforma de inversion"
        estado: "en_desarrollo"

      - nombre: "inmobiliaria-analytics"
        descripcion: "Analytics inmobiliario"
        estado: "planificacion"

      - nombre: "michangarrito"
        descripcion: "Marketplace movil para negocios locales mexicanos"
        estado: "documentado"
        epicas: 28
        documentacion: "docs/01-epicas/MCH-*.md"

      - nombre: "template-saas"
        descripcion: "Template base SaaS multi-tenant"
        estado: "documentado"
        modulos: 12
        documentacion: "docs/01-modulos/SAAS-*.md"

      - nombre: "clinica-dental"
        descripcion: "ERP vertical para clinicas dentales"
        estado: "documentado"
        base: "erp-clinicas"
        epicas: 6
        documentacion: "docs/01-epicas/DENTAL-*.md"

      - nombre: "clinica-veterinaria"
        descripcion: "ERP vertical para clinicas veterinarias"
        estado: "documentado"
        base: "erp-clinicas"
        epicas: 6
        documentacion: "docs/01-epicas/VET-*.md"

  # ------------------------------------------
  # NIVEL 2B: SUITE (erp-suite)
  # ------------------------------------------
  SUITE:
    ruta_base: "/home/isem/workspace-v1/projects/erp-suite"
    descripcion: "Suite multi-vertical con codigo compartido"

    directivas_obligatorias:
      - archivo: "orchestration/00-guidelines/CONTEXTO-PROYECTO.md"
      - archivo: "orchestration/00-guidelines/HERENCIA-SIMCO.md"

    subniveles:

      SUITE-CORE:
        ruta: "apps/erp-core"
        descripcion: "Base de codigo compartida (60-70%)"
        hereda_de: ["SUITE"]
        directivas_adicionales:
          - archivo: "orchestration/00-guidelines/HERENCIA-SPECS-CORE.md"

      VERTICALES:
        patron_ruta: "apps/verticales/{vertical}"
        descripcion: "Verticales especializadas"
        hereda_de: ["SUITE", "SUITE-CORE"]
        directivas_adicionales:
          - archivo: "orchestration/00-guidelines/HERENCIA-ERP-CORE.md"
          - archivo: "orchestration/00-guidelines/HERENCIA-SPECS-ERP-CORE.md"

        verticales:
          - nombre: "clinicas"
            descripcion: "ERP para clinicas"
          - nombre: "construccion"
            descripcion: "ERP para construccion"
          - nombre: "mecanicas-diesel"
            descripcion: "ERP para mecanicas diesel"
          - nombre: "retail"
            descripcion: "ERP para retail"
          - nombre: "vidrio-templado"
            descripcion: "ERP para vidrio templado"

# ═══════════════════════════════════════════════════════════════════════════════
# ALIASES GLOBALES
# ═══════════════════════════════════════════════════════════════════════════════

aliases:
  # Workspace
  "@CARGA-CONTEXTO": "orchestration/directivas/DIRECTIVA-CARGA-CONTEXTO.md"
  "@INDICE": "orchestration/INDICE-DIRECTIVAS-WORKSPACE.yml"

  # Principios
  "@CAPVED": "orchestration/directivas/principios/PRINCIPIO-CAPVED.md"
  "@DOC-PRIMERO": "orchestration/directivas/principios/PRINCIPIO-DOC-PRIMERO.md"
  "@ANTI-DUP": "orchestration/directivas/principios/PRINCIPIO-ANTI-DUPLICACION.md"
  "@VALIDAR": "orchestration/directivas/principios/PRINCIPIO-VALIDACION-OBLIGATORIA.md"
  "@ECONOMIA": "orchestration/directivas/principios/PRINCIPIO-ECONOMIA-TOKENS.md"
  "@NO-ASUMIR": "orchestration/directivas/principios/PRINCIPIO-NO-ASUMIR.md"

  # Operaciones SIMCO
  "@TAREA": "orchestration/directivas/simco/SIMCO-TAREA.md"
  "@INIT": "orchestration/directivas/simco/SIMCO-INICIALIZACION.md"
  "@CREAR": "orchestration/directivas/simco/SIMCO-CREAR.md"
  "@MODIFICAR": "orchestration/directivas/simco/SIMCO-MODIFICAR.md"
  "@BUSCAR": "orchestration/directivas/simco/SIMCO-BUSCAR.md"
  "@DELEGAR": "orchestration/directivas/simco/SIMCO-DELEGACION.md"
  "@DOCUMENTAR": "orchestration/directivas/simco/SIMCO-DOCUMENTAR.md"
  "@VALIDAR-OP": "orchestration/directivas/simco/SIMCO-VALIDAR.md"

  # Arquitectura (NUEVOS)
  "@ESTRUCTURA": "orchestration/directivas/simco/SIMCO-ESTRUCTURA-REPOS.md"
  "@MODULOS": "orchestration/directivas/simco/SIMCO-MODULOS-COMPARTIDOS.md"
  "@NIVELES": "orchestration/directivas/simco/SIMCO-NIVELES.md"
  "@PROPAGACION": "orchestration/directivas/simco/SIMCO-PROPAGACION.md"

  # Dominios
  "@OP_DDL": "orchestration/directivas/simco/SIMCO-DDL.md"
  "@OP_BACKEND": "orchestration/directivas/simco/SIMCO-BACKEND.md"
  "@OP_FRONTEND": "orchestration/directivas/simco/SIMCO-FRONTEND.md"
  "@OP_MOBILE": "orchestration/directivas/simco/SIMCO-MOBILE.md"
  "@OP_ML": "orchestration/directivas/simco/SIMCO-ML.md"
  "@OP_DEVOPS": "orchestration/directivas/simco/SIMCO-DEVOPS.md"
  "@OP_ARQUITECTURA": "orchestration/directivas/simco/SIMCO-ARQUITECTURA.md"

  # Subagentes y Tokens (v2.5.0+)
  "@SUBAGENTE": "orchestration/directivas/simco/SIMCO-SUBAGENTE.md"
  "@CCA_SUBAGENTE": "orchestration/directivas/simco/SIMCO-CCA-SUBAGENTE.md"
  "@CONTROL_TOKENS": "orchestration/directivas/simco/SIMCO-CONTROL-TOKENS.md"
  "@DELEGACION_PARALELA": "orchestration/directivas/simco/SIMCO-DELEGACION-PARALELA.md"

  # Context Engineering (v2.4.0+)
  "@CONTEXT_ENGINEERING": "orchestration/directivas/simco/SIMCO-CONTEXT-ENGINEERING.md"
  "@CONTEXT_RESOLUTION": "orchestration/directivas/simco/SIMCO-CONTEXT-RESOLUTION.md"

  # Git y Repositorios (v2.6.0+)
  "@GIT": "orchestration/directivas/simco/SIMCO-GIT.md"
  "@GIT_REMOTES": "orchestration/directivas/simco/SIMCO-GIT-REMOTES.md"
  "@ESCALAMIENTO": "orchestration/directivas/simco/SIMCO-ESCALAMIENTO.md"

  # Toma de Decisiones
  "@ALINEACION": "orchestration/directivas/simco/SIMCO-ALINEACION.md"
  "@DECISION_MATRIZ": "orchestration/directivas/simco/SIMCO-DECISION-MATRIZ.md"
  "@ASIGNACION_PERFILES": "orchestration/directivas/simco/SIMCO-ASIGNACION-PERFILES.md"

  # Adicionales
  "@CAPVED_PLUS": "orchestration/directivas/simco/SIMCO-CAPVED-PLUS.md"
  "@ERROR_RECURRENTE": "orchestration/directivas/simco/SIMCO-ERROR-RECURRENTE.md"
  "@SCRUM": "orchestration/directivas/simco/SIMCO-SCRUM-INTEGRATION.md"
  "@QUICK_REF": "orchestration/directivas/simco/SIMCO-QUICK-REFERENCE.md"
  "@RAG": "orchestration/directivas/simco/SIMCO-RAG.md"
  "@MCP": "orchestration/directivas/simco/SIMCO-MCP.md"
  "@MCP_IMPORT": "orchestration/directivas/simco/SIMCO-MCP-IMPORT.md"
  "@CONTRIBUIR": "orchestration/directivas/simco/SIMCO-CONTRIBUIR-CATALOGO.md"

  # Catalogo y Modulos
  "@CATALOG": "shared/catalog/CATALOG-INDEX.yml"
  "@REUTILIZAR": "orchestration/directivas/simco/SIMCO-REUTILIZAR.md"
  "@MODULES": "shared/modules/"

  # Templates (NUEVOS)
  "@TPL_MODULO": "orchestration/templates/TEMPLATE-MODULO-COMPARTIDO.md"
  "@TPL_VERTICAL": "orchestration/templates/TEMPLATE-ESTRUCTURA-VERTICAL.md"
  "@TPL_CONTEXTO": "orchestration/templates/TEMPLATE-CONTEXTO-PROYECTO.md"
  "@TPL_DELEGACION": "orchestration/templates/TEMPLATE-DELEGACION-SUBAGENTE.md"
  "@TPL_CAPVED": "orchestration/templates/TEMPLATE-TAREA-CAPVED.md"

  # Checklists (NUEVOS)
  "@CHK_PROYECTO": "orchestration/checklists/CHECKLIST-NUEVO-PROYECTO.md"
  "@CHK_DOCUMENTACION": "orchestration/checklists/CHECKLIST-DOCUMENTACION-PROYECTO.md"
  "@CHK_INVENTARIOS": "orchestration/checklists/CHECKLIST-INVENTARIOS.md"
  "@CHK_NOMENCLATURA": "orchestration/checklists/CHECKLIST-NOMENCLATURA.md"

  # Documentacion y Estandares (v3.7.0+)
  "@DOC_PROYECTO": "orchestration/directivas/simco/SIMCO-DOCUMENTACION-PROYECTO.md"
  "@NOMENCLATURA": "orchestration/directivas/simco/SIMCO-NOMENCLATURA.md"
  "@ESTRUCTURA_DOCS": "orchestration/directivas/simco/SIMCO-ESTRUCTURA-DOCS.md"
  "@INVENTARIOS": "orchestration/directivas/simco/SIMCO-INVENTARIOS.md"
  "@TESTING": "orchestration/directivas/simco/SIMCO-TESTING.md"
  "@MIGRACIONES": "orchestration/directivas/simco/SIMCO-MIGRACIONES-BD.md"
  "@INTEGRACIONES": "orchestration/directivas/simco/SIMCO-INTEGRACIONES-EXTERNAS.md"
  "@MANTENIMIENTO_DOCS": "orchestration/directivas/simco/SIMCO-MANTENIMIENTO-DOCUMENTACION.md"
  "@SYNC_BD": "orchestration/directivas/simco/SIMCO-SINCRONIZACION-BD.md"

  # Checklists de Mantenimiento (v3.8.0+)
  "@CHK_MANTENIMIENTO": "orchestration/checklists/CHECKLIST-MANTENIMIENTO-DOCS.md"
  "@CHK_SYNC_BD": "orchestration/checklists/CHECKLIST-SINCRONIZACION-BD.md"

  # Template de Deprecacion (v3.8.0+)
  "@TPL_DEPRECACION": "orchestration/templates/TEMPLATE-DEPRECACION.md"

  # Perfil de Mantenimiento (v3.8.0+)
  "@PERFIL_DOC_MAINT": "orchestration/agents/perfiles/PERFIL-DOCUMENTATION-MAINTAINER.md"

  # Templates de Documentacion (v3.7.0+)
  "@TPL_INVENTARIO": "orchestration/templates/TEMPLATE-INVENTARIO-PROYECTO.md"
  "@TPL_INTEGRACION": "orchestration/templates/TEMPLATE-INTEGRACION-EXTERNA.md"
  "@TPL_MODULO_ESTANDAR": "orchestration/templates/TEMPLATE-MODULO-ESTANDAR.md"

  # Proyectos
  "@GAMILIT": "projects/gamilit"
  "@ERP": "projects/erp-suite"
  "@TRADING": "projects/trading-platform"
  "@BETTING": "projects/betting-analytics"

# ═══════════════════════════════════════════════════════════════════════════════
# METADATA
# ═══════════════════════════════════════════════════════════════════════════════

metadata:
  total_niveles: 7
  total_proyectos_standalone: 5
  total_verticales: 5
  total_directivas_simco: 51  # Actualizado: +2 directivas de mantenimiento (v3.8.0)
  total_perfiles_agentes: 29  # Actualizado: +1 perfil de mantenimiento (v3.8.0)
  total_principios: 6
  total_templates: 28  # Actualizado: +1 template deprecacion (v3.8.0)
  total_checklists: 10  # Actualizado: +2 checklists mantenimiento (v3.8.0)
  total_modulos_documentados: 6
  sistema_simco_version: "3.7"
  ultima_actualizacion: "2026-01-10"
  mantenido_por: "Documentation-Architect"
  epic_origen: "ESTANDARIZACION-DOC-2026-01-10"

# ═══════════════════════════════════════════════════════════════════════════════
# CHANGELOG
# ═══════════════════════════════════════════════════════════════════════════════

changelog:
  v3_8_0:
    fecha: "2026-01-10"
    epic: "MANTENIMIENTO-DOC"
    cambios:
      - "Agregadas 2 directivas de mantenimiento de documentacion"
      - "SIMCO-MANTENIMIENTO-DOCUMENTACION.md - Ciclo de mantenimiento, purga y deprecacion"
      - "SIMCO-SINCRONIZACION-BD.md - Sincronizacion BD ↔ Codigo ↔ Docs"
      - "Agregados 2 checklists de mantenimiento"
      - "CHECKLIST-MANTENIMIENTO-DOCS.md - 80 items de validacion"
      - "CHECKLIST-SINCRONIZACION-BD.md - 70 items para sincronizacion BD"
      - "Agregado 1 template de deprecacion"
      - "TEMPLATE-DEPRECACION.md - Formato para deprecar documentos"
      - "Agregado 1 perfil de agente especializado"
      - "PERFIL-DOCUMENTATION-MAINTAINER.md - Agente de mantenimiento de docs"
      - "Actualizado conteo: 51 directivas, 28 templates, 10 checklists, 29 perfiles"
      - "6+ aliases nuevos (@MANTENIMIENTO_DOCS, @SYNC_BD, @CHK_MANTENIMIENTO, etc.)"

  v3_7_0:
    fecha: "2026-01-10"
    epic: "ESTANDARIZACION-DOC"
    cambios:
      - "Agregadas 7 directivas de documentacion y estandares"
      - "SIMCO-DOCUMENTACION-PROYECTO.md - Estandar base para proyectos"
      - "SIMCO-NOMENCLATURA.md - Patrones de nomenclatura"
      - "SIMCO-ESTRUCTURA-DOCS.md - Estructura interna de documentos"
      - "SIMCO-INVENTARIOS.md - Estandar de inventarios YAML"
      - "SIMCO-TESTING.md - Estandares minimos de testing"
      - "SIMCO-MIGRACIONES-BD.md - Protocolo de migraciones"
      - "SIMCO-INTEGRACIONES-EXTERNAS.md - APIs externas"
      - "Agregados 3 templates nuevos"
      - "TEMPLATE-INVENTARIO-PROYECTO.md"
      - "TEMPLATE-INTEGRACION-EXTERNA.md"
      - "TEMPLATE-MODULO-ESTANDAR.md"
      - "Agregados 3 checklists nuevos"
      - "CHECKLIST-DOCUMENTACION-PROYECTO.md"
      - "CHECKLIST-INVENTARIOS.md"
      - "CHECKLIST-NOMENCLATURA.md"
      - "Creado _MAP.md para directorio checklists"
      - "Actualizado conteo: 49 directivas, 27 templates, 8 checklists"
      - "15+ aliases nuevos"

  v3_6_0:
    fecha: "2026-01-10"
    epic: "AUDITORIA-DOC"
    cambios:
      - "Registradas 13 directivas faltantes (subagentes, context, git, decisiones)"
      - "Agregados 25+ aliases nuevos"
      - "Actualizado conteo total de directivas: 29 -> 42"
      - "Nueva seccion operaciones_subagentes"
      - "Nueva seccion operaciones_context"
      - "Nueva seccion operaciones_git"
      - "Nueva seccion operaciones_decisiones"
      - "Nueva seccion operaciones_adicionales"

  v3_5_0:
    fecha: "2026-01-03"
    epic: "EPIC-003"
    cambios:
      - "Agregado SIMCO-ESTRUCTURA-REPOS.md (arquitectura 4 niveles)"
      - "Agregado SIMCO-MODULOS-COMPARTIDOS.md (uso de shared/modules)"
      - "Agregado TEMPLATE-MODULO-COMPARTIDO.md"
      - "Agregado TEMPLATE-ESTRUCTURA-VERTICAL.md"
      - "Agregado CHECKLIST-NUEVO-PROYECTO.md"
      - "Agregado validate-repo-structure.sh"
      - "Documentados 6 modulos en shared/modules/"
      - "Actualizado _INDEX.md a v2.4.0"
      - "Actualizado ALIASES.yml a v2.4.0"
      - "30+ aliases nuevos"

  v3_4_0:
    fecha: "2025-12-26"
    cambios:
      - "Herencia escalonada implementada"
      - "Sistema SIMCO consolidado"