# PURGE-PLAN.md
## Plan de Purga de Documentación Obsoleta

**Proyecto:** trading-platform
**Fecha:** 2026-01-25
**Objetivo:** Eliminar documentación duplicada, obsoleta o completada para mantener limpieza

---

## Criterios de Purga

### Candidatos para Eliminación

1. **Tareas Completadas >30 días**
   - Estado: completada
   - Sin referencias activas
   - Información ya integrada en docs/

2. **Documentación Duplicada**
   - Contenido replicado en múltiples ubicaciones
   - Mantener SSOT (Single Source of Truth)

3. **Definiciones Obsoletas**
   - User stories implementadas 100%
   - Specs reemplazadas por código actual

4. **Archivos Temporales**
   - Drafts sin finalizar
   - Notas de trabajo antiguas

---

## Tareas Completadas - Candidatos

| Tarea | Fecha Completada | Ubicación | Acción | Justificación |
|-------|------------------|-----------|--------|---------------|
| TASK-2026-01-25-FRONTEND-ANALYSIS | 2026-01-25 | orchestration/tareas/ | ⚠️ CONSERVAR | Análisis base, referencia histórica |
| TASK-2026-01-25-PHASE1-MVP | En progreso | orchestration/tareas/ | ✅ CONSERVAR | Activa |
| TASK-2026-01-25-NOTIFICACIONES-COMPLETAS | En progreso | orchestration/tareas/ | ✅ CONSERVAR | Activa |
| TASK-2026-01-25-ML-DATA-MIGRATION | En progreso | orchestration/tareas/ | ✅ CONSERVAR | Activa |

**Resultado:** NO HAY tareas completadas obsoletas (todas recientes o activas)

---

## Documentación Duplicada - Análisis

### 1. Análisis de Componentes por Epic

| Documento Nuevo (TASK-002) | Documento Previo | Acción |
|----------------------------|------------------|--------|
| orchestration/analisis/OQI-001-ANALISIS-COMPONENTES.md | NINGUNO | ✅ CONSERVAR (único) |
| orchestration/analisis/OQI-002-* (8 docs) | TASK-FRONTEND-ANALYSIS/OQI-002 docs? | ⚠️ VERIFICAR si hay overlap |
| orchestration/analisis/OQI-003-* (6 docs) | NINGUNO | ✅ CONSERVAR |
| orchestration/analisis/OQI-004-* (5 docs) | NINGUNO | ✅ CONSERVAR |
| orchestration/analisis/OQI-005-* (5 docs) | NINGUNO | ✅ CONSERVAR |
| orchestration/analisis/OQI-006-* (5 docs) | NINGUNO | ✅ CONSERVAR |
| orchestration/analisis/OQI-007-* (4 docs) | NINGUNO | ✅ CONSERVAR |
| orchestration/analisis/OQI-008-* (6 docs) | NINGUNO | ✅ CONSERVAR |
| orchestration/analisis/OQI-009-* (4 docs) | NINGUNO | ✅ CONSERVAR |

**Conclusión:** NO HAY duplicación significativa. Los análisis de TASK-002 son complementarios.

### 2. Especificaciones Técnicas (ET-*)

| Ubicación | Cantidad | Estado | Acción |
|-----------|----------|--------|--------|
| docs/02-definicion-modulos/OQI-001/especificaciones/ | 5 (ET-AUTH-*) | ✅ Actualizados | CONSERVAR |
| docs/02-definicion-modulos/OQI-002/especificaciones/ | 6 (ET-EDU-*) | ✅ Actualizados | CONSERVAR |
| docs/02-definicion-modulos/OQI-003/especificaciones/ | 8 (ET-TRD-*) | ✅ Actualizados | CONSERVAR |
| docs/02-definicion-modulos/OQI-005/especificaciones/ | creados en TASK-FRONTEND-ANALYSIS | ✅ Nuevos | CONSERVAR |
| docs/02-definicion-modulos/OQI-006/especificaciones/ | creados en TASK-FRONTEND-ANALYSIS | ✅ Nuevos | CONSERVAR |

**Conclusión:** Specs técnicas están en docs/, análisis de código en orchestration/. NO HAY duplicación.

### 3. Historias de Usuario (US-*)

| Epic | Implementadas 100% | Parcialmente | No Implementadas | Acción |
|------|-------------------|--------------|------------------|--------|
| OQI-001 | 8/12 (67%) | 3/12 (25%) | 1/12 (8%) | ✅ CONSERVAR TODAS (roadmap) |
| OQI-002 | 5/8 (63%) | 2/8 (25%) | 1/8 (12%) | ✅ CONSERVAR TODAS (roadmap) |
| OQI-003 | 10/18 (56%) | 6/18 (33%) | 2/18 (11%) | ✅ CONSERVAR TODAS (roadmap) |
| OQI-006 | creadas en TASK-FRONTEND-ANALYSIS | - | Nuevas | ✅ CONSERVAR |

**Conclusión:** Incluso user stories 100% implementadas deben conservarse como documentación histórica y especificación de negocio.

---

## Archivos Temporales/Obsoletos

### Búsqueda de Archivos Sospechosos

| Archivo | Ubicación | Tipo | Acción | Justificación |
|---------|-----------|------|--------|---------------|
| nul | workspace-v2/ (raíz) | Archivo vacío (Windows) | 🗑️ ELIMINAR | Error de comando Windows |
| " -u" | workspace-v2/ (raíz) | Archivo vacío | 🗑️ ELIMINAR | Error de comando |
| -u | workspace-v2/ (raíz) | Archivo vacío | 🗑️ ELIMINAR | Error de comando |
| OQI-006-INDICE.md | workspace-v2/ (raíz) | Archivo suelto | 🗑️ MOVER | Debe estar en orchestration/analisis/ |

