codigo0/docs/CHECKLIST_LIMPIEZA_MARKDOWN.md

📋 Checklist de Limpieza Markdown - Paso 2

Objetivo: Dejar el sistema Markdown estable, coherente y defendible
Fecha: 2025-12-23
Estado: Listo para ejecución

---

🎯 Decisiones Firmes (Ya No Se Discuten)

✅ Markdown se mantiene como:

• Manual base
• Referencia textual
• Fuente editorial estable
• Soporte offline

❌ Markdown NO será:

• Sistema multimedia
• Guía educativa rica
• Lugar para casos clínicos complejos

👉 Eso vendrá después con la Guía de Refuerzo.

---

🔴 BLOQUE A — OBLIGATORIO

Si no haces esto, todo lo demás se vuelve frágil.

A1. Renombrado de Archivos con Numeración Anómala

Archivos afectados: 9 archivos

Archivo Actual	Nuevo Nombre	Acción
BLOQUE_02_X_INVENTARIO_MATERIAL.md	BLOQUE_02_14_INVENTARIO_MATERIAL.md	Renombrar
BLOQUE_03_X_INVENTARIO_MATERIAL_SANITARIO.md	BLOQUE_03_19_INVENTARIO_MATERIAL_SANITARIO.md	Renombrar
BLOQUE_03_X2_MALETIN_CURAS.md	BLOQUE_03_20_MALETIN_CURAS.md	Renombrar
BLOQUE_03_X3_BOLSA_MONITORIZACION.md	BLOQUE_03_21_BOLSA_MONITORIZACION.md	Renombrar
BLOQUE_03_X4_INVENTARIO_GLOBAL.md	BLOQUE_03_22_INVENTARIO_GLOBAL.md	Renombrar
BLOQUE_03_X5_CHECKLIST_MAESTRO.md	BLOQUE_03_23_CHECKLIST_MAESTRO.md	Renombrar
BLOQUE_03_99_CIERRE_BLOQUE_3.md	BLOQUE_03_24_CIERRE_BLOQUE_3.md	Renombrar
BLOQUE_04_0B_RECONOCIMIENTO_PCR.md	BLOQUE_04_0_RECONOCIMIENTO_PCR.md	Renombrar
BLOQUE_04_0_ACCESO_VASCULAR_BASICO.md	BLOQUE_04_10_ACCESO_VASCULAR_BASICO.md	Renombrar (después de renombrar 0B)
BLOQUE_05_0B_PROTOCOLOS_EMERGENCIAS_ESPECIFICAS.md	BLOQUE_05_9_PROTOCOLOS_EMERGENCIAS_ESPECIFICAS.md	Renombrar

Orden de ejecución:

1. ✅ Renombrar todos los archivos (comando mv o desde IDE)
2. ✅ Actualizar src/data/manual-index.ts con nuevas rutas
3. ✅ Verificar que la app carga sin errores
4. ✅ Verificar que no hay enlaces rotos

⏱️ Tiempo estimado: 45-60 minutos

---

A2. Corrección de Títulos (Mayúsculas + Paréntesis)

Archivos afectados: 12 archivos

Mayúsculas Inconsistentes (8 archivos)

Archivo	Título Actual	Corrección
BLOQUE_04_3_RCP_LACTANTES.md	# 4.3 – Rcp Básica en Lactantes	# 4.3 – RCP Básica en Lactantes
BLOQUE_04_4_USO_DESA.md	# 4.4 – Uso del Desa	# 4.4 – Uso del DESA
BLOQUE_04_5_RCP_DOS_INTERVINIENTES.md	# 4.5 – Rcp con Dos Intervinientes	# 4.5 – RCP con Dos Intervinientes
BLOQUE_04_7_OVACE_PEDIATRIA.md	# 4.7 – Ovace en Pediatría	# 4.7 – OVACE en Pediatría
BLOQUE_04_8_OVACE_LACTANTES.md	# 4.8 – Ovace en Lactantes	# 4.8 – OVACE en Lactantes
BLOQUE_05_2_OVACE_TRANSTELEFONICA.md	# 5.2 – Ovace Transtelefónica	# 5.2 – OVACE Transtelefónica
BLOQUE_04_0B_RECONOCIMIENTO_PCR.md	# 4.0 – Reconocimiento de la Parada Cardiorrespiratoria (Pcr)	# 4.0 – Reconocimiento de la Parada Cardiorrespiratoria (PCR)

Regla: Acrónimos siempre en mayúsculas: RCP, OVACE, DESA, PCR, ABCDE, START

Paréntesis Redundantes (4 archivos)

