workspace-v1/orchestration/referencias/TRAZABILIDAD-REFERENCIAS.yml
rckrdmrd ff3038f183 feat(orchestration): Add subagent token management system
Sistema completo de gestión de tokens para subagentes NEXUS v4.0:

Nuevas directivas SIMCO:
- SIMCO-SUBAGENTE.md: Protocolo para agentes en modo subagente
- SIMCO-CCA-SUBAGENTE.md: CCA ligero para subagentes (~1,500 tokens)
- SIMCO-CONTROL-TOKENS.md: Gestión de límites de tokens
- SIMCO-DELEGACION-PARALELA.md: Delegación paralela

Perfiles compact (~250 tokens cada uno):
- PERFIL-BACKEND-COMPACT.md
- PERFIL-FRONTEND-COMPACT.md
- PERFIL-DATABASE-COMPACT.md
- PERFIL-DEVOPS-COMPACT.md
- PERFIL-ML-COMPACT.md
- PERFIL-GENERIC-SUBAGENT.md

Templates de delegación escalonados:
- TEMPLATE-DELEGACION-MINIMA.md (~250 tokens)
- TEMPLATE-DELEGACION-ESTANDAR.md (~600 tokens)
- TEMPLATE-DELEGACION-COMPLETA.md (~1,800 tokens)

Nuevos perfiles especializados:
- PERFIL-MCP-ARCHITECT.md
- PERFIL-MCP-DEVELOPER.md
- PERFIL-RAG-ENGINEER.md
- PERFIL-CICD-SPECIALIST.md
- PERFIL-PRODUCTION-MANAGER.md
- PERFIL-MONITORING-AGENT.md
- PERFIL-SECRETS-MANAGER.md
- PERFIL-PROPAGATION-TRACKER.md

Checklists y documentación:
- CHECKLIST-PRE-DELEGACION.md
- Análisis y planes de implementación

Métricas de mejora:
- ~59% reducción de tokens por delegación
- Perfiles compact: 69% más ligeros
- CCA subagente: 85% más ligero

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 04:43:01 -06:00

367 lines
13 KiB
YAML

