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