Archivo	Título Actual	Corrección
BLOQUE_03_11_GLUCOMETRO.md	# 3.11 – Glucómetro y Control de Glucemia: Uso Operativo (Tes)	# 3.11 – Glucómetro y Control de Glucemia: Uso Operativo
BLOQUE_03_9_EXPOSICION_AISLAMIENTO_TERMICO.md	# 3.9 – Exposición, Aislamiento Térmico y Prevención de Hipotermia (Operativo Tes)	# 3.9 – Exposición, Aislamiento Térmico y Prevención de Hipotermia
BLOQUE_03_99_CIERRE_BLOQUE_3.md	# 3.99 – Cierre del Bloque 3: Uso Operativo del Material en Intervención (Tes)	# 3.99 – Cierre del Bloque 3: Uso Operativo del Material en Intervención
BLOQUE_03_2_ASPIRACION.md	# 3.2 – Aspiración: Material y Uso Seguro (Operativo Tes)	# 3.2 – Aspiración: Material y Uso Seguro

Regla: Eliminar "(Tes)" y "(Operativo Tes)". El tipo se indica en YAML.

⏱️ Tiempo estimado: 30-40 minutos

---

A3. YAML Mínimo en Protocolos Críticos

Archivos afectados: 10 archivos

YAML a añadir (solo esto):

---
tipoContenido: "operativo"
capaApp: "operativa"
---

Archivos:

Archivo	Ubicación
BLOQUE_04_1_RCP_ADULTOS.md	Al inicio del archivo (después de título si no hay YAML)
BLOQUE_04_2_RCP_PEDIATRIA.md	Al inicio del archivo
BLOQUE_04_3_RCP_LACTANTES.md	Al inicio del archivo
BLOQUE_04_4_USO_DESA.md	Al inicio del archivo
BLOQUE_04_6_OVACE_ADULTOS.md	Al inicio del archivo
BLOQUE_04_7_OVACE_PEDIATRIA.md	Al inicio del archivo
BLOQUE_04_8_OVACE_LACTANTES.md	Al inicio del archivo
BLOQUE_01_1_CONSTANTES_VITALES.md	Al inicio del archivo
BLOQUE_01_2_ABCDE_OPERATIVO.md	Al inicio del archivo
BLOQUE_01_3_GLASGOW_OPERATIVO.md	Al inicio del archivo

Nota: Si el archivo ya tiene YAML, solo añadir estas dos líneas si faltan.

⏱️ Tiempo estimado: 30 minutos

---

🟠 BLOQUE B — IMPORTANTE

Mejora calidad, pero no rompe nada si se retrasa.

B1. YAML Mínimo al Resto de Archivos Operativos

No hacerlo todo de golpe. Hacerlo por bloques:

Orden sugerido:

1. BLOQUE_4 (resto de archivos) - 3 archivos
2. BLOQUE_1 (resto de archivos) - 1 archivo
3. BLOQUE_2 - 14 archivos
4. BLOQUE_3 (resto de archivos) - ≈20 archivos
5. BLOQUE_5 - 10 archivos
6. BLOQUE_7 - 6 archivos
7. BLOQUE_8 - 5 archivos

YAML a añadir:

---
tipoContenido: "operativo"
capaApp: "operativa"
---

Excepciones (archivos formativos):

Archivo	tipoContenido	capaApp
BLOQUE_00_0_FUNDAMENTOS_EMERGENCIAS.md	formativo	refuerzo
BLOQUE_12_0_MARCO_LEGAL_ETICO_PROFESIONAL.md	formativo	refuerzo
BLOQUE_13_0_COMUNICACION_RELACION_PACIENTE.md	formativo	refuerzo
BLOQUE_14_0_SEGURIDAD_PERSONAL_SALUD_TES.md	formativo	refuerzo
BLOQUE_15_0_INTRODUCCION_ALTERACIONES_PSIQUIATRICAS.md	formativo	refuerzo
BLOQUE_09_0_MEDICINA_EMERGENCIAS_APLICADA.md	mixto	ambas
BLOQUE_10_0_SITUACIONES_ESPECIALES.md	mixto	ambas

Archivos de referencia (inventarios, checklists):

Archivo	tipoContenido	capaApp
BLOQUE_02_14_INVENTARIO_MATERIAL.md	referencia	anexos
BLOQUE_03_19_INVENTARIO_MATERIAL_SANITARIO.md	referencia	anexos
BLOQUE_03_20_MALETIN_CURAS.md	referencia	anexos
BLOQUE_03_21_BOLSA_MONITORIZACION.md	referencia	anexos
BLOQUE_03_22_INVENTARIO_GLOBAL.md	referencia	anexos
BLOQUE_03_23_CHECKLIST_MAESTRO.md	referencia	anexos
BLOQUE_06_7_ABREVIATURAS_TERMINOLOGIA_FARMACOLOGICA.md	referencia	anexos

⏱️ Tiempo estimado: 1-2 sesiones cortas (30-45 min cada bloque)

---

B2. Enlaces "Ver También" SOLO en Capítulos Troncales

❌ NO enlaces todo con todo
❌ NO conviertas esto en Wikipedia
✔ Solo en estos archivos principales:

Archivo	Enlaces Recomendados (máx. 5)
BLOQUE_04_1_RCP_ADULTOS.md	→ BLOQUE_04_2_RCP_PEDIATRIA.md → BLOQUE_04_3_RCP_LACTANTES.md → BLOQUE_04_4_USO_DESA.md → BLOQUE_03_1B_VENTILACION_BOLSA_MASCARILLA.md
BLOQUE_04_6_OVACE_ADULTOS.md	→ BLOQUE_04_7_OVACE_PEDIATRIA.md → BLOQUE_04_8_OVACE_LACTANTES.md
BLOQUE_01_2_ABCDE_OPERATIVO.md	→ BLOQUE_01_1_CONSTANTES_VITALES.md → BLOQUE_01_3_GLASGOW_OPERATIVO.md
BLOQUE_03_0_OXIGENOTERAPIA_COMPLETA.md	→ BLOQUE_03_1B_VENTILACION_BOLSA_MASCARILLA.md → BLOQUE_03_4_CANULAS.md
BLOQUE_03_4_CANULAS.md	→ BLOQUE_03_1B_VENTILACION_BOLSA_MASCARILLA.md → BLOQUE_03_2_ASPIRACION.md

Formato estándar:

---

## Relación con Otros Capítulos

- **4.2 – RCP Básica en Pediatría** (variante pediátrica)
- **4.4 – Uso del DESA** (equipamiento relacionado)
- **3.1 – Ventilación con Bolsa-Mascarilla** (técnica relacionada)

⏱️ Tiempo estimado: 45 minutos

---

🟢 BLOQUE C — OPCIONAL

NO hacer ahora. Esto NO bloquea nada y puede esperar.

• ❌ Navegación anterior/siguiente
• ❌ Índices por bloque
• ❌ Metadatos extra (nivelDificultad, importancia, palabrasClave)
• ❌ Notas de "desarrollo futuro"

📌 Recomendación: No lo hagas ahora. Te distrae del objetivo.

---

❌ Qué NO Hacer en el Paso 2

Muy importante:

• ❌ NO dividir capítulos largos
• ❌ NO fusionar capítulos salvo duplicados claros
• ❌ NO mover carpetas
• ❌ NO reescribir texto
• ❌ NO adaptar aún al modelo de Guía de Refuerzo

👉 Todo eso viene después, con criterio y calma.

---

✅ Resultado Esperado al Terminar el Paso 2

Cuando acabes el Paso 2, tu sistema tendrá:

• ✅ Numeración limpia y predecible
• ✅ Títulos coherentes
• ✅ Tipos de contenido explícitos
• ✅ Manual defendible como documento profesional
• ✅ Base sólida para:
  • Refactor futuro
  • Guía de refuerzo
  • Renderers más ricos

---

🎯 Señal Clara de que Puedes Pasar al Paso 3

Cuando se cumplan estas 4 cosas:

1. ✅ No queda ningún archivo X / X2 / 0B / 99
2. ✅ Todos los títulos de RCP / OVACE están bien escritos
3. ✅ Los protocolos críticos tienen YAML
4. ✅ La app carga sin enlaces rotos

👉 PARA.
👉 No sigas limpiando.
👉 Escríbeme y pasamos al Paso 3.

---

📝 Orden de Ejecución Recomendado

Sesión 1: Bloque A Completo (≈2 horas)

1. A1: Renombrar archivos (45-60 min)

   • Renombrar todos los archivos
   • Actualizar manual-index.ts
   • Verificar carga

2. A2: Corregir títulos (30-40 min)

   • Buscar y reemplazar mayúsculas
   • Eliminar paréntesis redundantes
   • Verificar formato

3. A3: Añadir YAML crítico (30 min)

   • Añadir YAML a 10 archivos críticos
   • Verificar formato válido

✅ Al finalizar: Verificar que la app funciona correctamente.

---

Sesión 2: Bloque B (cuando tengas tiempo)

1. B1: YAML por bloques (1-2 sesiones)

   • Empezar por BLOQUE_4
   • Continuar con otros bloques cuando puedas

2. B2: Enlaces "Ver También" (45 min)

   • Solo en archivos principales
   • Máximo 5 enlaces por archivo

---

✅ Checklist de Verificación Final

Antes de considerar completado el Paso 2:

• Todos los archivos con numeración especial renombrados (9 archivos)
• Todos los títulos con mayúsculas consistentes (8 archivos)
• Todos los títulos sin paréntesis redundantes (4 archivos)
• YAML mínimo añadido a protocolos críticos (10 archivos)
• manual-index.ts actualizado con nuevas rutas
• Sin enlaces rotos en la aplicación
• La app carga sin errores

Si todo está marcado: ✅ Paso 2 completado. Listo para Paso 3.

---

Fin del Checklist - Paso 2

Este documento debe actualizarse conforme se completen las acciones.