**Resultado:** 4 archivos a eliminar/mover

---

## Plan de Purga Detallado

### Paso 1: Eliminar Archivos Basura (Inmediato)

```bash
# Desde workspace-v2/
rm -f nul
rm -f " -u"
rm -f -u
```

**Riesgo:** NINGUNO (archivos vacíos sin contenido)

---

### Paso 2: Mover Archivos Mal Ubicados

```bash
# Mover OQI-006-INDICE.md a ubicación correcta
mv OQI-006-INDICE.md projects/trading-platform/orchestration/analisis/
```

**Riesgo:** BAJO (verificar que no haya referencias)

---

### Paso 3: Consolidar Análisis (Si aplica)

**Verificar si TASK-FRONTEND-ANALYSIS tiene overlap con TASK-002:**

```bash
# Leer TASK-FRONTEND-ANALYSIS entregables
cd projects/trading-platform/orchestration/tareas/TASK-2026-01-25-FRONTEND-ANALYSIS/
ls -la

# Comparar con TASK-002
cd ../TASK-2026-01-25-002-FRONTEND-COMPREHENSIVE-AUDIT/entregables/
ls -la
```

**SI HAY OVERLAP:**
- Conservar TASK-002 (más comprehensivo)
- Archivar TASK-FRONTEND-ANALYSIS en `orchestration/tareas/_archived/`

**SI NO HAY OVERLAP:**
- Conservar ambos (complementarios)

---

### Paso 4: Archivar Tareas Muy Antiguas (Futuro)

**Criterio:** Tareas completadas >90 días sin referencias activas

**Acción:**
```bash
# Mover a archivo
mkdir -p orchestration/tareas/_archived/2025-Q4/
mv orchestration/tareas/TASK-2025-10-* orchestration/tareas/_archived/2025-Q4/
```

**Estado Actual:** NO APLICA (todas las tareas son recientes, 2026-01-25)

---

## Resultado del Análisis

| Categoría | Candidatos | A Purgar | A Conservar | A Archivar |
|-----------|------------|----------|-------------|------------|
| Tareas completadas | 1 | 0 | 1 | 0 |
| Tareas en progreso | 3 | 0 | 3 | 0 |
| Docs duplicadas | 0 | 0 | ~48 | 0 |
| User stories | ~100 | 0 | ~100 | 0 |
| Specs técnicas | ~40 | 0 | ~40 | 0 |
| Archivos basura | 4 | 4 | 0 | 0 |
| **TOTAL** | **~192** | **4** | **~192** | **0** |

---

## Recomendaciones

### Inmediato (Esta Semana)

1. ✅ **Eliminar archivos basura** (4 archivos: nul, " -u", -u, OQI-006-INDICE.md mal ubicado)
   - Comando: `rm -f nul " -u" -u && mv OQI-006-INDICE.md projects/trading-platform/orchestration/analisis/`
   - Riesgo: NINGUNO
   - Tiempo: 1 minuto

### Corto Plazo (Q1 2026)

2. **Establecer política de archivado**
   - Tareas completadas >90 días → `_archived/YYYY-Qn/`
   - User stories 100% implementadas >6 meses → `_historical/`
   - Specs obsoletas (reemplazadas) → `_deprecated/`

3. **Implementar script de limpieza automática**
   ```bash
   scripts/cleanup/archive-old-tasks.sh
   ```
   - Ejecutar mensualmente
   - Notificar antes de archivar
   - Backup automático

### Mediano Plazo (Q2 2026)

4. **Migrar a docs-as-code**
   - User stories → Issues GitHub/GitLab
   - Specs técnicas → Swagger/OpenAPI
   - Trazabilidad → Jira/Linear

---

## Decisión Final

### ✅ CONSERVAR TODO (Excepto 4 Archivos Basura)

**Razones:**
1. **Histórico valioso:** Todas las tareas son recientes (2026-01-25)
2. **Sin duplicación:** Análisis de TASK-002 son complementarios, no duplicados
3. **Roadmap activo:** User stories implementadas parcialmente sirven de referencia
4. **Documentación técnica:** Specs en docs/ son SSOT para producto

**Acción Única Requerida:**
```bash
# Ejecutar desde workspace-v2/
rm -f nul " -u" -u
mv OQI-006-INDICE.md projects/trading-platform/orchestration/analisis/
git add -A
git commit -m "[CLEANUP] Remove garbage files and relocate OQI-006-INDICE.md"
```

---

## Monitoreo Futuro

### Checklist Mensual de Purga

- [ ] Listar tareas completadas >90 días
- [ ] Verificar referencias a tareas antiguas
- [ ] Archivar si no hay dependencias
- [ ] Actualizar _INDEX.yml
- [ ] Commit cambios con changelog

### Métricas a Trackear

| Métrica | Actual | Target Q2 | Target Q4 |
|---------|--------|-----------|-----------|
| Tareas activas | 4 | <10 | <15 |
| Tareas archivadas | 0 | 5-10 | 20-30 |
| Docs duplicadas | 0 | 0 | 0 |
| Archivos basura | 4 | 0 | 0 |
| Tamaño orchestration/ | ~2 MB | <5 MB | <10 MB |

---

**Plan creado:** 2026-01-25
**Próxima revisión:** 2026-02-25 (mensual)
**Responsable:** Tech Lead / Arquitecto
