rckrdmrd/workspace-v1
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
develop
workspace-v1/orchestration/templates/TEMPLATE-CONTEXT-MAP.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

324 lines
12 KiB
YAML
Raw Permalink Blame History

# TEMPLATE: CONTEXT-MAP
# Sistema: SIMCO - NEXUS v4.0
# Propósito: Mapear contexto automático por nivel y tarea
# Versión: 1.0.0
# Fecha: 2026-01-04
#
# INSTRUCCIONES:
# 1. Copiar este template a {proyecto}/orchestration/CONTEXT-MAP.yml
# 2. Resolver todas las variables entre llaves {VARIABLE}
# 3. Ajustar archivos específicos del proyecto
# 4. Verificar que tokens_estimados no excedan límites
metadata:
proyecto: "{PROJECT_NAME}"
nivel: "{STANDALONE | SUITE | SUITE_CORE | VERTICAL}"
version: "1.0.0"
ultima_actualizacion: "{YYYY-MM-DD}"
workspace_root: "/home/isem/workspace-v1"
project_root: "{PROJECT_ROOT}"
# ═══════════════════════════════════════════════════════════════════════════════
# VARIABLES DEL PROYECTO (PRE-RESUELTAS)
# ═══════════════════════════════════════════════════════════════════════════════
variables:
# Identificación
PROJECT_NAME: "{nombre_proyecto}"
PROJECT_LEVEL: "{nivel}"
# Base de datos
DB_NAME: "{nombre_bd}"
DB_DDL_PATH: "{ruta_ddl}"
DB_SCRIPTS_PATH: "{ruta_scripts}"
DB_SEEDS_PATH: "{ruta_seeds}"
RECREATE_CMD: "{comando_recrear}"
# Backend
BACKEND_ROOT: "{ruta_backend}"
BACKEND_SRC: "{ruta_src_backend}"
# Frontend
FRONTEND_ROOT: "{ruta_frontend}"
FRONTEND_SRC: "{ruta_src_frontend}"
# Documentación
DOCS_PATH: "{ruta_docs}"
ORCHESTRATION_PATH: "{ruta_orchestration}"
# ═══════════════════════════════════════════════════════════════════════════════
# ALIASES RESUELTOS
# ═══════════════════════════════════════════════════════════════════════════════
aliases:
# Directivas globales
"@SIMCO": "orchestration/directivas/simco"
"@PRINCIPIOS": "orchestration/directivas/principios"
"@PERFILES": "orchestration/agents/perfiles"
"@CATALOG": "shared/catalog"
# Proyecto específico
"@DDL": "{DB_DDL_PATH}"
"@SEEDS": "{DB_SEEDS_PATH}"
"@BACKEND": "{BACKEND_SRC}"
"@FRONTEND": "{FRONTEND_SRC}"
"@DOCS": "{DOCS_PATH}"
# Inventarios
"@INVENTORY": "{ORCHESTRATION_PATH}/inventarios"
"@INV_DB": "{ORCHESTRATION_PATH}/inventarios/DATABASE_INVENTORY.yml"
"@INV_BE": "{ORCHESTRATION_PATH}/inventarios/BACKEND_INVENTORY.yml"
"@INV_FE": "{ORCHESTRATION_PATH}/inventarios/FRONTEND_INVENTORY.yml"
# Trazas
"@TRAZA_DB": "{ORCHESTRATION_PATH}/trazas/TRAZA-TAREAS-DATABASE.md"
"@TRAZA_BE": "{ORCHESTRATION_PATH}/trazas/TRAZA-TAREAS-BACKEND.md"
"@TRAZA_FE": "{ORCHESTRATION_PATH}/trazas/TRAZA-TAREAS-FRONTEND.md"
# ═══════════════════════════════════════════════════════════════════════════════
# CONTEXTO POR NIVEL (con estimación de tokens)
# ═══════════════════════════════════════════════════════════════════════════════
contexto_por_nivel:
L0_sistema:
descripcion: "Principios fundamentales y perfil de agente"
tokens_estimados: 4500
obligatorio: true
archivos:
- path: "orchestration/directivas/principios/PRINCIPIO-CAPVED.md"
proposito: "Ciclo de vida de tareas"
tokens: 800
prioridad: 1
- path: "orchestration/directivas/principios/PRINCIPIO-DOC-PRIMERO.md"
proposito: "Documentación antes de código"
tokens: 500
prioridad: 2
- path: "orchestration/directivas/principios/PRINCIPIO-ANTI-DUPLICACION.md"
proposito: "Verificar catálogo antes de crear"
tokens: 600
prioridad: 2
- path: "orchestration/directivas/principios/PRINCIPIO-VALIDACION-OBLIGATORIA.md"
proposito: "Build/lint deben pasar"
tokens: 600
prioridad: 2
- path: "orchestration/directivas/principios/PRINCIPIO-ECONOMIA-TOKENS.md"
proposito: "Límites de contexto"
tokens: 500
prioridad: 3
- path: "orchestration/directivas/principios/PRINCIPIO-NO-ASUMIR.md"
proposito: "Preguntar si falta información"
tokens: 500
prioridad: 3
- path: "orchestration/referencias/ALIASES.yml"
proposito: "Resolución de @ALIAS"
tokens: 400
prioridad: 1
validacion:
checklist:
- "Conoce los 6 principios"
- "Puede resolver @ALIAS básicos"
L1_proyecto:
descripcion: "Contexto específico del proyecto"
tokens_estimados: 3000
obligatorio: true
archivos:
- path: "{ORCHESTRATION_PATH}/00-guidelines/CONTEXTO-PROYECTO.md"
proposito: "Variables y configuración del proyecto"
tokens: 1500
prioridad: 1
- path: "{ORCHESTRATION_PATH}/PROXIMA-ACCION.md"
proposito: "Estado actual y siguiente paso"
tokens: 500
prioridad: 1
- path: "{ORCHESTRATION_PATH}/inventarios/MASTER_INVENTORY.yml"
proposito: "Estado de artefactos"
tokens: 1000
prioridad: 2
validacion:
checklist:
- "Resuelve {DB_NAME}, {BACKEND_ROOT}, etc."
- "Conoce estado del proyecto"
- "Sabe próxima acción prioritaria"
L2_operacion:
descripcion: "SIMCO específicos según operación y dominio"
tokens_estimados: 2500
obligatorio: true
archivos_por_operacion:
CREAR:
- path: "orchestration/directivas/simco/SIMCO-CREAR.md"
tokens: 1000
MODIFICAR:
- path: "orchestration/directivas/simco/SIMCO-MODIFICAR.md"
tokens: 1000
VALIDAR:
- path: "orchestration/directivas/simco/SIMCO-VALIDAR.md"
tokens: 800
BUSCAR:
- path: "orchestration/directivas/simco/SIMCO-BUSCAR.md"
tokens: 600
DELEGAR:
- path: "orchestration/directivas/simco/SIMCO-DELEGACION.md"
tokens: 1200
archivos_por_dominio:
DDL:
- path: "orchestration/directivas/simco/SIMCO-DDL.md"
tokens: 1000
- path: "{ORCHESTRATION_PATH}/inventarios/DATABASE_INVENTORY.yml"
tokens: 800
BACKEND:
- path: "orchestration/directivas/simco/SIMCO-BACKEND.md"
tokens: 1000
- path: "{ORCHESTRATION_PATH}/inventarios/BACKEND_INVENTORY.yml"
tokens: 800
FRONTEND:
- path: "orchestration/directivas/simco/SIMCO-FRONTEND.md"
tokens: 1000
- path: "{ORCHESTRATION_PATH}/inventarios/FRONTEND_INVENTORY.yml"
tokens: 800
L3_tarea:
descripcion: "Contexto específico de la tarea"
tokens_max: 8000
dinamico: true
resolucion_automatica:
por_keyword:
tabla:
archivos:
- "{DB_DDL_PATH}/schemas/{schema}/*.sql"
- "{DOCS_PATH}/especificaciones/modelo-datos.md"
entity:
archivos:
- "{DDL de tabla relacionada}"
- "{BACKEND_SRC}/modules/{modulo}/entities/*.entity.ts"
componente:
archivos:
- "{DOCS_PATH}/especificaciones/wireframes.md"
- "{FRONTEND_SRC}/components/{similar}/*.tsx"
endpoint:
archivos:
- "{DOCS_PATH}/especificaciones/api/*.md"
- "{BACKEND_SRC}/modules/{modulo}/controllers/*.controller.ts"
bug:
archivos:
- "orchestration/errores/REGISTRO-ERRORES.yml"
- "{código_afectado}"
# ═══════════════════════════════════════════════════════════════════════════════
# MAPA TAREA → ARCHIVOS
# ═══════════════════════════════════════════════════════════════════════════════
mapa_tarea_contexto:
database:
crear_tabla:
simco: ["SIMCO-CREAR.md", "SIMCO-DDL.md"]
inventario: "@INV_DB"
referencia: "{DB_DDL_PATH}/schemas/*/tables/*.sql"
docs: "{DOCS_PATH}/especificaciones/modelo-datos.md"
crear_indice:
simco: ["SIMCO-CREAR.md", "SIMCO-DDL.md"]
inventario: "@INV_DB"
referencia: "DDL de tabla objetivo"
modificar_tabla:
simco: ["SIMCO-MODIFICAR.md", "SIMCO-DDL.md"]
inventario: "@INV_DB"
referencia: "DDL actual + Entities afectadas"
backend:
crear_entity:
simco: ["SIMCO-CREAR.md", "SIMCO-BACKEND.md"]
inventario: "@INV_BE"
referencia: "DDL de tabla + Entity similar"
crear_service:
simco: ["SIMCO-CREAR.md", "SIMCO-BACKEND.md"]
inventario: "@INV_BE"
referencia: "Entity + Service similar"
crear_controller:
simco: ["SIMCO-CREAR.md", "SIMCO-BACKEND.md"]
inventario: "@INV_BE"
referencia: "Service + API spec"
crear_dto:
simco: ["SIMCO-CREAR.md", "SIMCO-BACKEND.md"]
inventario: "@INV_BE"
referencia: "Entity + DTO similar"
frontend:
crear_componente:
simco: ["SIMCO-CREAR.md", "SIMCO-FRONTEND.md"]
inventario: "@INV_FE"
referencia: "Wireframe + Componente similar"
crear_pagina:
simco: ["SIMCO-CREAR.md", "SIMCO-FRONTEND.md"]
inventario: "@INV_FE"
referencia: "Wireframe + API endpoints"
crear_hook:
simco: ["SIMCO-CREAR.md", "SIMCO-FRONTEND.md"]
inventario: "@INV_FE"
referencia: "API endpoint + Hook similar"
# ═══════════════════════════════════════════════════════════════════════════════
# VALIDACIÓN DE TOKENS
# ═══════════════════════════════════════════════════════════════════════════════
validacion_tokens:
limite_absoluto: 25000
limite_seguro: 18000
limite_alerta: 20000
presupuesto:
L0_sistema: 4500
L1_proyecto: 3000
L2_operacion: 2500
L3_tarea_max: 8000
total_base: 10000
disponible_tarea: 8000
estrategia_exceso:
si_excede_alerta:
- "Usar referencias file:line en lugar de contenido"
- "Eliminar archivos menos relevantes de L3"
si_excede_seguro:
- "Desglosar tarea en subtareas"
- "Ejecutar secuencialmente"
# ═══════════════════════════════════════════════════════════════════════════════
# HERENCIA (si aplica)
# ═══════════════════════════════════════════════════════════════════════════════
herencia:
# Completar según nivel del proyecto
STANDALONE:
hereda_de:
- "orchestration/" # Workspace root
VERTICAL:
hereda_de:
- "../../../orchestration/" # Suite
- "orchestration/" # Workspace root
SUITE_CORE:
hereda_de:
- "../../orchestration/" # Suite
- "orchestration/" # Workspace root
# ═══════════════════════════════════════════════════════════════════════════════
# BÚSQUEDA DE HISTÓRICO
# ═══════════════════════════════════════════════════════════════════════════════
busqueda_historico:
habilitado: true
ubicaciones:
- "orchestration/trazas/"
- "orchestration/errores/REGISTRO-ERRORES.yml"
- "shared/knowledge-base/lessons-learned/"
si_encuentra_similar:
accion: "Agregar a L3_tarea"
prioridad: "alta"
Reference in New Issue View Git Blame Copy Permalink