# CHECKLIST DE PROPAGACION

**Version:** 1.0.0
**Sistema:** SIMCO v2.2.0
**Proposito:** Verificar propagacion completa de documentacion entre niveles

---

## CUANDO USAR ESTE CHECKLIST

Ejecutar este checklist DESPUES de completar cualquier tarea que:
- Crea archivos nuevos (DDL, Entity, Component)
- Modifica estructura existente
- Documenta especificaciones
- Completa una HU

---

## CHECKLIST POR NIVEL

### Nivel 2A: Proyecto Standalone

```markdown
## Propagacion - Proyecto Standalone

### Nivel Local (Obligatorio)
- [ ] Inventario actualizado
  - [ ] MASTER_INVENTORY.yml con nuevo artefacto
  - [ ] {CAPA}_INVENTORY.yml actualizado (DATABASE/BACKEND/FRONTEND)
- [ ] Traza registrada
  - [ ] TRAZA-TAREAS-{CAPA}.md con entrada de hoy
- [ ] PROXIMA-ACCION.md actualizado (si aplica)

### Nivel Workspace (Obligatorio)
- [ ] workspace/orchestration/WORKSPACE-STATUS.md
  - [ ] Seccion del proyecto actualizada
  - [ ] Fecha de ultima actividad correcta
- [ ] workspace/orchestration/referencias/PROYECTOS-ACTIVOS.yml
  - [ ] ultima_actividad actualizada (si cambio significativo)

### Validacion
- [ ] Todas las rutas verificadas (archivos existen)
- [ ] Fechas consistentes entre archivos
- [ ] Build pasa (si aplica)
- [ ] No hay referencias rotas
```

---

### Nivel 2B.2: Vertical (en Suite)

```markdown
## Propagacion - Vertical en Suite

### Nivel Local - Vertical (Obligatorio)
- [ ] Inventario actualizado
  - [ ] MASTER_INVENTORY.yml con nuevo artefacto
  - [ ] {CAPA}_INVENTORY.yml actualizado
- [ ] Traza registrada
  - [ ] TRAZA-TAREAS-{CAPA}.md con entrada de hoy

### Nivel Suite (Obligatorio)
- [ ] projects/{suite}/orchestration/inventarios/
  - [ ] SUITE_MASTER_INVENTORY.yml actualizado
  - [ ] STATUS.yml con estado del vertical
  - [ ] REFERENCIAS.yml con puntero al artefacto
- [ ] projects/{suite}/orchestration/trazas/
  - [ ] TRAZA-SUITE.md con entrada de propagacion

### Nivel Workspace (Obligatorio)
- [ ] workspace/orchestration/WORKSPACE-STATUS.md
  - [ ] Seccion de suite actualizada
  - [ ] Metricas de vertical actualizadas

### Validacion
- [ ] Ruta completa verificada (vertical → suite → workspace)
- [ ] No hay duplicacion de contenido (solo referencias)
- [ ] Fechas consistentes
```

---

### Nivel 2B.1: Suite Core

```markdown
## Propagacion - Suite Core

### Nivel Local - Core (Obligatorio)
- [ ] Inventario actualizado
  - [ ] MASTER_INVENTORY.yml con artefacto
  - [ ] CORE_{CAPA}_INVENTORY.yml actualizado
- [ ] Traza registrada
  - [ ] TRAZA-CORE.md con entrada

### Nivel Suite (Obligatorio)
- [ ] projects/{suite}/orchestration/inventarios/
  - [ ] SUITE_MASTER_INVENTORY.yml seccion core actualizada
  - [ ] STATUS.yml con estado del core
- [ ] projects/{suite}/orchestration/trazas/
  - [ ] TRAZA-SUITE.md con entrada

### Notificar Verticales (Si aplica)
- [ ] Si el cambio afecta a verticales:
  - [ ] Notificar en SUITE_MASTER_INVENTORY.yml
  - [ ] Marcar como "NUEVO - Revisar herencia"

### Nivel Workspace (Obligatorio)
- [ ] workspace/orchestration/WORKSPACE-STATUS.md actualizado

### Validacion
- [ ] Verticales pueden encontrar el nuevo artefacto
- [ ] Referencias no estan rotas
```

---

### Nivel 3: Catalogo

```markdown
## Propagacion - Catalogo de Funcionalidades

### Nivel Local - Catalogo (Obligatorio)
- [ ] core/catalog/{funcionalidad}/ actualizado
- [ ] CATALOG-INDEX.yml actualizado
- [ ] README.md de funcionalidad actualizado

### Nivel Core (Obligatorio)
- [ ] core/orchestration/inventarios/ actualizado
- [ ] Entrada en CATALOG-USAGE-TRACKING.yml

### Notificar Consumidores (Si aplica)
- [ ] Si hay proyectos usando esta funcionalidad:
  - [ ] Notificar cambio en CATALOG-USAGE-TRACKING.yml
  - [ ] Marcar version nueva

### Nivel Workspace (Obligatorio)
- [ ] workspace/orchestration/WORKSPACE-STATUS.md
  - [ ] Seccion de catalogo actualizada

### Validacion
- [ ] Funcionalidad es accesible via @CATALOG
- [ ] Consumidores pueden encontrar nueva version
```