# TRAZABILIDAD DE REFERENCIAS - WORKSPACE V1
# ============================================
# Sistema: SIMCO - NEXUS v4.0
# Proposito: Mapeo completo de referencias entre componentes
# Version: 1.0.0
# Fecha: 2026-01-04
# Generado por: Architecture-Analyst
version: "1.0.0"
fecha_actualizacion: "2026-01-04"
# ═══════════════════════════════════════════════════════════════════════════════
# ESTRUCTURA DE RECURSOS COMPARTIDOS
# ═══════════════════════════════════════════════════════════════════════════════
estructura_shared:
ruta_base: "/home/isem/workspace-v1/shared/"
componentes:
catalog:
ruta: "shared/catalog/"
descripcion: "Catalogo de funcionalidades reutilizables"
elementos:
- auth
- session-management
- rate-limiting
- notifications
- multi-tenancy
- feature-flags
- websocket
- payments
- audit-logs
- portales
- template-saas
modules:
ruta: "shared/modules/"
descripcion: "Codigo ejecutable compartido"
elementos:
- utils
- auth
- billing
- notifications
- payments
- multitenant
constants:
ruta: "shared/constants/"
descripcion: "Constantes globales TypeScript"
archivos:
- enums.constants.ts
- regex.constants.ts
- index.ts
types:
ruta: "shared/types/"
descripcion: "Tipos TypeScript compartidos"
archivos:
- api.types.ts
- common.types.ts
- index.ts
knowledge_base:
ruta: "shared/knowledge-base/"
descripcion: "Base de conocimiento"
subcarpetas:
- modules
- platforms
- projects
- standards
- architecture
- patterns
- propagacion
- templates
- reference
# ═══════════════════════════════════════════════════════════════════════════════
# ESTRUCTURA DE CORE (Arquitectura)
# ═══════════════════════════════════════════════════════════════════════════════
estructura_core:
ruta_base: "/home/isem/workspace-v1/core/"
componentes:
orchestration:
ruta: "core/orchestration/"
descripcion: "Sistema de orquestacion SIMCO"
subcarpetas:
- directivas
- templates
- agents
- patrones
- impactos
- checklists
- referencias
- inventarios
mcp_servers:
ruta: "core/mcp-servers/"
descripcion: "MCP servers especializados"
estado: "pendiente"
devtools:
ruta: "core/devtools/"
descripcion: "Herramientas de desarrollo ambiente"
# ═══════════════════════════════════════════════════════════════════════════════
# MAPA DE ALIASES Y SU UBICACION FISICA
# ═══════════════════════════════════════════════════════════════════════════════
mapa_aliases:
archivos_fuente:
- orchestration/referencias/ALIASES.yml
- orchestration/agents/ALIASES.yml
- core/orchestration/referencias/ALIASES.yml
aliases_principales:
# Catalogo
"@CATALOG": "shared/catalog/"
"@CATALOG_INDEX": "shared/catalog/CATALOG-INDEX.yml"
"@CATALOG_AUTH": "shared/catalog/auth/"
"@CATALOG_SESSION": "shared/catalog/session-management/"
"@CATALOG_RATELIMIT": "shared/catalog/rate-limiting/"
"@CATALOG_NOTIFY": "shared/catalog/notifications/"
"@CATALOG_TENANT": "shared/catalog/multi-tenancy/"
"@CATALOG_FLAGS": "shared/catalog/feature-flags/"
"@CATALOG_WS": "shared/catalog/websocket/"
"@CATALOG_PAYMENTS": "shared/catalog/payments/"
# Modulos
"@MODULES": "shared/modules/"
"@MOD_UTILS": "shared/modules/utils/"
"@MOD_AUTH": "shared/modules/auth/"
"@MOD_NOTIFY": "shared/modules/notifications/"
"@MOD_PAYMENTS": "shared/modules/payments/"
"@MOD_BILLING": "shared/modules/billing/"
"@MOD_TENANT": "shared/modules/multitenant/"
# Directivas
"@SIMCO": "orchestration/directivas/simco/"
"@PRINCIPIOS": "orchestration/directivas/principios/"
# Knowledge Base
"@KB": "shared/knowledge-base/"
"@KB_MODULES": "shared/knowledge-base/modules/"
"@KB_PLATFORMS": "shared/knowledge-base/platforms/"
"@KB_PROJECTS": "shared/knowledge-base/projects/"
# ═══════════════════════════════════════════════════════════════════════════════
# DEPENDENCIAS POR PROYECTO
# ═══════════════════════════════════════════════════════════════════════════════
dependencias_proyectos:
gamilit:
tipo: "STANDALONE"
usa_catalog:
- auth
- session-management
- rate-limiting
- notifications
- multi-tenancy
- feature-flags
usa_modules:
- utils
archivos_referencia:
- projects/gamilit/orchestration/CONTEXT-MAP.yml
trading_platform:
tipo: "STANDALONE"
usa_catalog:
- auth
- websocket
- payments
- rate-limiting
usa_modules:
- utils
- payments
archivos_referencia:
- projects/trading-platform/orchestration/CONTEXT-MAP.yml
erp_suite:
tipo: "MULTI-VERTICAL"
verticales:
- erp-core
- erp-clinicas
- erp-construccion
- erp-mecanicas-diesel
- erp-retail
- erp-vidrio-templado
usa_catalog:
- auth
- multi-tenancy
- notifications
- rate-limiting
- audit-logs
archivos_referencia:
- projects/erp-suite/orchestration/CONTEXT-MAP.yml
- projects/erp-core/orchestration/CONTEXT-MAP.yml
- projects/erp-*/orchestration/referencias/DEPENDENCIAS-SHARED.yml
betting_analytics:
tipo: "STANDALONE"
usa_catalog:
- auth
- websocket
- rate-limiting
archivos_referencia:
- projects/betting-analytics/orchestration/CONTEXT-MAP.yml
inmobiliaria_analytics:
tipo: "STANDALONE"
usa_catalog:
- auth
- multi-tenancy
archivos_referencia:
- projects/inmobiliaria-analytics/orchestration/CONTEXT-MAP.yml
platform_marketing_content:
tipo: "STANDALONE"
usa_catalog:
- auth
- multi-tenancy
- notifications
archivos_referencia:
- projects/platform_marketing_content/orchestration/CONTEXT-MAP.yml
# ═══════════════════════════════════════════════════════════════════════════════
# MIGRACION DE REFERENCIAS (LOG DE CAMBIOS)
# ═══════════════════════════════════════════════════════════════════════════════
migracion_2026_01_04:
descripcion: "Reorganizacion core/ → shared/"
cambios_realizados:
- origen: "core/catalog/"
destino: "shared/catalog/"
archivos_afectados: 130+
estado: "COMPLETADO"
- origen: "core/modules/"
destino: "shared/modules/"
archivos_afectados: 23+
estado: "COMPLETADO"
- origen: "core/constants/"
destino: "shared/constants/"
archivos_afectados: 5+
estado: "COMPLETADO"
- origen: "core/types/"
destino: "shared/types/"
archivos_afectados: 5+
estado: "COMPLETADO"
- origen: "core/standards/"
destino: "shared/knowledge-base/standards/"
archivos_afectados: 1
estado: "COMPLETADO"
- origen: "shared/libs/"
destino: "ELIMINADO (duplicado de catalog)"
archivos_afectados: 34
estado: "COMPLETADO"
referencias_corregidas:
- archivo: "projects/erp-suite/docs/VERTICAL-GUIDE.md"
linea: 763
antes: "workspace/core/knowledge-base/patterns/PATRON-CORE-ODOO.md"
despues: "erp-core/orchestration/directivas/DIRECTIVA-PATRONES-ODOO.md"
- archivo: "projects/erp-suite/docs/ARCHITECTURE.md"
linea: 384
antes: "/home/isem/workspace/core/knowledge-base/patterns/PATRON-CORE-ODOO.md"
despues: "erp-core/orchestration/directivas/DIRECTIVA-PATRONES-ODOO.md"
- archivo: "projects/erp-suite/docs/ARCHITECTURE.md"
linea: 563
antes: "workspace/core/knowledge-base/patterns/PATRON-CORE-ODOO.md"
despues: "erp-core/orchestration/directivas/DIRECTIVA-PATRONES-ODOO.md"
# ═══════════════════════════════════════════════════════════════════════════════
# VALIDACION DE REFERENCIAS
# ═══════════════════════════════════════════════════════════════════════════════
validacion:
fecha: "2026-01-04"
estado: "COMPLETADO"
archivos_verificados:
ALIASES_yml:
cantidad: 3
ubicaciones:
- orchestration/referencias/ALIASES.yml
- orchestration/agents/ALIASES.yml
- core/orchestration/referencias/ALIASES.yml
estado: "OK - Apuntan a shared/"
CONTEXT_MAP_yml:
cantidad: 12
proyectos:
- gamilit
- trading-platform
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- erp-suite
- erp-core
- erp-clinicas
- erp-construccion
- erp-mecanicas-diesel
- erp-retail
- erp-vidrio-templado
estado: "OK - Sin referencias a core/catalog o core/modules"
DEPENDENCIAS_SHARED_yml:
cantidad: 5
proyectos:
- erp-clinicas
- erp-vidrio-templado
- erp-mecanicas-diesel
- erp-retail
- erp-construccion
estado: "OK - Apuntan a shared/catalog/"
referencias_legacy_historicas:
descripcion: "175 archivos con rutas /home/isem/workspace/ (historicos)"
accion: "No requieren correccion - son documentos de auditoria historica"
ubicacion_principal: "projects/gamilit/orchestration/reportes/"
# ═══════════════════════════════════════════════════════════════════════════════
# MANTENIMIENTO FUTURO
# ═══════════════════════════════════════════════════════════════════════════════
mantenimiento:
al_agregar_funcionalidad_catalog:
pasos:
- Agregar a shared/catalog/{nombre}/
- Actualizar shared/catalog/CATALOG-INDEX.yml
- Agregar alias @CATALOG_{NOMBRE} en orchestration/referencias/ALIASES.yml
- Actualizar shared/README.md si es necesario
al_agregar_modulo_shared:
pasos:
- Agregar a shared/modules/{nombre}/
- Agregar alias @MOD_{NOMBRE} en orchestration/referencias/ALIASES.yml
- Actualizar shared/README.md
al_crear_nuevo_proyecto:
pasos:
- Crear CONTEXT-MAP.yml con aliases apuntando a shared/
- Crear DEPENDENCIAS-SHARED.yml si usa modulos del catalogo
- Actualizar TRAZABILIDAD-PROYECTOS.yml en knowledge-base
# ═══════════════════════════════════════════════════════════════════════════════
# METADATA
# ═══════════════════════════════════════════════════════════════════════════════
metadata:
creado_por: "Architecture-Analyst"
fecha_creacion: "2026-01-04"
proposito: "Trazabilidad de referencias post-reorganizacion"
relacionado_con:
- shared/README.md
- core/README.md
- orchestration/referencias/ALIASES.yml
- shared/knowledge-base/TRAZABILIDAD-PROYECTOS.yml