# ═══════════════════════════════════════════════════════════════════════════════ # 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.5.0" fecha_actualizacion: "2026-01-03" descripcion: "Indice maestro - BASE PRINCIPAL en raiz del workspace" sistema: "SIMCO v3.5 + CAPVED + Economia de Tokens + Herencia Escalonada + Modulos" # ═══════════════════════════════════════════════════════════════════════════════ # 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" # 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 core/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 core/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" # ------------------------------------------ # 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" # Catalogo y Modulos "@CATALOG": "core/catalog/CATALOG-INDEX.yml" "@REUTILIZAR": "orchestration/directivas/simco/SIMCO-REUTILIZAR.md" "@MODULES": "core/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 (NUEVO) "@CHK_PROYECTO": "orchestration/checklists/CHECKLIST-NUEVO-PROYECTO.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: 29 # +2 nuevas total_perfiles_agentes: 28 total_principios: 6 total_templates: 24 # +2 nuevos total_modulos_documentados: 6 # NUEVO sistema_simco_version: "3.5" ultima_actualizacion: "2026-01-03" mantenido_por: "Requirements-Analyst" epic_origen: "EPIC-003" # ═══════════════════════════════════════════════════════════════════════════════ # CHANGELOG # ═══════════════════════════════════════════════════════════════════════════════ changelog: 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 core/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 core/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"