workspace/orchestration/directivas/DIRECTIVA-CARGA-CONTEXTO.md

DIRECTIVA: CARGA DE CONTEXTO SEGUN NIVEL

Version: 1.0.0 Fecha: 2025-12-18 Nivel: WORKSPACE Tipo: Directiva Fundamental - OBLIGATORIA Aplica a: TODOS los agentes y subagentes

---

PROPOSITO

Esta directiva define COMO cargar las directivas correctas segun el nivel de trabajo especificado en el prompt.

---

PASO 1: IDENTIFICAR NIVEL DE TRABAJO

Cuando recibas un prompt con:

• proyecto: {nombre}
• subproyecto: {nombre} (opcional)
• tarea: {descripcion}

Determinar el nivel segun esta tabla:

Si proyecto es...	Y subproyecto es...	Entonces nivel es...
gamilit, trading-platform, betting-analytics, inmobiliaria-analytics	null	STANDALONE
erp-suite	null	SUITE
erp-suite	erp-core	SUITE-CORE
erp-suite	verticales/{nombre}	VERTICAL
erp-suite	saas	SUITE-SERVICE
erp-suite	products/{nombre}	SUITE-PRODUCT

---

PASO 2: OBTENER CADENA DE HERENCIA

Segun el nivel identificado, cargar directivas en este orden:

STANDALONE

1. WORKSPACE  → workspace/orchestration/directivas/
2. CORE       → core/orchestration/directivas/principios/
3. CORE       → core/orchestration/directivas/simco/
4. PROYECTO   → projects/{proyecto}/orchestration/00-guidelines/
5. PROYECTO   → projects/{proyecto}/docs/00-vision-general/directivas/

SUITE

1. WORKSPACE  → workspace/orchestration/directivas/
2. CORE       → core/orchestration/directivas/principios/
3. CORE       → core/orchestration/directivas/simco/
4. SUITE      → projects/erp-suite/orchestration/00-guidelines/
5. SUITE      → projects/erp-suite/docs/00-vision-general/directivas/

SUITE-CORE

1. WORKSPACE  → workspace/orchestration/directivas/
2. CORE       → core/orchestration/directivas/principios/
3. CORE       → core/orchestration/directivas/simco/
4. SUITE      → projects/erp-suite/orchestration/00-guidelines/
5. SUITE-CORE → projects/erp-suite/apps/erp-core/orchestration/00-guidelines/
6. SUITE-CORE → projects/erp-suite/apps/erp-core/docs/00-vision-general/directivas/

VERTICAL

1. WORKSPACE  → workspace/orchestration/directivas/
2. CORE       → core/orchestration/directivas/principios/
3. CORE       → core/orchestration/directivas/simco/
4. SUITE      → projects/erp-suite/orchestration/00-guidelines/
5. SUITE-CORE → projects/erp-suite/apps/erp-core/orchestration/00-guidelines/
6. VERTICAL   → projects/erp-suite/apps/verticales/{vertical}/orchestration/00-guidelines/
7. VERTICAL   → projects/erp-suite/apps/verticales/{vertical}/docs/00-vision-general/directivas/

---

PASO 3: CARGAR DIRECTIVAS OBLIGATORIAS

Desde CORE (Siempre obligatorias)

Principios_Obligatorios:
  - 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

Operacion_Principal:
  - core/orchestration/directivas/simco/SIMCO-TAREA.md

Documentacion:
  - core/orchestration/directivas/DIRECTIVA-DOCUMENTACION-DEFINITIVA.md

Desde PROYECTO (Siempre obligatorias)

Contexto:
  - {proyecto}/orchestration/00-guidelines/CONTEXTO-PROYECTO.md
  - {proyecto}/orchestration/00-guidelines/HERENCIA-SIMCO.md

Segun Operacion (Cargar si aplica)

Si_operacion_es_DDL:
  - core/orchestration/directivas/simco/SIMCO-DDL.md

Si_operacion_es_BACKEND:
  - core/orchestration/directivas/simco/SIMCO-BACKEND.md

Si_operacion_es_FRONTEND:
  - core/orchestration/directivas/simco/SIMCO-FRONTEND.md

