# ANALISIS DE DEPENDENCIAS - ESTANDARIZACION DOCUMENTACION WORKSPACE
**Fecha:** 2026-01-10
**Fase:** 4 - Analisis de Dependencias
**Estado:** COMPLETADO
**Version:** 1.0.0
**Referencias:**
- PLAN-ESTANDARIZACION-DOCUMENTACION-WORKSPACE-2026-01-10.md
- VALIDACION-PLAN-ESTANDARIZACION-2026-01-10.md

---

## 1. RESUMEN EJECUTIVO

### Alcance del Sistema de Directivas

| Metrica | Valor |
|---------|-------|
| Directivas SIMCO existentes | 42 |
| Principios fundamentales | 6 |
| Perfiles de agentes | 28 |
| Templates | 24 |
| Proyectos con HERENCIA-SIMCO | 19 |
| Niveles jerarquicos | 7 |
| Archivos con referencias cruzadas | 146+ |
| Artefactos totales coordinados | 413+ |

### Impacto de Nuevas Directivas

| Tipo de Cambio | Archivos Afectados | Prioridad |
|----------------|-------------------|-----------|
| Agregar 7 directivas SIMCO | 26+ archivos | CRITICO |
| Agregar 5 templates | 4+ archivos | ALTO |
| Agregar 3 checklists | 2+ archivos | MEDIO |
| Actualizar indices | 5 archivos | CRITICO |
| Propagar a proyectos | 19 instancias | ALTO |

---

## 2. ESTRUCTURA DE HERENCIA

### 2.1 Cascada de Herencia (4 Niveles)

```
NIVEL 0: workspace/orchestration/          <- SSOT ABSOLUTO
  |
  +-> NIVEL 1: core/orchestration/         <- Directivas Tecnicas Base
       |
       +-> NIVEL 2A: projects/{standalone}/orchestration/
       |
       +-> NIVEL 2B: projects/{suite}/orchestration/
            |
            +-> NIVEL 3: projects/{suite}/apps/{vertical}/orchestration/
```

### 2.2 Proyectos por Tipo

**STANDALONE (5):**
- gamilit
- trading-platform
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- template-saas

**SUITE (1):**
- erp-suite

**SUITE-CORE (1):**
- erp-core

**VERTICALES (7):**
- construction
- retail
- vidrio-templado
- mecanicas-diesel
- clinicas (+ clinica-dental, clinica-veterinaria)
- erp-basico
- pos-micro

---

## 3. ARCHIVOS QUE REQUIEREN ACTUALIZACION

### 3.1 Tier 1 - SIEMPRE Actualizar

| Archivo | Ubicacion | Proposito | Accion |
|---------|-----------|-----------|--------|
| INDICE-DIRECTIVAS-WORKSPACE.yml | /orchestration/ | Registro maestro | AGREGAR 7 entradas |
| orchestration/README.md | /orchestration/ | Vision general | ACTUALIZAR |
| orchestration/_MAP.md | /orchestration/ | Mapa navegacion | AGREGAR 15 entradas |
| orchestration/agents/ALIASES.yml | /orchestration/agents/ | Mapeo aliases | AGREGAR 7 aliases |

### 3.2 Tier 2 - Actualizar Templates

| Archivo | Ubicacion | Accion |
|---------|-----------|--------|
| HERENCIA-SIMCO.md | /orchestration/templates/ | AGREGAR referencias |
| _MAP.md | /orchestration/directivas/simco/ | AGREGAR 7 directivas |
| _MAP.md | /orchestration/templates/ | AGREGAR 5 templates |
| _MAP.md | /orchestration/checklists/ | CREAR + 3 checklists |

### 3.3 Tier 3 - Propagar a Proyectos (19 instancias)

