# USAGE: Orquestacion Avanzada de Propagacion **Version:** 1.0.0 **Sistema:** NEXUS v3.4 + SIMCO + CAPVED **EPIC:** EPIC-012 **Fecha:** 2026-01-04 --- ## Proposito Este documento describe como usar el sistema de orquestacion avanzada de propagacion implementado en EPIC-012. El sistema permite: 1. Propagacion por niveles jerarquicos 2. Generacion automatica de tareas SCRUM 3. Coordinacion entre agentes 4. Validacion de integridad --- ## Componentes del Sistema ### Archivos de Configuracion | Archivo | Ubicacion | Proposito | |---------|-----------|-----------| | NIVELES-PROPAGACION.yml | propagacion/ | Define jerarquia de niveles | | PROTOCOLO-COORDINACION.yml | propagacion/ | Define flujo entre agentes | | PERFIL-KB-MANAGER.md | core/orchestration/agents/perfiles/ | Perfil del agente coordinador | ### Scripts | Script | Ubicacion | Proposito | |--------|-----------|-----------| | propagate-module-update.sh | devtools/scripts/propagation/ | Iniciar propagacion | | generate-scrum-tasks.sh | devtools/scripts/propagation/ | Generar tareas SCRUM | | cascade-propagation.sh | devtools/scripts/propagation/ | Propagacion por niveles | | validate-propagation-chain.sh | devtools/scripts/propagation/ | Validar integridad | --- ## Casos de Uso ### Caso 1: Propagacion Simple **Escenario:** Correcion de bug en modulo `auth-jwt-nestjs` desde proyecto `gamilit`. ```bash # 1. Ejecutar propagacion basica cd /home/isem/workspace-v1/devtools/scripts/propagation ./propagate-module-update.sh auth-jwt-nestjs 2.2.0 gamilit # 2. Revisar output y tareas generadas # 3. Ejecutar en cada proyecto destino manualmente ``` --- ### Caso 2: Propagacion con Tareas SCRUM **Escenario:** Nueva feature que debe propagarse a multiples proyectos con tracking formal. ```bash # 1. Generar tareas SCRUM ./propagate-module-update.sh stripe-payments 3.0.0 trading-platform --scrum --tipo feature # 2. O con EPIC contenedora ./propagate-module-update.sh stripe-payments 3.0.0 trading-platform --scrum --scrum-epic --tipo feature # 3. Revisar tareas en ./propagacion-tasks/ ls ./propagacion-tasks/ # EPIC-PROP-2026-001.md # TASK-PROP-2026-001-gamilit.md # TASK-PROP-2026-001-erp-core.md ``` --- ### Caso 3: Propagacion en Cascada **Escenario:** Actualizacion que debe ir de core a todos los niveles. ```bash # 1. Ejecutar cascada completa (niveles 0-3) ./cascade-propagation.sh websocket-client 1.5.0 # 2. O empezar desde nivel 1 (si ya esta actualizado en core) ./cascade-propagation.sh websocket-client 1.5.0 --start-level 1 # 3. Detener en nivel 2 (no propagar a verticales) ./cascade-propagation.sh websocket-client 1.5.0 --stop-level 2 ``` --- ### Caso 4: Security Fix Urgente **Escenario:** Vulnerabilidad critica que debe propagarse en menos de 24h. ```bash # 1. Propagacion con maxima prioridad ./propagate-module-update.sh auth-jwt-nestjs 2.2.1 gamilit \ --scrum --scrum-epic \ --tipo security-fix \ --cascade # 2. Verificar tareas generadas cat ./propagacion-tasks/EPIC-PROP-*.md # 3. Asignar inmediatamente a @PERFIL_PROJECT_AGENT # 4. Validar cuando completen ./validate-propagation-chain.sh PROP-2026-XXX ``` --- ### Caso 5: Validacion Post-Propagacion **Escenario:** Verificar que una propagacion se completo correctamente. ```bash # 1. Validar propagacion especifica ./validate-propagation-chain.sh PROP-2026-001 # 2. Ver ultima propagacion ./validate-propagation-chain.sh --last # 3. Listar todas las propagaciones ./validate-propagation-chain.sh --all ``` --- ## Flujo Completo de Orquestacion ``` +-------------------+ | Desarrollador | | detecta mejora | +--------+----------+ | v +-------------------------------------------------------------------+ | @KB_MANAGER | | | | 1. Recibe notificacion | | 2. Carga contexto (SIMCO-PROPAGACION-MEJORAS.md) | | 3. Analiza con CAPVED | | 4. Decide: Propagar / No propagar | | | | Si propagar: | | - Actualiza core/catalog (nivel 0) | | - Sincroniza knowledge-base (nivel 1) | | - Genera tareas SCRUM | | - Notifica a @PROJECT_AGENT | +-------------------------------------------------------------------+ | +--------------+---------------+ | | v v +-------------------------+ +-------------------------+ | @PROJECT_AGENT | | @PROJECT_AGENT | | (Proyecto A) | | (Proyecto B) | | | | | | 1. Recibe tarea SCRUM | | 1. Recibe tarea SCRUM | | 2. Ejecuta propagacion | | 2. Ejecuta propagacion | | 3. Valida (build+tests) | | 3. Valida (build+tests) | | 4. Reporta a KB_MANAGER | | 4. Reporta a KB_MANAGER | +-------------------------+ +-------------------------+ | | +--------------+---------------+ | v +-------------------------------------------------------------------+ | @KB_MANAGER | | | | Validacion final: | | ./validate-propagation-chain.sh | | | | Actualiza: | | - REGISTRO-PROPAGACIONES.yml | | - TRAZABILIDAD-PROYECTOS.yml | | | | Cierra propagacion | +-------------------------------------------------------------------+ ``` --- ## Estructura de Niveles ``` Nivel 0: core/catalog/ | v (propaga a) Nivel 1: shared/knowledge-base/ | v (propaga a) Nivel 2: projects/ (base) |-- gamilit |-- trading-platform |-- erp-core | v (propaga a) Nivel 3: projects/ (hoja) |-- erp-suite/verticales/* |-- betting-analytics |-- inmobiliaria-analytics ``` --- ## Formato de Tarea SCRUM Generada ```markdown --- id: TASK-PROP-2026-001-gamilit title: "Propagar auth-jwt-nestjs v2.2.0 a gamilit" type: Task status: "To Do" priority: Alta assignee: "@PERFIL_PROJECT_AGENT" parent: "EPIC-PROP-2026-001" --- # TASK: Propagar auth-jwt-nestjs v2.2.0 a gamilit ## Descripcion Actualizar el modulo `auth-jwt-nestjs` a la version `2.2.0`. ## Pasos de Implementacion 1. [ ] Verificar version actual 2. [ ] Actualizar dependencia 3. [ ] Ejecutar build 4. [ ] Ejecutar tests 5. [ ] Commit con referencia ## Criterios de Aceptacion - [ ] Modulo actualizado - [ ] Build exitoso - [ ] Tests pasando ``` --- ## Comandos Rapidos ```bash # Ver ayuda de cualquier script ./propagate-module-update.sh --help ./generate-scrum-tasks.sh --help ./cascade-propagation.sh --help ./validate-propagation-chain.sh --help # Dry-run (simular sin cambios) ./propagate-module-update.sh modulo version origen --dry-run ./cascade-propagation.sh modulo version --dry-run ./generate-scrum-tasks.sh modulo version tipo --dry-run ``` --- ## Troubleshooting ### Error: "Modulo no encontrado en catalogo" ```bash # Verificar que el modulo existe grep "nombre:" /home/isem/workspace-v1/shared/knowledge-base/CATALOGO-MODULOS.yml | grep "" ``` ### Error: "No se encontraron proyectos que usen el modulo" ```bash # Verificar trazabilidad grep -A10 "" /home/isem/workspace-v1/shared/knowledge-base/TRAZABILIDAD-PROYECTOS.yml ``` ### Validacion falla por archivos faltantes ```bash # Verificar estructura ls -la /home/isem/workspace-v1/shared/knowledge-base/propagacion/ ls -la /home/isem/workspace-v1/devtools/scripts/propagation/ ``` --- ## Referencias | Alias | Archivo | |-------|---------| | @PROPAGACION | core/orchestration/directivas/simco/SIMCO-PROPAGACION-MEJORAS.md | | @KB_MANAGER | core/orchestration/agents/perfiles/PERFIL-KB-MANAGER.md | | @NIVELES_PROP | shared/knowledge-base/propagacion/NIVELES-PROPAGACION.yml | | @PROTOCOLO_PROP | shared/knowledge-base/propagacion/PROTOCOLO-COORDINACION.yml | | @USAGE_PROP | shared/knowledge-base/propagacion/USAGE.md | --- **Documento creado por:** EPIC-012 **Sistema:** NEXUS v3.4 + SIMCO + CAPVED