workspace-v1/orchestration/directivas/simco/SIMCO-CONTEXT-RESOLUTION.md

SIMCO: RESOLUCIÓN AUTOMÁTICA DE CONTEXTO

Versión: 1.0.0 Sistema: SIMCO - NEXUS v4.0 Propósito: Automatizar la carga de contexto basándose en tarea y proyecto Fecha: 2026-01-04

---

PRINCIPIO FUNDAMENTAL

El contexto correcto se determina automáticamente a partir de:

1. El proyecto donde se trabaja
2. El tipo de tarea a realizar
3. Las palabras clave en la descripción Resultado: Lista exacta de archivos a cargar, optimizada para tokens.

---

PROCESO DE RESOLUCIÓN (4 PASOS)

PASO 1: Analizar Descripción de Tarea

ENTRADA: "Descripción de tarea del usuario"

EXTRAER:
  keywords:
    - buscar: ["tabla", "DDL", "schema", "columna", "índice"]
      dominio: DDL
    - buscar: ["entity", "service", "controller", "endpoint", "API"]
      dominio: BACKEND
    - buscar: ["componente", "página", "hook", "frontend", "UI"]
      dominio: FRONTEND
    - buscar: ["refactor", "optimizar", "mejorar"]
      operacion: MODIFICAR
    - buscar: ["crear", "nuevo", "agregar", "implementar"]
      operacion: CREAR
    - buscar: ["corregir", "fix", "bug", "error"]
      operacion: MODIFICAR
    - buscar: ["validar", "verificar", "test"]
      operacion: VALIDAR

SALIDA:
  operacion: "{CREAR | MODIFICAR | VALIDAR | BUSCAR}"
  dominio: "{DDL | BACKEND | FRONTEND | MIXTO}"
  keywords: ["{lista de palabras clave encontradas}"]

PASO 2: Cargar CONTEXT-MAP del Proyecto

BUSCAR: "{PROYECTO}/orchestration/CONTEXT-MAP.yml"

SI_EXISTE:
  - Leer CONTEXT-MAP.yml
  - Usar definiciones del proyecto
  - Variables ya resueltas

SI_NO_EXISTE:
  - Usar TEMPLATE-CONTEXT-MAP.yml
  - Resolver variables manualmente
  - ADVERTENCIA: "Considerar crear CONTEXT-MAP.yml para este proyecto"

PASO 3: Resolver Archivos por Nivel

L0_SISTEMA (SIEMPRE):
  archivos:
    - core/orchestration/directivas/principios/PRINCIPIO-CAPVED.md
    - core/orchestration/directivas/principios/PRINCIPIO-DOC-PRIMERO.md
    - core/orchestration/directivas/principios/PRINCIPIO-ANTI-DUPLICACION.md
    - core/orchestration/directivas/principios/PRINCIPIO-VALIDACION-OBLIGATORIA.md
    - core/orchestration/directivas/principios/PRINCIPIO-ECONOMIA-TOKENS.md
    - core/orchestration/directivas/principios/PRINCIPIO-NO-ASUMIR.md
    - orchestration/agents/perfiles/PERFIL-{DOMINIO}.md
    - orchestration/referencias/ALIASES.yml

L1_PROYECTO (SIEMPRE):
  archivos:
    - "{PROYECTO}/orchestration/00-guidelines/CONTEXTO-PROYECTO.md"
    - "{PROYECTO}/orchestration/PROXIMA-ACCION.md"
    - "{PROYECTO}/orchestration/inventarios/{DOMINIO}_INVENTORY.yml"

L2_OPERACION (SEGÚN ANÁLISIS):
  CREAR:
    - orchestration/directivas/simco/SIMCO-CREAR.md
    - orchestration/directivas/simco/SIMCO-{DOMINIO}.md
  MODIFICAR:
    - orchestration/directivas/simco/SIMCO-MODIFICAR.md
    - orchestration/directivas/simco/SIMCO-{DOMINIO}.md
  VALIDAR:
    - orchestration/directivas/simco/SIMCO-VALIDAR.md
  BUSCAR:
    - orchestration/directivas/simco/SIMCO-BUSCAR.md

L3_TAREA (DINÁMICO):
  segun_keywords:
    tabla:
      - "{DB_DDL_PATH}/schemas/{schema}/tables/{tabla}.sql"
      - "docs/especificaciones/modelo-datos.md"
    entity:
      - "{DDL de tabla relacionada}"
      - "{BACKEND_SRC}/modules/{modulo}/entities/*.entity.ts"
    componente:
      - "docs/especificaciones/wireframes.md"
      - "{FRONTEND_SRC}/components/{similar}/*.tsx"
    endpoint:
      - "docs/especificaciones/api/*.md"
      - "{BACKEND_SRC}/modules/{modulo}/controllers/*.controller.ts"

PASO 4: Verificar y Validar

VERIFICACION:
  - [ ] Todos los archivos existen
  - [ ] Variables resueltas (sin placeholders)
  - [ ] Total tokens < 18000 (límite seguro)
  - [ ] Contexto suficiente para la tarea

SI_TOKENS_EXCEDEN:
  accion: "Reducir L3_tarea"
  estrategia:
    - Usar referencias file:line en lugar de contenido
    - Eliminar archivos menos relevantes
    - Considerar desglose de tarea

RESULTADO:
  estado: "READY_TO_EXECUTE | NEEDS_REDUCTION | ERROR"
  archivos_a_cargar: ["{lista ordenada}"]
  tokens_estimados: "{número}"

---

MAPA TAREA → CONTEXTO

Por Palabra Clave