| Proyecto | Archivo | Estado Actual |
|----------|---------|---------------|
| gamilit | HERENCIA-SIMCO.md | EXISTE - Actualizar |
| erp-core | HERENCIA-SIMCO.md | EXISTE - Actualizar |
| template-saas | HERENCIA-SIMCO.md | EXISTE (minimo) - Expandir |
| michangarrito | HERENCIA-SIMCO.md | NO EXISTE - Crear |
| erp-suite | HERENCIA-SIMCO.md | EXISTE - Actualizar |
| erp-clinicas | HERENCIA-SIMCO.md | EXISTE - Actualizar |
| erp-construccion | HERENCIA-SIMCO.md | EXISTE - Actualizar |
| erp-mecanicas-diesel | HERENCIA-SIMCO.md | EXISTE - Actualizar |
| erp-retail | HERENCIA-SIMCO.md | EXISTE - Actualizar |
| erp-vidrio-templado | HERENCIA-SIMCO.md | EXISTE - Actualizar |
| betting-analytics | HERENCIA-SIMCO.md | EXISTE - Actualizar |
| trading-platform | HERENCIA-SIMCO.md | EXISTE - Actualizar |
| inmobiliaria-analytics | HERENCIA-SIMCO.md | EXISTE - Actualizar |
| platform_marketing_content | HERENCIA-SIMCO.md | EXISTE - Actualizar |
| erp-basico | HERENCIA-SIMCO.md | EXISTE - Actualizar |
| pos-micro | HERENCIA-SIMCO.md | EXISTE - Actualizar |
| clinica-dental | HERENCIA-SIMCO.md | IMPLICITO - via erp-clinicas |
| clinica-veterinaria | HERENCIA-SIMCO.md | IMPLICITO - via erp-clinicas |

---

## 4. MAPA DE DEPENDENCIAS POR DIRECTIVA

### 4.1 A1: SIMCO-DOCUMENTACION-PROYECTO.md

```
SIMCO-DOCUMENTACION-PROYECTO.md
    |
    +-> DEPENDIENTES DIRECTOS:
    |   +-> A2: SIMCO-NOMENCLATURA.md
    |   +-> A4: SIMCO-INVENTARIOS.md
    |   +-> B1: TEMPLATE-EPICA-ESTANDAR.md
    |   +-> B2: TEMPLATE-MODULO-ESTANDAR.md
    |   +-> C1: CHECKLIST-DOCUMENTACION-PROYECTO.md
    |
    +-> REFERENCIAS EN:
    |   +-> INDICE-DIRECTIVAS-WORKSPACE.yml
    |   +-> orchestration/agents/ALIASES.yml
    |   +-> orchestration/templates/HERENCIA-SIMCO.md
    |   +-> 19 instancias HERENCIA-SIMCO.md en proyectos
    |
    +-> PERFILES AFECTADOS:
        +-> PERFIL-DOCUMENTATION.md
        +-> PERFIL-ANALYST.md
```

### 4.2 A2: SIMCO-NOMENCLATURA.md

```
SIMCO-NOMENCLATURA.md
    |
    +-> DEPENDE DE:
    |   +-> A1: SIMCO-DOCUMENTACION-PROYECTO.md
    |
    +-> DEPENDIENTES DIRECTOS:
    |   +-> A3: SIMCO-ESTRUCTURA-DOCS.md
    |   +-> B3: TEMPLATE-MAP-INDICE.md
    |   +-> C3: CHECKLIST-NOMENCLATURA.md
    |
    +-> REFERENCIAS EN:
        +-> Todos los archivos _MAP.md del workspace
        +-> Todos los documentos PLAN-*.md, ANALISIS-*.md
```

### 4.3 A3: SIMCO-ESTRUCTURA-DOCS.md

```
SIMCO-ESTRUCTURA-DOCS.md
    |
    +-> DEPENDE DE:
    |   +-> A1: SIMCO-DOCUMENTACION-PROYECTO.md
    |   +-> A2: SIMCO-NOMENCLATURA.md
    |
    +-> DEPENDIENTES DIRECTOS:
    |   +-> B1: TEMPLATE-EPICA-ESTANDAR.md
    |   +-> B2: TEMPLATE-MODULO-ESTANDAR.md
    |   +-> C1: CHECKLIST-DOCUMENTACION-PROYECTO.md
    |
    +-> IMPACTO GLOBAL:
        +-> Todos los documentos MD del workspace
        +-> Estructura de frontmatter YAML
```

