template-saas/orchestration/_archive/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:**
   ```bash
   ls -la .backups/backup-docs-orchestration-2026-01-10.tar.gz
   ```

2. **Crear punto de restauracion git:**
   ```bash
   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:**
   ```bash
   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