Si_operacion_es_CREAR:
  - core/orchestration/directivas/simco/SIMCO-CREAR.md

Si_operacion_es_MODIFICAR:
  - core/orchestration/directivas/simco/SIMCO-MODIFICAR.md

---

PASO 4: RESOLVER CONTEXTO DEL PROYECTO

Leer CONTEXTO-PROYECTO.md del nivel mas especifico y obtener:

Variables_a_Resolver:
  PROJECT: "{nombre del proyecto}"
  PROJECT_LEVEL: "{STANDALONE | SUITE | VERTICAL | etc}"
  DB_NAME: "{nombre de la base de datos}"
  DB_DDL_PATH: "{ruta a DDL}"
  BACKEND_ROOT: "{ruta a backend}"
  FRONTEND_ROOT: "{ruta a frontend}"

---

PASO 5: CONFIRMAR CARGA

Antes de proceder con la tarea, generar confirmacion:

Confirmacion_Carga:
  nivel_identificado: "{NIVEL}"
  proyecto: "{nombre}"
  subproyecto: "{nombre o null}"

  directivas_cargadas:
    workspace: [lista]
    core_principios: [lista]
    core_simco: [lista]
    proyecto: [lista]
    especificas: [lista]

  contexto_resuelto:
    PROJECT: "{valor}"
    DB_DDL_PATH: "{valor}"
    BACKEND_ROOT: "{valor}"
    FRONTEND_ROOT: "{valor}"

  estado: "READY_TO_EXECUTE"

---

PASO 6: EJECUTAR CICLO CAPVED

Una vez confirmada la carga, seguir el ciclo CAPVED:

C - Contexto:     ✓ Completado en pasos 1-5
A - Analisis:     Analizar alcance e impacto de la tarea
P - Planeacion:   Crear plan de implementacion
V - Validacion:   Validar plan vs analisis (NO DELEGAR)
E - Ejecucion:    Implementar en orden planificado
D - Documentacion: Actualizar docs/ como estado FINAL

---

DELEGACION A SUBAGENTES

Cuando delegues a un subagente, incluir en el prompt:

## Contexto para Subagente

**Proyecto:** {nombre}
**Subproyecto:** {nombre o null}
**Nivel:** {STANDALONE | SUITE | VERTICAL | etc}

**Directivas Cargadas:**
- {lista de directivas ya cargadas}

**Contexto Resuelto:**
- PROJECT: {valor}
- DB_DDL_PATH: {valor}
- BACKEND_ROOT: {valor}

**Tarea Especifica:** {descripcion de subtarea}

**Restricciones:**
- Seguir principio CAPVED
- Documentar como estado FINAL (no historico)
- Reportar hallazgos al agente principal

---

CONSULTAR INDICE MAESTRO

Para ver todas las directivas disponibles:

Archivo: /home/isem/workspace/orchestration/INDICE-DIRECTIVAS-WORKSPACE.yml

Este archivo contiene:

• Todas las directivas por nivel
• Aliases (@CAPVED, @TAREA, etc.)
• Cadenas de herencia
• Proyectos y subproyectos disponibles

---

ERRORES COMUNES

Error: No se identifica el nivel

Solucion: Verificar que proyecto y subproyecto estan correctamente especificados

Error: Directiva no encontrada

Solucion: Consultar INDICE-DIRECTIVAS-WORKSPACE.yml para rutas correctas

Error: Contexto no resuelto

Solucion: Verificar que CONTEXTO-PROYECTO.md existe en el nivel especificado

---

REFERENCIAS

Documento	Alias	Proposito
PRINCIPIO-CAPVED.md	@CAPVED	Ciclo de vida de tareas
PRINCIPIO-DOC-PRIMERO.md	@DOC-PRIMERO	Documentar antes de implementar
SIMCO-TAREA.md	@TAREA	Proceso detallado de tareas
DIRECTIVA-DOCUMENTACION-DEFINITIVA.md	@DOC-DEFINITIVA	Docs como estado final
INDICE-DIRECTIVAS-WORKSPACE.yml	@INDICE	Indice maestro

---

Esta directiva es OBLIGATORIA para todo agente y subagente.

---

Version: 1.0.0 | Nivel: WORKSPACE | Sistema: SIMCO v2.3.0