### 4.4 A4: SIMCO-INVENTARIOS.md

```
SIMCO-INVENTARIOS.md
    |
    +-> DEPENDE DE:
    |   +-> A1: SIMCO-DOCUMENTACION-PROYECTO.md
    |
    +-> DEPENDIENTES DIRECTOS:
    |   +-> B4: TEMPLATE-INVENTARIO-PROYECTO.md
    |   +-> C2: CHECKLIST-INVENTARIOS.md
    |
    +-> IMPACTO EN:
        +-> MASTER_INVENTORY.yml (19+ archivos)
        +-> DATABASE_INVENTORY.yml (4+ archivos)
        +-> BACKEND_INVENTORY.yml (4+ archivos)
        +-> FRONTEND_INVENTORY.yml (4+ archivos)
```

### 4.5 A5: SIMCO-TESTING.md

```
SIMCO-TESTING.md
    |
    +-> DEPENDE DE:
    |   +-> Ninguna directiva nueva
    |   +-> SIMCO-BACKEND.md (existente)
    |   +-> SIMCO-FRONTEND.md (existente)
    |
    +-> DEPENDIENTES DIRECTOS:
    |   +-> Ninguno directo
    |
    +-> IMPACTO EN:
        +-> CI/CD pipelines de todos los proyectos
        +-> package.json scripts de testing
        +-> Configuracion pytest/jest
```

### 4.6 A6: SIMCO-MIGRACIONES-BD.md

```
SIMCO-MIGRACIONES-BD.md
    |
    +-> DEPENDE DE:
    |   +-> SIMCO-DDL.md (existente)
    |
    +-> DEPENDIENTES DIRECTOS:
    |   +-> Ninguno nuevo
    |
    +-> IMPACTO EN:
        +-> scripts de migracion en todos los proyectos
        +-> Estructura de apps/database/
        +-> Procesos de deployment
```

### 4.7 A7: SIMCO-INTEGRACIONES-EXTERNAS.md

```
SIMCO-INTEGRACIONES-EXTERNAS.md
    |
    +-> DEPENDE DE:
    |   +-> Ninguna directiva nueva
    |
    +-> DEPENDIENTES DIRECTOS:
    |   +-> B5: TEMPLATE-INTEGRACION-EXTERNA.md
    |
    +-> IMPACTO EN:
        +-> Documentacion de APIs externas
        +-> Variables de entorno
        +-> Manejo de credenciales
```

---

## 5. ORDEN DE CREACION BASADO EN DEPENDENCIAS

### Nivel 0 - Sin Dependencias (Paralelo)

| ID | Directiva | Puede empezar |
|----|-----------|---------------|
| A1 | SIMCO-DOCUMENTACION-PROYECTO.md | Inmediato |
| A5 | SIMCO-TESTING.md | Inmediato |
| A7 | SIMCO-INTEGRACIONES-EXTERNAS.md | Inmediato |

### Nivel 1 - Depende de Nivel 0

| ID | Directiva | Requiere |
|----|-----------|----------|
| A2 | SIMCO-NOMENCLATURA.md | A1 completado |
| A4 | SIMCO-INVENTARIOS.md | A1 completado |
| A6 | SIMCO-MIGRACIONES-BD.md | SIMCO-DDL existente |
| B5 | TEMPLATE-INTEGRACION-EXTERNA.md | A7 completado |

### Nivel 2 - Depende de Nivel 1

| ID | Archivo | Requiere |
|----|---------|----------|
| A3 | SIMCO-ESTRUCTURA-DOCS.md | A1, A2 completados |
| B3 | TEMPLATE-MAP-INDICE.md | A2 completado |
| B4 | TEMPLATE-INVENTARIO-PROYECTO.md | A4 completado |
| C2 | CHECKLIST-INVENTARIOS.md | A4 completado |
| C3 | CHECKLIST-NOMENCLATURA.md | A2 completado |

