cb4c0681d3
New projects created: - michangarrito (marketplace mobile) - template-saas (SaaS template) - clinica-dental (dental ERP) - clinica-veterinaria (veterinary ERP) Architecture updates: - Move catalog from core/ to shared/ - Add MCP servers structure and templates - Add git management scripts - Update SUBREPOSITORIOS.md with 15 new repos - Update .gitignore for new projects Repository infrastructure: - 4 main repositories - 11 subrepositorios - Gitea remotes configured 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
8.8 KiB
8.8 KiB
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:
- Propagacion por niveles jerarquicos
- Generacion automatica de tareas SCRUM
- Coordinacion entre agentes
- 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.
# 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.
# 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.
# 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.
# 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.
# 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 shared/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 <PROP-ID> |
| |
| Actualiza: |
| - REGISTRO-PROPAGACIONES.yml |
| - TRAZABILIDAD-PROYECTOS.yml |
| |
| Cierra propagacion |
+-------------------------------------------------------------------+
Estructura de Niveles
Nivel 0: shared/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
---
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
# 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"
# Verificar que el modulo existe
grep "nombre:" /home/isem/workspace-v1/shared/knowledge-base/CATALOGO-MODULOS.yml | grep "<modulo>"
Error: "No se encontraron proyectos que usen el modulo"
# Verificar trazabilidad
grep -A10 "<modulo>" /home/isem/workspace-v1/shared/knowledge-base/TRAZABILIDAD-PROYECTOS.yml
Validacion falla por archivos faltantes
# 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