rckrdmrd/workspace-v1
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ff3038f183
workspace-v1/orchestration/INDICE-DIRECTIVAS-WORKSPACE.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

523 lines
20 KiB
YAML
Raw Blame History

# ═══════════════════════════════════════════════════════════════════════════════
# 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 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"
# ------------------------------------------
# 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": "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 (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 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"
Reference in New Issue View Git Blame Copy Permalink