### Nivel 3 - Depende de Nivel 2

| ID | Archivo | Requiere |
|----|---------|----------|
| B1 | TEMPLATE-EPICA-ESTANDAR.md | A3 completado |
| B2 | TEMPLATE-MODULO-ESTANDAR.md | A3 completado |
| C1 | CHECKLIST-DOCUMENTACION-PROYECTO.md | A1, A2, A3 completados |

### Nivel 4 - Indices (Despues de todo lo anterior)

| ID | Archivo | Requiere |
|----|---------|----------|
| D1 | INDICE-DIRECTIVAS-WORKSPACE.yml | A1-A7, B1-B5, C1-C3 |
| D2 | orchestration/directivas/simco/_MAP.md | A1-A7 |
| D3 | orchestration/templates/_MAP.md | B1-B5 |
| D4 | orchestration/checklists/_MAP.md | C1-C3 |
| D5 | shared/knowledge-base/standards/ | Todos anteriores |

### Nivel 5 - Propagacion a Proyectos

| ID | Archivo | Requiere |
|----|---------|----------|
| E1 | gamilit/HERENCIA-SIMCO.md | D1-D5 |
| E2 | erp-core/HERENCIA-SIMCO.md | D1-D5 |
| E3 | michangarrito/HERENCIA-SIMCO.md | D1-D5 (CREAR) |
| E4 | template-saas/HERENCIA-SIMCO.md | D1-D5 |
| E5-E19 | Demas proyectos | D1-D5 |

---

## 6. ARCHIVOS EXISTENTES QUE REFERENCIAN DIRECTIVAS

### 6.1 Archivos con Referencias Explicitas a SIMCO

| Tipo | Patron | Cantidad | Ubicacion |
|------|--------|----------|-----------|
| Planes | PLAN-*.md | 60+ | orchestration/analisis/ |
| Analisis | ANALISIS-*.md | 50+ | orchestration/analisis/ |
| Trazas | TRAZA-*.md | 20+ | orchestration/trazas/ |
| Contexto | CONTEXTO-PROYECTO.md | 19 | projects/*/orchestration/ |
| Herencia | HERENCIA-*.md | 50+ | projects/*/orchestration/ |

### 6.2 Archivos de Configuracion

