# 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"