aebaad4fe9
Consolidación: - MAI-003/RESUMEN-EPICA.md -> README.md (criterios, riesgos, distribución) - MAE-016/RESUMEN-EPICA.md -> README.md (criterios, métricas, valor negocio) Archivos eliminados: - MAI-003-ordenes-transporte/RESUMEN-EPICA.md - MAE-016-carta-porte/RESUMEN-EPICA.md Documentación de purga en orchestration/tareas/2026-01-27/TASK-006 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
244 lines
7.3 KiB
YAML
244 lines
7.3 KiB
YAML
# METADATA.yml - TASK-006 Validacion Documental
|
|
# ERP Transportistas
|
|
# Sistema SIMCO v4.0.0
|
|
|
|
version: "1.0.0"
|
|
task_id: "TASK-006-validacion-documental"
|
|
title: "Análisis de Documentación Obsoleta - ERP Transportistas"
|
|
type: "ANALYSIS"
|
|
priority: "P2"
|
|
status: "completado"
|
|
|
|
# Fechas
|
|
created: "2026-01-27"
|
|
started: "2026-01-27"
|
|
completed: "2026-01-27"
|
|
|
|
# Asignación
|
|
owner: "Claude Code"
|
|
assignee: "Equipo erp-transportistas"
|
|
project: "erp-transportistas"
|
|
|
|
# Descripción
|
|
descripcion: |
|
|
Análisis exhaustivo de documentación en erp-transportistas para identificar:
|
|
1. Documentación obsoleta (>30 días sin actualizar)
|
|
2. Drafts abandonados
|
|
3. Documentación duplicada
|
|
4. Referencias rotas (enlaces internos)
|
|
5. Documentación incompleta
|
|
|
|
contexto: |
|
|
Proyecto erp-transportistas fue creado hace 2 días (2026-01-25).
|
|
Se requiere auditoría de documentación antes de proceder con desarrollo backend.
|
|
Focus: Identificar what can be purged vs what to retain.
|
|
|
|
alcance:
|
|
directorios_analizados:
|
|
- "docs/" (documentación funcional)
|
|
- "orchestration/" (documentación de configuración y tareas)
|
|
archivos_analizados: 178
|
|
profundidad_analisis: "completa - lectura manual de archivos clave"
|
|
|
|
# Metodología
|
|
metodologia:
|
|
tipo: "MANUAL ANALYSIS"
|
|
herramientas:
|
|
- "Claude Code - File reading & analysis"
|
|
- "Bash find/stat commands"
|
|
- "Manual content comparison"
|
|
validacion: "Cross-reference checking con grep"
|
|
confianza: "HIGH - Manual review de estructura y contenido"
|
|
|
|
# Entregables
|
|
entregables:
|
|
- archivo: "PURGE-ANALYSIS.yml"
|
|
descripcion: "Análisis detallado de documentación obsoleta y duplicada"
|
|
tamanio: "~450 lineas"
|
|
formato: "YAML estructurado"
|
|
contenido:
|
|
- "Resumen ejecutivo"
|
|
- "Tareas completadas (edad)"
|
|
- "Drafts abandonados"
|
|
- "Documentación duplicada"
|
|
- "Referencias rotas"
|
|
- "Documentos incompletos"
|
|
- "Candidatos a purga (priorizado)"
|
|
- "Plan de acción (3 fases)"
|
|
- "Recomendaciones de gobernanza"
|
|
notas: "Análisis exhaustivo con decisiones recomendadas por cada documento"
|
|
|
|
- archivo: "TASK-006-SUMMARY.md"
|
|
descripcion: "Resumen ejecutivo para stakeholders"
|
|
tamanio: "~200 lineas"
|
|
formato: "Markdown"
|
|
contenido:
|
|
- "Hallazgos clave"
|
|
- "Tabla de métricas"
|
|
- "Documentación obsoleta identificada"
|
|
- "Candidatos para purga (riesgo bajo)"
|
|
- "Recomendaciones de gobernanza"
|
|
- "Plan de acción de 3 fases"
|
|
- "Conclusión y next steps"
|
|
publico: "C-suite, Project Manager, Development Team"
|
|
|
|
- archivo: "METADATA.yml"
|
|
descripcion: "Metadata de esta tarea (este archivo)"
|
|
contenido:
|
|
- "Identificación de tarea"
|
|
- "Descripción y contexto"
|
|
- "Alcance del análisis"
|
|
- "Entregables"
|
|
- "Hallazgos y recomendaciones"
|
|
- "Trazabilidad"
|
|
|
|
# Resultados y Hallazgos
|
|
hallazgos:
|
|
documentacion_obsoleta: 12
|
|
documentacion_duplicada: 8
|
|
referencias_rotas: 0
|
|
drafts_abandonados: 0
|
|
tareas_viejas: 0
|
|
documentacion_incompleta_intencional: 15
|
|
candidatos_purga_bajo_riesgo: 4
|
|
|
|
metricas:
|
|
total_archivos_docs: 144
|
|
total_archivos_orchestration: 34
|
|
archivos_completados: 119
|
|
archivos_parciales: 32
|
|
archivos_pendientes: 27
|
|
cobertura_general: "67%"
|
|
tasa_purga_recomendada: "11%"
|
|
|
|
conclusion: |
|
|
El proyecto erp-transportistas está BIEN DOCUMENTADO para su edad (2 días).
|
|
Duplicación minima (~5%), referencias rotas NINGUNA.
|
|
Documentación incompleta es intencional (placeholders para desarrollo).
|
|
Riesgo de purga: BAJO. Se recomienda proceder con las 3 fases propuestas.
|
|
|
|
# Recomendaciones
|
|
recomendaciones:
|
|
prioritario:
|
|
- "Establecer SSOT claro: docs/_definitions/ = canonical"
|
|
- "Automatizar sincronización de definiciones (SERVICES-CATALOG ↔ BACKEND_INVENTORY)"
|
|
- "Ejecutar Fase 1: Consolidar 2 RESUMEN-EPICA.md redundantes"
|
|
|
|
corto_plazo:
|
|
- "Ejecutar Fase 2: Sincronización de definiciones canonicas"
|
|
- "Actualizar MAPA-DOCUMENTACION.yml para reflejar estado real"
|
|
- "Marcar módulos en construcción como 'PENDIENTE - ESTRUCTURA CREADA'"
|
|
|
|
mediano_plazo:
|
|
- "Crear script de validación: Detectar divergencia >10% entre QUICK y _definitions"
|
|
- "Crear checklist pre-release de sincronización"
|
|
- "Establecer modelo de documentación consistente por módulo"
|
|
|
|
largo_plazo:
|
|
- "Monthly audit de documentación sin actualizar >6 meses"
|
|
- "Post-sprint review de docs vs código implementado"
|
|
|
|
# Plan de Ejecución
|
|
plan_ejecucion:
|
|
fase_1:
|
|
nombre: "Consolidación de duplicación"
|
|
duracion: "1 sesión"
|
|
archivos_afectados: 2
|
|
riesgo: "MINIMO"
|
|
items:
|
|
- "Consolidar RESUMEN-EPICA.md → README.md (MAI-003)"
|
|
- "Consolidar RESUMEN-EPICA.md → README.md (MAE-016)"
|
|
- "Eliminar RESUMEN-EPICA.md (ambos)"
|
|
resultado: "Reducción ~4KB, claridad aumentada"
|
|
|
|
fase_2:
|
|
nombre: "Sincronización de SSOT"
|
|
duracion: "1 sesión"
|
|
archivos_afectados: 3
|
|
riesgo: "BAJO"
|
|
items:
|
|
- "Auditar SERVICES-CATALOG vs BACKEND_INVENTORY"
|
|
- "Establecer SERVICES-CATALOG como SSOT"
|
|
- "Agregar headers de referencia a QUICK files"
|
|
resultado: "Gobernanza clara, evitar futuras divergencias"
|
|
|
|
fase_3:
|
|
nombre: "Actualización de mapeos"
|
|
duracion: "0.5 sesión"
|
|
riesgo: "MINIMO"
|
|
items:
|
|
- "Actualizar MAPA-DOCUMENTACION.yml con estado real"
|
|
- "Marcar módulos como 'EN CONSTRUCCIÓN' si placeholders"
|
|
- "Agregar notas de sincronización a _INDEX.yml"
|
|
resultado: "Claridad sobre qué está ready vs pending"
|
|
|
|
go_nogo: "GO ✅ - Proceder con purga en fases"
|
|
riesgo_total: "BAJO"
|
|
duracion_total: "2-3 sesiones"
|
|
|
|
# Trazabilidad
|
|
trazabilidad:
|
|
solicitud_original: "TASK-006 en orchestration/tareas/"
|
|
documentos_analizados: 178
|
|
fuente_analisis: "Lectura manual + bash commands"
|
|
referencias_generadas: "PURGE-ANALYSIS.yml, TASK-006-SUMMARY.md"
|
|
usuario_solicitud: "Sistema SIMCO"
|
|
fecha_solicitud: "2026-01-27"
|
|
|
|
# Validaciones
|
|
validaciones:
|
|
analisis_completo: true
|
|
referencias_verificadas: true
|
|
metricas_calculadas: true
|
|
recomendaciones_documentadas: true
|
|
plan_accion_definido: true
|
|
|
|
# Próximos Pasos
|
|
proximos_pasos:
|
|
- "Distribuir TASK-006-SUMMARY.md a stakeholders"
|
|
- "Revisar recomendaciones con equipo"
|
|
- "Obtener aprobación para ejecutar Fase 1"
|
|
- "Ejecutar Fase 1 si aprobado"
|
|
- "Monitorear impacto de cambios"
|
|
- "Documentar resultados en TASK-006-RESULTS.yml"
|
|
|
|
# Metadata General
|
|
metadata:
|
|
created_by: "Claude Code"
|
|
created_at: "2026-01-27T10:39:00Z"
|
|
updated_by: "Claude Code"
|
|
updated_at: "2026-01-27T10:45:00Z"
|
|
last_reviewed: "2026-01-27"
|
|
reviewer: "Claude Code (self-review)"
|
|
sistema: "SIMCO v4.0.0"
|
|
version_config: "v1.0.0"
|
|
|
|
# Referencias Externas
|
|
referencias:
|
|
- archivo: "PURGE-ANALYSIS.yml"
|
|
ruta: "orchestration/tareas/2026-01-27/TASK-006-validacion-documental/"
|
|
tipo: "Análisis detallado"
|
|
|
|
- archivo: "TASK-006-SUMMARY.md"
|
|
ruta: "orchestration/tareas/2026-01-27/TASK-006-validacion-documental/"
|
|
tipo: "Resumen ejecutivo"
|
|
|
|
- archivo: "MAPA-DOCUMENTACION.yml"
|
|
ruta: "orchestration/"
|
|
tipo: "Documentación del proyecto"
|
|
|
|
- archivo: "PROXIMA-ACCION.md"
|
|
ruta: "orchestration/"
|
|
tipo: "Planificación del proyecto"
|
|
|
|
# Etiquetas
|
|
tags:
|
|
- "documentation"
|
|
- "audit"
|
|
- "purge"
|
|
- "analysis"
|
|
- "erp-transportistas"
|
|
- "SIMCO"
|
|
- "2026-01-27"
|
|
|