KEYWORDS_CONTEXT_MAP:
  # Database
  "tabla":
    dominio: DDL
    operacion: CREAR
    contexto:
      - SIMCO-DDL.md
      - DATABASE_INVENTORY.yml
      - "{DB_DDL_PATH}/schemas/{schema}/tables/*.sql" (similar)

  "índice":
    dominio: DDL
    operacion: CREAR
    contexto:
      - SIMCO-DDL.md
      - DDL de tabla objetivo

  "migración":
    dominio: DDL
    operacion: MODIFICAR
    contexto:
      - SIMCO-DDL.md
      - DDL actual de tabla
      - BACKEND_INVENTORY.yml (entities afectadas)

  # Backend
  "entity":
    dominio: BACKEND
    operacion: CREAR
    contexto:
      - SIMCO-BACKEND.md
      - DDL de tabla relacionada
      - Entity similar (patrón)

  "service":
    dominio: BACKEND
    operacion: CREAR
    contexto:
      - SIMCO-BACKEND.md
      - Entity relacionada
      - Service similar (patrón)

  "controller":
    dominio: BACKEND
    operacion: CREAR
    contexto:
      - SIMCO-BACKEND.md
      - Service relacionado
      - API spec (si existe)

  "endpoint":
    dominio: BACKEND
    operacion: CREAR
    contexto:
      - SIMCO-BACKEND.md
      - docs/api/*.md
      - Controller relacionado

  # Frontend
  "componente":
    dominio: FRONTEND
    operacion: CREAR
    contexto:
      - SIMCO-FRONTEND.md
      - Wireframe/mockup
      - Componente similar

  "página":
    dominio: FRONTEND
    operacion: CREAR
    contexto:
      - SIMCO-FRONTEND.md
      - Wireframe completo
      - Endpoint API relacionado

  "hook":
    dominio: FRONTEND
    operacion: CREAR
    contexto:
      - SIMCO-FRONTEND.md
      - Hook similar
      - API endpoint que consume

  # Operaciones
  "refactor":
    operacion: MODIFICAR
    contexto:
      - SIMCO-MODIFICAR.md
      - Código actual completo
      - Tests existentes

  "bug":
    operacion: MODIFICAR
    contexto:
      - SIMCO-MODIFICAR.md
      - REGISTRO-ERRORES.yml
      - Código con bug
      - Tests relacionados

  "test":
    operacion: VALIDAR
    contexto:
      - SIMCO-VALIDAR.md
      - Código a testear
      - Tests existentes (patrón)

---

FORMATO DE SALIDA

# Resultado de CONTEXT-RESOLUTION
resolucion_contexto:
  timestamp: "{YYYY-MM-DD HH:MM}"
  proyecto: "{nombre}"
  tarea: "{descripción breve}"

  analisis:
    operacion: "{tipo}"
    dominio: "{capa}"
    keywords: ["{lista}"]

  archivos_a_cargar:
    L0_sistema:
      - path: "{ruta}"
        tokens: "{estimado}"
    L1_proyecto:
      - path: "{ruta}"
        tokens: "{estimado}"
    L2_operacion:
      - path: "{ruta}"
        tokens: "{estimado}"
    L3_tarea:
      - path: "{ruta}"
        tokens: "{estimado}"
        tipo: "completo | referencia"

  metricas:
    total_archivos: "{N}"
    tokens_estimados: "{N}"
    dentro_limite: "{true | false}"

  estado: "READY_TO_EXECUTE"

---

INTEGRACIÓN CON CAPVED++

Este proceso se ejecuta en FASE 0 del ciclo CAPVED++:

TAREA RECIBIDA
     │
     ▼
┌─────────────────────────────┐
│  PASO 1: Analizar Keywords  │
└─────────────────────────────┘
     │
     ▼
┌─────────────────────────────┐
│  PASO 2: Cargar CONTEXT-MAP │
└─────────────────────────────┘
     │
     ▼
┌─────────────────────────────┐
│  PASO 3: Resolver Archivos  │
└─────────────────────────────┘
     │
     ▼
┌─────────────────────────────┐
│  PASO 4: Verificar Tokens   │
└─────────────────────────────┘
     │
     ▼
READY_TO_EXECUTE → FASE C (Contexto)

---

CASOS ESPECIALES

Tarea Multi-Dominio

SI_DOMINIO_MIXTO:
  - Cargar SIMCO de cada dominio afectado
  - Priorizar: DDL → BACKEND → FRONTEND
  - Verificar tokens con todos los contextos
  - Si excede: Desglosar por dominio

Tarea Sin Keywords Claras

SI_NO_HAY_KEYWORDS:
  accion: "Usar contexto genérico"
  cargar:
    - SIMCO-TAREA.md (ciclo completo)
    - MASTER_INVENTORY.yml
    - PROXIMA-ACCION.md
  nota: "Preguntar al usuario para clarificar si es ambiguo"

Búsqueda de Errores Previos

SI_KEYWORD_BUG_O_ERROR:
  antes_de_resolver:
    - Buscar en orchestration/errores/REGISTRO-ERRORES.yml
    - Buscar en shared/knowledge-base/lessons-learned/
    - Si encuentra similar: Agregar a L3_tarea

---

REFERENCIAS

Documento	Propósito
CONTEXT-MAP.yml	Mapa por proyecto
SIMCO-CONTROL-TOKENS.md	Límites de tokens
SIMCO-CAPVED-PLUS.md	Integración con FASE 0
SIMCO-INICIALIZACION.md	Protocolo CCA

---

Versión: 1.0.0 | Sistema: SIMCO-NEXUS v4.0 | Tipo: Directiva de Resolución