workspace-v1/orchestration/checklists/CHECKLIST-PROPAGACION.md

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

## 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)

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

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

## Propagacion - Catalogo de Funcionalidades

### Nivel Local - Catalogo (Obligatorio)
- [ ] shared/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

## [{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

## [{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

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

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

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

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

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)

# 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