workspace-v1/orchestration/checklists/CHECKLIST-MANTENIMIENTO-DOCS.md

CHECKLIST: Mantenimiento de Documentación

Versión: 1.0.0 Alias: @CHK_MANTENIMIENTO Referencia: SIMCO-MANTENIMIENTO-DOCUMENTACION.md Items Totales: 80 Fecha: 2026-01-10

---

Instrucciones de Uso

1. Ejecutar al completar tarea o fase significativa
2. Marcar cada item conforme se valida [x]
3. Documentar excepciones con justificación
4. Si un item no aplica, marcar [N/A] con razón
5. Guardar checklist completado como evidencia

---

1. IDENTIFICACIÓN (10 items)

Objetivo: Determinar alcance del mantenimiento

• 1.1 Listar todos los documentos modificados en la tarea
• 1.2 Listar documentos con dependencia directa (que referencian a los modificados)
• 1.3 Listar documentos dependientes (que son referenciados por los modificados)
• 1.4 Identificar documentos con >3 meses sin actualizar en el área afectada
• 1.5 Verificar frontmatter YAML de cada documento modificado
• 1.6 Identificar secciones potencialmente obsoletas
• 1.7 Revisar referencias cruzadas en documentos afectados
• 1.8 Listar inventarios que deben actualizarse
• 1.9 Identificar scripts de BD afectados (si aplica)
• 1.10 Documentar alcance total del mantenimiento

Notas de esta sección:

[Anotar aquí observaciones o excepciones]

---

2. SINCRONIZACIÓN (15 items)

Objetivo: Alinear documentación con realidad actual

Specs vs Código

• 2.1 Specs técnicos (ET-*) actualizados vs código implementado
• 2.2 Requerimientos (RF-*) reflejan estado actual
• 2.3 User Stories (US-*) tienen estado correcto
• 2.4 Ejemplos de código en docs son válidos y ejecutables

Backend

• 2.5 Entities sincronizadas con DDL actual
• 2.6 DTOs sincronizados con entities
• 2.7 API specs/Swagger actualizado vs controllers

Frontend

• 2.8 Types/interfaces sincronizados con API responses
• 2.9 Documentación de componentes actualizada

Inventarios

• 2.10 DATABASE_INVENTORY.yml refleja BD actual
• 2.11 BACKEND_INVENTORY.yml refleja código actual
• 2.12 FRONTEND_INVENTORY.yml refleja componentes actuales
• 2.13 MASTER_INVENTORY.yml tiene resumen correcto

Índices

• 2.14 Todos los _MAP.md actualizados en directorios afectados
• 2.15 Fechas updated_date en frontmatter actualizadas

Notas de esta sección:

[Anotar aquí observaciones o excepciones]

---

3. VALIDACIÓN DE DEPENDENCIAS (15 items)

Objetivo: Verificar coherencia y dependencias

Dependencias Verticales

• 3.1 Cambios en specs reflejados en épicas/roadmap si afectan alcance
• 3.2 Cambios en HUs reflejados en specs técnicos
• 3.3 Jerarquía de documentos consistente

Dependencias Horizontales

• 3.4 DDL ↔ Entities sincronizados
• 3.5 Entities ↔ DTOs sincronizados
• 3.6 API ↔ Frontend types sincronizados
• 3.7 Docs ↔ Código consistentes

Referencias

• 3.8 Links internos entre documentos funcionan
• 3.9 Referencias a archivos de código son válidas
• 3.10 No hay referencias a documentos eliminados
• 3.11 No hay referencias a código eliminado

Validaciones Técnicas

• 3.12 Build exitoso después de cambios
• 3.13 Lint exitoso después de cambios
• 3.14 Tests unitarios pasan
• 3.15 Recreación de BD exitosa (si aplica cambios DDL)

Notas de esta sección:

[Anotar aquí observaciones o excepciones]

---

4. DEPRECACIÓN (10 items)

Objetivo: Marcar documentos obsoletos correctamente

Identificación

• 4.1 Documentos obsoletos identificados
• 4.2 Razón de obsolescencia documentada

Marcado