---

## FORMATO DE REGISTRO EN TRAZAS

### Entrada de Traza Local

```markdown
## [{fecha}] {codigo_tarea}: {descripcion_breve}

**Agente:** {nombre_agente}
**Tipo:** {CREAR|MODIFICAR|DOCUMENTAR}
**Prioridad:** {P0|P1|P2}

### Objetivo
{descripcion_de_lo_que_se_hizo}

### Archivos Afectados
- {ruta_archivo_1}
- {ruta_archivo_2}

### Impacto
- {impacto_1}
- {impacto_2}

### Propagado a
- [ ] Nivel superior: {si/no}
- [ ] Archivo: {ruta_si_aplica}
```

### Entrada de Traza de Suite

```markdown
## [{fecha}] {origen}: {descripcion}

**Nivel:** {2B.1|2B.2}
**Vertical/Core:** {nombre}
**Capa:** {DATABASE|BACKEND|FRONTEND}

### Propagacion
- **Origen:** {ruta_completa_archivo_original}
- **Tipo:** {Nuevo|Actualizado|Eliminado}
- **Impacto en suite:** {descripcion}

### Accion Requerida
- [ ] Ninguna (informativo)
- [ ] Verticales deben revisar herencia
- [ ] Actualizar dependencias
```

---

## ERRORES COMUNES

### Error 1: Inventario no actualizado

```yaml
Sintoma: Artefacto creado pero no aparece en busquedas
Causa: MASTER_INVENTORY.yml no incluye el nuevo artefacto
Solucion: Siempre actualizar inventario INMEDIATAMENTE despues de crear
```

### Error 2: Traza sin entrada

```yaml
Sintoma: No hay registro de cuando se creo algo
Causa: Olvidar registrar en TRAZA-TAREAS-*.md
Solucion: Agregar entrada antes de marcar tarea como Done
```

### Error 3: Propagacion parcial

```yaml
Sintoma: Nivel local OK pero nivel superior no sabe del cambio
Causa: Solo actualizar nivel local
Solucion: SIEMPRE propagar a TODOS los niveles en PROPAGATE_TO
```

### Error 4: Duplicacion de contenido

```yaml
Sintoma: Mismo contenido en multiples archivos
Causa: Copiar en lugar de referenciar
Solucion: Usar REFERENCIAS.yml con punteros, no copiar contenido
```

### Error 5: Fechas inconsistentes

```yaml
Sintoma: Archivo dice 2025-12-07 pero traza dice 2025-12-08
Causa: No sincronizar fechas
Solucion: Usar misma fecha en todos los archivos relacionados
```

---

## VALIDACION AUTOMATICA (Conceptual)

```bash
# Script futuro para validar propagacion
./validate-propagation.sh

Verifica:
  ✓ Inventarios tienen artefactos recientes
  ✓ Trazas tienen entradas de hoy
  ✓ Referencias apuntan a archivos existentes
  ✓ Fechas son consistentes
  ✓ No hay duplicacion de contenido
  ✓ Niveles superiores tienen referencias

Output:
  PASS: Propagacion completa
  FAIL: Lista de gaps encontrados
```

---

## QUICK REFERENCE

```
┌─────────────────────────────────────────────────────────────────────┐
│                 PROPAGACION OBLIGATORIA                              │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  DESPUES de crear/modificar artefacto:                              │
│                                                                      │
│  1. NIVEL LOCAL:                                                    │
│     - [ ] Actualizar MASTER_INVENTORY.yml                           │
│     - [ ] Registrar en TRAZA-TAREAS-{CAPA}.md                       │
│                                                                      │
│  2. NIVEL SUPERIOR (para cada nivel en PROPAGATE_TO):               │
│     - [ ] Agregar referencia (NO copiar contenido)                  │
│     - [ ] Actualizar STATUS.yml                                     │
│     - [ ] Registrar en traza superior                               │
│                                                                      │
│  3. VALIDAR:                                                        │
│     - [ ] Rutas existen                                             │
│     - [ ] Fechas consistentes                                       │
│     - [ ] No hay duplicacion                                        │
│     - [ ] Build pasa                                                │
│                                                                      │
│  REGLA DE ORO:                                                      │
│  "Si no esta en inventario, no existe para otros agentes"           │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘
```

---

## REFERENCIAS

- `SIMCO-PROPAGACION.md` - Protocolo completo de propagacion
- `SIMCO-NIVELES.md` - Definicion de niveles jerarquicos
- `SIMCO-DOCUMENTAR.md` - Directivas de documentacion

---

*Sistema SIMCO v2.2.0*
*Creado: 2025-12-08*
