# ═══════════════════════════════════════════════════════════════════════════════ # SISTEMA DE ALIAS GLOBAL - SIMCO + CAPVED # ═══════════════════════════════════════════════════════════════════════════════ # # Versión: 2.0.0 # Fecha: 2025-12-08 # Propósito: Centralizar referencias y rutas para navegación consistente # # USO: # Los agentes pueden usar @ALIAS en sus prompts y documentación. # Los alias se resuelven según el contexto del proyecto. # # RESOLUCIÓN: # 1. Alias globales → Rutas absolutas desde workspace # 2. Alias de proyecto → Se resuelven con variables de CONTEXTO-PROYECTO.md # 3. Alias de operaciones → Apuntan a directivas SIMCO # # ═══════════════════════════════════════════════════════════════════════════════ version: "2.2.0" fecha_actualizacion: "2025-12-08" # ───────────────────────────────────────────────────────────────────────────────── # ALIAS GLOBALES (rutas absolutas - aplican a todos los proyectos) # ───────────────────────────────────────────────────────────────────────────────── global: # ═══════════════════════════════════════════════════════════════════ # CATÁLOGO DE FUNCIONALIDADES REUTILIZABLES (CONSULTAR PRIMERO) # ═══════════════════════════════════════════════════════════════════ "@CATALOG": "core/catalog/" "@CATALOG_INDEX": "core/catalog/CATALOG-INDEX.yml" "@CATALOG_AUTH": "core/catalog/auth/" "@CATALOG_SESSION": "core/catalog/session-management/" "@CATALOG_RATELIMIT": "core/catalog/rate-limiting/" "@CATALOG_NOTIFY": "core/catalog/notifications/" "@CATALOG_TENANT": "core/catalog/multi-tenancy/" "@CATALOG_FLAGS": "core/catalog/feature-flags/" "@CATALOG_WS": "core/catalog/websocket/" "@CATALOG_PAYMENTS": "core/catalog/payments/" # ═══════════════════════════════════════════════════════════════════ # CAPVED - CICLO DE VIDA DE TAREAS (🆕 v2.0) # ═══════════════════════════════════════════════════════════════════ "@CAPVED": "core/orchestration/directivas/principios/PRINCIPIO-CAPVED.md" "@TPL_CAPVED": "core/orchestration/templates/TEMPLATE-TAREA-CAPVED.md" "@TOKENS": "core/orchestration/directivas/principios/PRINCIPIO-ECONOMIA-TOKENS.md" "@QUICK_REF": "core/orchestration/directivas/simco/SIMCO-QUICK-REFERENCE.md" # ═══════════════════════════════════════════════════════════════════ # DIRECTIVAS Y PRINCIPIOS # ═══════════════════════════════════════════════════════════════════ "@SIMCO": "core/orchestration/directivas/simco/" "@PRINCIPIOS": "core/orchestration/directivas/principios/" "@DIRECTIVAS": "core/orchestration/directivas/" "@ALIASES": "core/orchestration/referencias/ALIASES.yml" # ═══════════════════════════════════════════════════════════════════ # PERFILES Y PROMPTS DE AGENTES # ═══════════════════════════════════════════════════════════════════ "@PERFILES": "core/orchestration/agents/perfiles/" "@PROMPTS": "core/orchestration/agents/" "@PROMPTS_LEGACY": "core/orchestration/agents/legacy/" # ═══════════════════════════════════════════════════════════════════ # TEMPLATES # ═══════════════════════════════════════════════════════════════════ "@TEMPLATES": "core/orchestration/templates/" "@TPL_ANALISIS": "core/orchestration/templates/TEMPLATE-ANALISIS.md" "@TPL_PLAN": "core/orchestration/templates/TEMPLATE-PLAN.md" "@TPL_VALIDACION": "core/orchestration/templates/TEMPLATE-VALIDACION.md" "@TPL_EPICA": "core/orchestration/templates/TEMPLATE-EPICA.md" "@TPL_HISTORIA": "core/orchestration/templates/TEMPLATE-HISTORIA-USUARIO.md" "@TPL_TAREA": "core/orchestration/templates/TEMPLATE-TAREA-TECNICA.md" # ═══════════════════════════════════════════════════════════════════ # CHECKLISTS # ═══════════════════════════════════════════════════════════════════ "@CHECKLISTS": "core/orchestration/checklists/" "@CHK_API": "core/orchestration/checklists/CHECKLIST-CODE-REVIEW-API.md" "@CHK_REFACTOR": "core/orchestration/checklists/CHECKLIST-REFACTORIZACION.md" "@CHK_PROPAGACION": "core/orchestration/checklists/CHECKLIST-PROPAGACION.md" # ═══════════════════════════════════════════════════════════════════ # PERFILES DE AGENTES ESPECÍFICOS # ═══════════════════════════════════════════════════════════════════ # Técnicos "@PERFIL_DATABASE": "core/orchestration/agents/perfiles/PERFIL-DATABASE.md" "@PERFIL_BACKEND": "core/orchestration/agents/perfiles/PERFIL-BACKEND.md" "@PERFIL_BACKEND_EXPRESS": "core/orchestration/agents/perfiles/PERFIL-BACKEND-EXPRESS.md" "@PERFIL_FRONTEND": "core/orchestration/agents/perfiles/PERFIL-FRONTEND.md" "@PERFIL_MOBILE": "core/orchestration/agents/perfiles/PERFIL-MOBILE-AGENT.md" "@PERFIL_ML": "core/orchestration/agents/perfiles/PERFIL-ML-SPECIALIST.md" # Coordinación "@PERFIL_ORQUESTADOR": "core/orchestration/agents/perfiles/PERFIL-ORQUESTADOR.md" "@PERFIL_ARCHITECT": "core/orchestration/agents/perfiles/PERFIL-ARCHITECTURE-ANALYST.md" "@PERFIL_ANALYST": "core/orchestration/agents/perfiles/PERFIL-REQUIREMENTS-ANALYST.md" # Calidad "@PERFIL_REVIEWER": "core/orchestration/agents/perfiles/PERFIL-CODE-REVIEWER.md" "@PERFIL_BUG_FIXER": "core/orchestration/agents/perfiles/PERFIL-BUG-FIXER.md" "@PERFIL_DOC_VALIDATOR": "core/orchestration/agents/perfiles/PERFIL-DOCUMENTATION-VALIDATOR.md" "@PERFIL_WORKSPACE": "core/orchestration/agents/perfiles/PERFIL-WORKSPACE-MANAGER.md" # ═══════════════════════════════════════════════════════════════════ # PATRONES DE CÓDIGO (CONSULTAR ANTES DE IMPLEMENTAR) # ═══════════════════════════════════════════════════════════════════ "@PATRONES": "core/orchestration/patrones/" "@MAPEO_TIPOS": "core/orchestration/patrones/MAPEO-TIPOS-DDL-TYPESCRIPT.md" "@PATRON_VALIDACION": "core/orchestration/patrones/PATRON-VALIDACION.md" "@PATRON_EXCEPTIONS": "core/orchestration/patrones/PATRON-EXCEPTION-HANDLING.md" "@PATRON_TESTING": "core/orchestration/patrones/PATRON-TESTING.md" "@PATRON_LOGGING": "core/orchestration/patrones/PATRON-LOGGING.md" "@PATRON_CONFIG": "core/orchestration/patrones/PATRON-CONFIGURACION.md" "@PATRON_SEGURIDAD": "core/orchestration/patrones/PATRON-SEGURIDAD.md" "@PATRON_PERFORMANCE": "core/orchestration/patrones/PATRON-PERFORMANCE.md" "@PATRON_TRANSACCIONES": "core/orchestration/patrones/PATRON-TRANSACCIONES.md" "@ANTIPATRONES": "core/orchestration/patrones/ANTIPATRONES.md" "@NOMENCLATURA": "core/orchestration/patrones/NOMENCLATURA-UNIFICADA.md" # ═══════════════════════════════════════════════════════════════════ # IMPACTOS DE CAMBIOS (CONSULTAR ANTES DE MODIFICAR) # ═══════════════════════════════════════════════════════════════════ "@IMPACTOS": "core/orchestration/impactos/" "@IMPACTO_DDL": "core/orchestration/impactos/IMPACTO-CAMBIOS-DDL.md" "@IMPACTO_BACKEND": "core/orchestration/impactos/IMPACTO-CAMBIOS-BACKEND.md" "@IMPACTO_ENTITY": "core/orchestration/impactos/IMPACTO-CAMBIOS-ENTITY.md" "@IMPACTO_API": "core/orchestration/impactos/IMPACTO-CAMBIOS-API.md" "@MATRIZ_DEPENDENCIAS": "core/orchestration/impactos/MATRIZ-DEPENDENCIAS.md" # ═══════════════════════════════════════════════════════════════════ # PROCESOS DE TRABAJO # ═══════════════════════════════════════════════════════════════════ "@PROCESOS": "core/orchestration/procesos/" "@ORDEN_IMPLEMENTACION": "core/orchestration/procesos/ORDEN-IMPLEMENTACION.md" # ───────────────────────────────────────────────────────────────────────────────── # ALIAS DE OPERACIONES (atajos directos a directivas SIMCO) # ───────────────────────────────────────────────────────────────────────────────── operaciones: # ═══════════════════════════════════════════════════════════════════ # CICLO DE VIDA Y BOOTSTRAP # ═══════════════════════════════════════════════════════════════════ "@TAREA": "core/orchestration/directivas/simco/SIMCO-TAREA.md" "@INICIALIZACION": "core/orchestration/directivas/simco/SIMCO-INICIALIZACION.md" # ═══════════════════════════════════════════════════════════════════ # OPERACIONES UNIVERSALES (TODO agente debe conocerlas) # ═══════════════════════════════════════════════════════════════════ "@REUTILIZAR": "core/orchestration/directivas/simco/SIMCO-REUTILIZAR.md" "@CONTRIBUIR_CATALOGO": "core/orchestration/directivas/simco/SIMCO-CONTRIBUIR-CATALOGO.md" "@CREAR": "core/orchestration/directivas/simco/SIMCO-CREAR.md" "@MODIFICAR": "core/orchestration/directivas/simco/SIMCO-MODIFICAR.md" "@VALIDAR": "core/orchestration/directivas/simco/SIMCO-VALIDAR.md" "@DOCUMENTAR": "core/orchestration/directivas/simco/SIMCO-DOCUMENTAR.md" "@BUSCAR": "core/orchestration/directivas/simco/SIMCO-BUSCAR.md" "@DELEGAR": "core/orchestration/directivas/simco/SIMCO-DELEGACION.md" # ═══════════════════════════════════════════════════════════════════ # OPERACIONES ESPECIALIZADAS (según dominio) # ═══════════════════════════════════════════════════════════════════ "@OP_DDL": "core/orchestration/directivas/simco/SIMCO-DDL.md" "@OP_BACKEND": "core/orchestration/directivas/simco/SIMCO-BACKEND.md" "@OP_FRONTEND": "core/orchestration/directivas/simco/SIMCO-FRONTEND.md" "@OP_MOBILE": "core/orchestration/directivas/simco/SIMCO-MOBILE.md" "@OP_ML": "core/orchestration/directivas/simco/SIMCO-ML.md" # ═══════════════════════════════════════════════════════════════════ # NIVELES JERÁRQUICOS Y PROPAGACIÓN # ═══════════════════════════════════════════════════════════════════ "@NIVELES": "core/orchestration/directivas/simco/SIMCO-NIVELES.md" "@PROPAGACION": "core/orchestration/directivas/simco/SIMCO-PROPAGACION.md" # ═══════════════════════════════════════════════════════════════════ # TOMA DE DECISIONES Y ALINEACIÓN # ═══════════════════════════════════════════════════════════════════ "@ALINEACION": "core/orchestration/directivas/simco/SIMCO-ALINEACION.md" "@DECISION_MATRIZ": "core/orchestration/directivas/simco/SIMCO-DECISION-MATRIZ.md" # ───────────────────────────────────────────────────────────────────────────────── # ALIAS DE NIVELES JERÁRQUICOS (templates de contexto por nivel) # ───────────────────────────────────────────────────────────────────────────────── niveles: # ═══════════════════════════════════════════════════════════════════ # TEMPLATES DE CONTEXTO POR NIVEL # ═══════════════════════════════════════════════════════════════════ "@CTX_STANDALONE": "core/orchestration/templates/CONTEXTO-NIVEL-STANDALONE.md" "@CTX_SUITE": "core/orchestration/templates/CONTEXTO-NIVEL-SUITE.md" "@CTX_SUITE_CORE": "core/orchestration/templates/CONTEXTO-NIVEL-SUITE-CORE.md" "@CTX_VERTICAL": "core/orchestration/templates/CONTEXTO-NIVEL-VERTICAL.md" # ═══════════════════════════════════════════════════════════════════ # NIVEL 0: WORKSPACE ROOT # ═══════════════════════════════════════════════════════════════════ "@WORKSPACE": "~/" "@WORKSPACE_ORCH": "orchestration/" "@WORKSPACE_STATUS": "orchestration/WORKSPACE-STATUS.md" "@WORKSPACE_INDEX": "orchestration/WORKSPACE-INDEX.md" # ═══════════════════════════════════════════════════════════════════ # NIVEL 1: CORE # ═══════════════════════════════════════════════════════════════════ "@CORE": "core/" "@CORE_ORCH": "core/orchestration/" "@CORE_CATALOG": "core/catalog/" "@CORE_MODULES": "core/modules/" # ═══════════════════════════════════════════════════════════════════ # NIVEL 2: PROYECTOS (alias dinámicos) # ═══════════════════════════════════════════════════════════════════ # Para proyectos standalone (2A): "@PROJECT_ROOT": "projects/{PROJECT}/" "@PROJECT_ORCH": "projects/{PROJECT}/orchestration/" "@PROJECT_INV": "projects/{PROJECT}/orchestration/inventarios/" "@PROJECT_TRAZA": "projects/{PROJECT}/orchestration/trazas/" # Para suites multi-vertical (2B): "@SUITE_ROOT": "projects/{SUITE}/" "@SUITE_ORCH": "projects/{SUITE}/orchestration/" "@SUITE_CORE": "projects/{SUITE}/core/" "@SUITE_VERTICALS": "projects/{SUITE}/verticals/" "@SUITE_INV": "projects/{SUITE}/orchestration/inventarios/" # Para verticales (2B.2): "@VERTICAL_ROOT": "projects/{SUITE}/verticals/{VERTICAL}/" "@VERTICAL_ORCH": "projects/{SUITE}/verticals/{VERTICAL}/orchestration/" "@VERTICAL_INV": "projects/{SUITE}/verticals/{VERTICAL}/orchestration/inventarios/" "@VERTICAL_TRAZA": "projects/{SUITE}/verticals/{VERTICAL}/orchestration/trazas/" # ═══════════════════════════════════════════════════════════════════ # PROPAGACIÓN (archivos específicos) # ═══════════════════════════════════════════════════════════════════ "@PROP_STATUS": "{ORCHESTRATION_PATH}/STATUS.yml" "@PROP_REFERENCIAS": "{ORCHESTRATION_PATH}/inventarios/REFERENCIAS.yml" "@PROP_TRAZA": "{ORCHESTRATION_PATH}/trazas/TRAZA-PROPAGACION.md" # ───────────────────────────────────────────────────────────────────────────────── # ALIAS DE PROYECTO (variables - se resuelven con CONTEXTO-PROYECTO.md) # ───────────────────────────────────────────────────────────────────────────────── proyecto: # ═══════════════════════════════════════════════════════════════════ # CÓDIGO FUENTE # ═══════════════════════════════════════════════════════════════════ "@DDL": "{DB_DDL_PATH}/schemas/" "@DDL_ROOT": "{DB_DDL_PATH}/" "@SEEDS": "{DB_SEEDS_PATH}/" "@SEEDS_DEV": "{DB_SEEDS_PATH}/dev/" "@SEEDS_PROD": "{DB_SEEDS_PATH}/prod/" "@DB_SCRIPTS": "{DB_SCRIPTS_PATH}/" "@BACKEND": "{BACKEND_SRC}/modules/" "@BACKEND_ROOT": "{BACKEND_ROOT}/" "@BACKEND_SHARED": "{BACKEND_SRC}/shared/" "@BACKEND_CONFIG": "{BACKEND_SRC}/shared/config/" "@BACKEND_TESTS": "{BACKEND_TESTS}/" "@FRONTEND": "{FRONTEND_SRC}/apps/" "@FRONTEND_ROOT": "{FRONTEND_ROOT}/" "@FRONTEND_SHARED": "{FRONTEND_SRC}/shared/" "@FRONTEND_COMPONENTS": "{FRONTEND_SRC}/shared/components/" "@MOBILE": "{MOBILE_SRC}/" "@MOBILE_ROOT": "{MOBILE_ROOT}/" "@MOBILE_SCREENS": "{MOBILE_SRC}/screens/" "@MOBILE_COMPONENTS": "{MOBILE_SRC}/components/" "@ML_SERVICE": "{ML_SRC}/" "@ML_MODELS": "{ML_SRC}/models/" "@ML_NOTEBOOKS": "{PROJECT_ROOT}/notebooks/" "@ML_DATA": "{PROJECT_ROOT}/data/" # ═══════════════════════════════════════════════════════════════════ # ORCHESTRATION DEL PROYECTO # ═══════════════════════════════════════════════════════════════════ "@ORCH": "orchestration/" "@CONTEXTO": "orchestration/00-guidelines/CONTEXTO-PROYECTO.md" "@PROXIMA": "orchestration/PROXIMA-ACCION.md" # Inventarios "@INVENTORY": "orchestration/inventarios/MASTER_INVENTORY.yml" "@INV_DB": "orchestration/inventarios/DATABASE_INVENTORY.yml" "@INV_BE": "orchestration/inventarios/BACKEND_INVENTORY.yml" "@INV_FE": "orchestration/inventarios/FRONTEND_INVENTORY.yml" # Trazas "@TRAZA_DB": "orchestration/trazas/TRAZA-TAREAS-DATABASE.md" "@TRAZA_BE": "orchestration/trazas/TRAZA-TAREAS-BACKEND.md" "@TRAZA_FE": "orchestration/trazas/TRAZA-TAREAS-FRONTEND.md" "@TRAZA_MOBILE": "orchestration/trazas/TRAZA-TAREAS-MOBILE.md" "@TRAZA_ML": "orchestration/trazas/TRAZA-TAREAS-ML.md" # Inventarios adicionales "@INV_MOBILE": "orchestration/inventarios/MOBILE_INVENTORY.yml" "@INV_ML": "orchestration/inventarios/ML_INVENTORY.yml" # Estados "@ESTADO_AGENTES": "orchestration/estados/ESTADO-AGENTES.json" # ═══════════════════════════════════════════════════════════════════ # DOCUMENTACIÓN DEL PROYECTO # ═══════════════════════════════════════════════════════════════════ "@DOCS": "docs/" "@DOCS_VISION": "docs/00-vision-general/" "@DOCS_FASE1": "docs/01-fase-alcance-inicial/" "@DOCS_FASE2": "docs/02-fase-robustecimiento/" "@DOCS_FASE3": "docs/03-fase-extensiones/" "@DOCS_TRANSVERSAL": "docs/90-transversal/" "@GUIAS": "docs/95-guias-desarrollo/" "@GUIAS_BE": "docs/95-guias-desarrollo/backend/" "@GUIAS_FE": "docs/95-guias-desarrollo/frontend/" "@ADR": "docs/97-adr/" "@STANDARDS": "docs/98-standards/" # ───────────────────────────────────────────────────────────────────────────────── # PROYECTOS CONOCIDOS (para navegación cross-project) # ───────────────────────────────────────────────────────────────────────────────── proyectos_conocidos: gamilit: root: "~/workspace/projects/gamilit" tipo: "standalone" descripcion: "Sistema de Gamificación Educativa" stack: database: "PostgreSQL" backend: "NestJS" frontend: "React" variables: DB_NAME: "gamilit_platform" DB_DDL_PATH: "apps/database/ddl" DB_SCRIPTS_PATH: "apps/database" DB_SEEDS_PATH: "apps/database/seeds" RECREATE_CMD: "drop-and-recreate-database.sh" BACKEND_ROOT: "apps/backend" BACKEND_SRC: "apps/backend/src" BACKEND_TESTS: "apps/backend/tests" FRONTEND_ROOT: "apps/frontend/web" FRONTEND_SRC: "apps/frontend/web/src" AUTH_SCHEMA: "auth_management" erp-suite: root: "~/workspace/projects/erp-suite" tipo: "multi-vertical" descripcion: "Suite ERP con verticales de negocio" verticales: erp-core: path: "apps/erp-core" descripcion: "Core compartido" construccion: path: "apps/verticales/construccion" descripcion: "Vertical Construcción" vidrio-templado: path: "apps/verticales/vidrio-templado" descripcion: "Vertical Vidrio Templado" mecanicas-diesel: path: "apps/verticales/mecanicas-diesel" descripcion: "Vertical Mecánicas Diesel" orbiquantia: root: "~/workspace/projects/orbiquantia" tipo: "standalone" descripcion: "Plataforma de Trading Algorítmico" stack: database: "PostgreSQL + TimescaleDB" backend: "FastAPI + NestJS" frontend: "React" ml: "PyTorch + XGBoost" # ───────────────────────────────────────────────────────────────────────────────── # COMANDOS FRECUENTES (para referencia rápida) # ───────────────────────────────────────────────────────────────────────────────── comandos: # Database recrear_db: "cd {DB_SCRIPTS_PATH} && ./{RECREATE_CMD}" crear_db: "cd {DB_SCRIPTS_PATH} && ./create-database.sh" listar_schemas: "psql -d {DB_NAME} -c '\\dn'" listar_tablas: "psql -d {DB_NAME} -c '\\dt {schema}.*'" # Backend build_be: "cd {BACKEND_ROOT} && npm run build" lint_be: "cd {BACKEND_ROOT} && npm run lint" test_be: "cd {BACKEND_ROOT} && npm run test" start_be: "cd {BACKEND_ROOT} && npm run start:dev" # Frontend build_fe: "cd {FRONTEND_ROOT} && npm run build" lint_fe: "cd {FRONTEND_ROOT} && npm run lint" start_fe: "cd {FRONTEND_ROOT} && npm run dev" # Anti-duplicación buscar_en_inventario: "grep -i '{objeto}' orchestration/inventarios/MASTER_INVENTORY.yml" buscar_en_codigo: "grep -rn '{patron}' apps/" buscar_archivos: "find apps/ -name '*{nombre}*'" # ───────────────────────────────────────────────────────────────────────────────── # INSTRUCCIONES DE USO # ───────────────────────────────────────────────────────────────────────────────── uso: descripcion: | Los alias se usan en prompts y documentación para: 1. Navegar rápidamente a archivos/directivas 2. Mantener consistencia entre proyectos 3. Facilitar cross-project references resolucion: | Para resolver un alias: 1. Si empieza con @ → buscar en este archivo 2. Si contiene {VARIABLE} → resolver con CONTEXTO-PROYECTO.md 3. Si es ruta relativa → desde raíz del proyecto actual ejemplos: - alias: "@CREAR" resuelve_a: "core/orchestration/directivas/simco/SIMCO-CREAR.md" uso: "Leer antes de crear cualquier archivo" - alias: "@INVENTORY" resuelve_a: "orchestration/inventarios/MASTER_INVENTORY.yml" uso: "Verificar duplicados antes de crear objetos" - alias: "@DDL" resuelve_a: "{DB_DDL_PATH}/schemas/" nota: "Requiere resolver {DB_DDL_PATH} del proyecto" # ═══════════════════════════════════════════════════════════════════════════════ # FIN DEL ARCHIVO DE ALIASES # ═══════════════════════════════════════════════════════════════════════════════