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)

```yaml
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)

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

### Segun Operacion (Cargar si aplica)

```yaml
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:

```yaml
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:

```yaml
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:

```markdown
## 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