template-saas/orchestration/analisis/ANALISIS-RIESGOS-REESTRUCTURACION.md

Analisis de Riesgos de Reestructuracion

Fecha: 2026-01-10 Fase: 5.3 - Revision de Riesgos Estado: COMPLETADO

---

Matriz de Riesgos

#	Riesgo	Probabilidad	Impacto	Score	Mitigacion
R1	Perdida de informacion critica	Baja	Alto	6	Backup, archivar no eliminar
R2	Referencias rotas post-cambio	Media	Alto	9	Validacion exhaustiva
R3	Inconsistencias numeracion	Media	Alto	9	Actualizar en paralelo
R4	Conflictos git al mover	Baja	Medio	4	Usar git mv
R5	Informacion duplicada persiste	Baja	Bajo	2	Revision manual
R6	Indices incompletos	Baja	Medio	4	Checklist de archivos

---

Detalle de Riesgos

R1: Perdida de Informacion Critica

Probabilidad: Baja Impacto: Alto Score: 6/15

Descripcion: Al archivar o consolidar documentos, se podria perder informacion importante no detectada en el analisis.

Mitigaciones:

1. Backup completo antes de cualquier cambio (.backups/)
2. Politica de ARCHIVAR en lugar de ELIMINAR
3. Mantener enlaces a documentos archivados
4. Revision manual de cada archivo antes de mover

Criterio de Rollback: Si se detecta perdida de informacion critica, restaurar desde backup.

---

R2: Referencias Rotas Post-Cambio

Probabilidad: Media Impacto: Alto Score: 9/15

Descripcion: Al mover archivos o actualizar rutas, algunas referencias podrian quedar rotas si no se actualizan todas.

Mitigaciones:

1. Script de validacion de enlaces (grep)
2. Actualizar referencias ANTES de mover archivos
3. Ejecutar validacion despues de cada fase
4. Mantener lista de archivos con referencias entrantes

Criterio de Rollback: Si referencias rotas > 5%, pausar y corregir antes de continuar.

---

R3: Inconsistencias en Numeracion

Probabilidad: Media Impacto: Alto Score: 9/15

Descripcion: La actualizacion de numeracion SAAS-006 a SAAS-014 debe hacerse en multiples archivos. Si no se actualiza todo, habra inconsistencias.

Mitigaciones:

1. Lista completa de archivos a actualizar
2. Actualizar todos en la misma fase
3. Validacion con grep post-cambio
4. Usar buscar/reemplazar consistente

Archivos a actualizar:

• docs/_MAP.md
• orchestration/CONTEXT-MAP.yml
• orchestration/PROJECT-STATUS.md (si aplica)

Criterio de Rollback: Si grep encuentra numeracion inconsistente, revertir y corregir.

---

R4: Conflictos Git al Mover

Probabilidad: Baja Impacto: Medio Score: 4/15

Descripcion: Al mover archivos con git mv, podria haber conflictos si hay cambios no committed.

Mitigaciones:

1. Commit de trabajo actual antes de reestructurar
2. Usar git mv para preservar historial
3. Hacer cambios en rama separada si es necesario
4. Commits atomicos por fase

Criterio de Rollback: Si git mv falla, git checkout para restaurar.

---

R5: Informacion Duplicada Persiste

Probabilidad: Baja Impacto: Bajo Score: 2/15

Descripcion: Despues de la consolidacion, podria quedar contenido duplicado no detectado.

Mitigaciones:

1. Revision manual de archivos consolidados
2. Comparacion de contenido antes/despues
3. Validacion de FASE 7

Criterio de Aceptacion: Duplicacion residual < 10% es aceptable.

---

R6: Indices Incompletos

Probabilidad: Baja Impacto: Medio Score: 4/15

Descripcion: Los nuevos indices (_INDEX.md) podrian no incluir todos los archivos relevantes.

Mitigaciones:

1. Checklist de archivos por directorio
2. ls -la para verificar contenido
3. Revision cruzada con INVENTARIO-ARCHIVOS-HUERFANOS.md

Criterio de Aceptacion: 100% de archivos .md referenciados en algun indice.

---

Plan de Contingencia

Antes de Ejecutar FASE 6

1. Verificar backup existe:

   ls -la .backups/backup-docs-orchestration-2026-01-10.tar.gz
   

2. Crear punto de restauracion git:

   git stash  # si hay cambios
   git tag pre-restructure-2026-01-10
   

Durante FASE 6

1. Pausar si:

   • Referencias rotas > 5%
   • Error en git mv
   • Archivo no encontrado

2. Validar despues de cada subfase:

   • Ejecutar grep de validacion
   • Verificar archivos movidos existen

Despues de FASE 6

1. Validacion completa (FASE 7)
2. Si falla validacion:

   git checkout pre-restructure-2026-01-10
   # O restaurar desde backup
   

---

Criterios de Rollback Global

Condicion	Accion
Referencias rotas > 5%	Pausar, corregir, o rollback
Archivo critico perdido	Rollback inmediato
Numeracion inconsistente	Corregir antes de continuar
Build/tests fallan	Rollback y analizar

---

Resumen de Riesgos

Nivel	Cantidad	Riesgos
Alto (>8)	2	R2, R3
Medio (5-8)	1	R1
Bajo (<5)	3	R4, R5, R6

Riesgo Total: MANEJABLE con mitigaciones implementadas

---

Recomendaciones Finales

1. Ejecutar FASE 6 en subfases para validar incrementalmente
2. No eliminar archivos - solo archivar
3. Validar con grep despues de cada cambio critico
4. Mantener backup accesible durante toda la ejecucion
5. Documentar cada cambio en commits atomicos

---

Entregable de: FASE 5.3