• 4.3 Bloque [DEPRECATED] agregado al inicio de docs obsoletos
• 4.4 Fecha de deprecación especificada
• 4.5 Documento o recurso de reemplazo indicado
• 4.6 Fecha de eliminación planificada (mínimo 30 días)

Actualización de Índices

• 4.7 _MAP.md actualizado con estado DEPRECATED
• 4.8 Changelog actualizado con deprecaciones

Notificación

• 4.9 Equipos afectados notificados de deprecaciones
• 4.10 No se deprecó información valiosa sin respaldo

Notas de esta sección:

[Anotar aquí observaciones o excepciones]

---

5. PURGA GRADUAL (10 items)

Objetivo: Eliminar redundancia manteniendo esencia

Identificación

• 5.1 Secciones redundantes entre documentos identificadas
• 5.2 Información duplicada identificada para consolidar
• 5.3 Verbosidad innecesaria identificada

Ejecución

• 5.4 Secciones duplicadas eliminadas/consolidadas
• 5.5 Ejemplos de código obsoletos eliminados
• 5.6 TODOs antiguos resueltos o eliminados
• 5.7 Referencias a versiones muy antiguas eliminadas
• 5.8 Warnings/notas temporales cumplidas eliminadas

Validación

• 5.9 Purga no excede 20% del contenido original
• 5.10 Contexto histórico valioso preservado (ADRs, decisiones)

Notas de esta sección:

[Anotar aquí observaciones o excepciones]

---

6. VERIFICACIÓN FINAL (15 items)

Objetivo: Confirmar mantenimiento exitoso

Frontmatter

• 6.1 Todos los docs tienen frontmatter YAML válido
• 6.2 Todas las fechas updated_date actualizadas
• 6.3 Todas las versiones incrementadas donde aplica
• 6.4 Estados (status) actualizados

Índices e Inventarios

• 6.5 Todos los _MAP.md actualizados
• 6.6 DATABASE_INVENTORY actualizado
• 6.7 BACKEND_INVENTORY actualizado
• 6.8 FRONTEND_INVENTORY actualizado
• 6.9 MASTER_INVENTORY actualizado

Validaciones Técnicas

• 6.10 Scripts de BD ejecutables sin errores
• 6.11 Build final exitoso
• 6.12 Tests finales exitosos

Documentación

• 6.13 Traza de mantenimiento creada/actualizada
• 6.14 PROXIMA-ACCION.md actualizado si hay trabajo pendiente
• 6.15 Commit realizado con mensaje descriptivo

Notas de esta sección:

[Anotar aquí observaciones o excepciones]

---

7. CARGA DE CONTEXTO PARA SUBAGENTES (5 items)

Objetivo: Asegurar contexto para futuras delegaciones

• 7.1 Directivas relevantes para el área están documentadas en HERENCIA-SIMCO.md
• 7.2 Contexto heredable actualizado si cambió estructura del proyecto
• 7.3 Instrucciones para subagentes claras en docs afectados
• 7.4 Perfiles compactos actualizados si se agregaron nuevas capacidades
• 7.5 SESSION-TRACKING actualizado si hubo trabajo paralelo

Notas de esta sección:

[Anotar aquí observaciones o excepciones]

---

RESUMEN DE EJECUCIÓN

Sección	Items	Completados	N/A	Pendientes
1. Identificación	10
2. Sincronización	15
3. Validación Dependencias	15
4. Deprecación	10
5. Purga Gradual	10
6. Verificación Final	15
7. Carga de Contexto	5
TOTAL	80

---

RESULTADO

Campo	Valor
Fecha de ejecución	{YYYY-MM-DD}
Ejecutado por	{nombre/agente}
Proyecto	{nombre del proyecto}
Tarea/Fase	{referencia a tarea o fase}
Resultado	{APROBADO / CON OBSERVACIONES / REQUIERE REVISIÓN}

Observaciones Generales

[Anotar observaciones generales del mantenimiento]

Issues Encontrados

[Listar issues que requieren atención posterior]

Acciones Pendientes

[Listar acciones que quedaron pendientes con responsable]

---

Referencia: @MANTENIMIENTO_DOCS