| Archivo | Ubicacion | Referencias SIMCO |
|---------|-----------|-------------------|
| CONTEXT-MAP.yml | projects/*/orchestration/ | 5+ |
| PROJECT-STATUS.md | projects/*/orchestration/ | 19 |
| PROXIMA-ACCION.md | projects/*/orchestration/ | 10+ |

---

## 7. IMPACTO EN PERFILES DE AGENTES

### 7.1 Perfiles a Actualizar

| Perfil | Directivas Nuevas Relevantes | Accion |
|--------|------------------------------|--------|
| PERFIL-DOCUMENTATION.md | A1, A2, A3 | AGREGAR referencias |
| PERFIL-ANALYST.md | A1, A2, C1, C3 | AGREGAR referencias |
| PERFIL-BACKEND.md | A5, A6 | AGREGAR referencias |
| PERFIL-DATABASE.md | A6 | AGREGAR referencias |
| PERFIL-FRONTEND.md | A5 | AGREGAR referencias |
| PERFIL-DEVOPS.md | A5, A6 | AGREGAR referencias |
| PERFIL-QA.md | A5, C1, C2, C3 | AGREGAR referencias |

### 7.2 Nuevos Aliases Requeridos

```yaml
# Agregar a orchestration/agents/ALIASES.yml

@DOC_PROYECTO: SIMCO-DOCUMENTACION-PROYECTO.md
@NOMENCLATURA: SIMCO-NOMENCLATURA.md
@ESTRUCTURA_DOCS: SIMCO-ESTRUCTURA-DOCS.md
@INVENTARIOS: SIMCO-INVENTARIOS.md
@TESTING: SIMCO-TESTING.md
@MIGRACIONES: SIMCO-MIGRACIONES-BD.md
@INTEGRACIONES: SIMCO-INTEGRACIONES-EXTERNAS.md
```

---

## 8. RIESGOS Y MITIGACIONES

### 8.1 Riesgos Identificados

| Riesgo | Probabilidad | Impacto | Mitigacion |
|--------|--------------|---------|------------|
| Inconsistencia en propagacion | MEDIA | ALTO | Usar checklist de propagacion |
| Conflicto con directivas existentes | BAJA | MEDIO | Validacion previa completada |
| Olvidar actualizar algun proyecto | MEDIA | ALTO | Automatizar via script |
| Romper herencia existente | BAJA | ALTO | No modificar estructura, solo agregar |

### 8.2 Dependencias Criticas

| Dependencia | Tipo | Validacion |
|-------------|------|------------|
| SIMCO-DDL.md | Existente | OK - referenciada por A6 |
| SIMCO-BACKEND.md | Existente | OK - referenciada por A5 |
| SIMCO-FRONTEND.md | Existente | OK - referenciada por A5 |
| Estructura /orchestration | Existente | OK - no se modifica |

---

## 9. PROCEDIMIENTO DE ACTUALIZACION

### 9.1 Para Cada Nueva Directiva

```
1. Crear archivo en /orchestration/directivas/simco/SIMCO-{NAME}.md

2. Agregar a INDICE-DIRECTIVAS-WORKSPACE.yml:
   - Entrada en seccion apropiada
   - Actualizar version
   - Agregar a changelog

3. Agregar alias en orchestration/agents/ALIASES.yml

4. Actualizar orchestration/templates/HERENCIA-SIMCO.md

5. Actualizar orchestration/directivas/simco/_MAP.md

6. Si afecta dominio especifico: actualizar PERFIL-{domain}.md

7. Propagar a 19 instancias de HERENCIA-SIMCO.md en proyectos
```

### 9.2 Verificacion Post-Actualizacion

```
- [ ] INDICE-DIRECTIVAS-WORKSPACE.yml version incrementada
- [ ] Alias resuelve correctamente
- [ ] Template HERENCIA-SIMCO.md tiene referencia
- [ ] _MAP.md de directivas actualizado
- [ ] Proyectos criticos (gamilit, erp-core) actualizados
- [ ] Build/lint pasa en proyectos afectados
```

---

## 10. RESUMEN DE ARCHIVOS A MODIFICAR/CREAR

### Crear (20 archivos)

| Bloque | Archivos | Ubicacion |
|--------|----------|-----------|
| A | 7 directivas | /orchestration/directivas/simco/ |
| B | 5 templates | /orchestration/templates/ |
| C | 3 checklists | /orchestration/checklists/ |
| D | 1 _MAP.md | /orchestration/checklists/ |

### Modificar (30+ archivos)

| Archivo | Ubicacion | Tipo Cambio |
|---------|-----------|-------------|
| INDICE-DIRECTIVAS-WORKSPACE.yml | /orchestration/ | Agregar entradas |
| ALIASES.yml | /orchestration/agents/ | Agregar 7 aliases |
| HERENCIA-SIMCO.md | /orchestration/templates/ | Agregar referencias |
| _MAP.md | /orchestration/directivas/simco/ | Agregar 7 entradas |
| _MAP.md | /orchestration/templates/ | Agregar 5 entradas |
| orchestration/README.md | /orchestration/ | Actualizar overview |
| 7 PERFIL-*.md | /orchestration/agents/perfiles/ | Agregar referencias |
| 19 HERENCIA-SIMCO.md | /projects/*/orchestration/ | Propagar |

---

**Documento generado:** 2026-01-10
**Resultado:** DEPENDENCIAS MAPEADAS
**Siguiente fase:** REFINAMIENTO DEL PLAN