Moved loose tasks to date folders: - 2026-01-25/: TASK-002-FRONTEND-COMPREHENSIVE-AUDIT, TASK-FRONTEND-MODULE-DOCS - 2026-01-27/: TASK-BLOCKER-001-TOKEN-REFRESH, TASK-MASTER-ANALYSIS-PLAN Moved utility files to _utils/: - ARCHIVE-INFO.md - ATOMIC-TASKS-INDEX.yml Aligns with workspace-v2 orchestration standards. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
8.4 KiB
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
-
Tareas Completadas >30 días
- Estado: completada
- Sin referencias activas
- Información ya integrada en docs/
-
Documentación Duplicada
- Contenido replicado en múltiples ubicaciones
- Mantener SSOT (Single Source of Truth)
-
Definiciones Obsoletas
- User stories implementadas 100%
- Specs reemplazadas por código actual
-
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)
# 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
# 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:
# 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:
# 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)
- ✅ 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
- Comando:
Corto Plazo (Q1 2026)
-
Establecer política de archivado
- Tareas completadas >90 días →
_archived/YYYY-Qn/ - User stories 100% implementadas >6 meses →
_historical/ - Specs obsoletas (reemplazadas) →
_deprecated/
- Tareas completadas >90 días →
-
Implementar script de limpieza automática
scripts/cleanup/archive-old-tasks.sh- Ejecutar mensualmente
- Notificar antes de archivar
- Backup automático
Mediano Plazo (Q2 2026)
- 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:
- Histórico valioso: Todas las tareas son recientes (2026-01-25)
- Sin duplicación: Análisis de TASK-002 son complementarios, no duplicados
- Roadmap activo: User stories implementadas parcialmente sirven de referencia
- Documentación técnica: Specs en docs/ son SSOT para producto
Acción Única Requerida:
# 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