Validacion de Coherencia Visual y Funcional (FASE 2)

Decision Tree

code

Archivo .Rmd paso FASE 1?
    |
    +-> NO: Ejecutar validar-renderizado primero
    |
    +-> SI: Validar 4 tipos de coherencia
            |
            +-> Coherencia Matematica (ERR_C1)
            |    +-> Formulas correctas?
            |    +-> exsolution coincide con calculo?
            |
            +-> Coherencia Imagen-Texto (ERR_C2)
            |    +-> Variables sincronizadas R <-> TikZ?
            |    +-> Valores en texto = valores en grafico?
            |
            +-> Coherencia Codigo (ERR_C3)
            |    +-> Funciones sobre numeros (no strings)?
            |    +-> Variables definidas antes de usar?
            |
            +-> Coherencia Metadatos (ERR_C4)
                 +-> 6 dimensiones ICFES presentes?
                 +-> exsolution formato correcto?

Contexto: Ciclo de Validacion

code

FASE 1: validar-renderizado (HTML, PDF, DOCX, NOPS)
    |
FASE 2: validar-coherencia <- ESTE SKILL
    |
FASE 3: diagnosticar-errores (si hay errores)
    |
promover-ejercicio (si todo OK)

Proceso paso a paso

PASO 1: Verificar que FASE 1 paso

El archivo debe renderizar en 4 formatos sin errores criticos.

PASO 2: Ejecutar validacion de coherencia

Run scripts/validar-coherencia.R --help first, then:

bash

Rscript .claude/skills/validar-coherencia/scripts/validar-coherencia.R archivo.Rmd

PASO 3: Analizar resultados

El script verifica automaticamente:

•Metadatos obligatorios (exname, extype, exsolution, exshuffle)
•Metadatos ICFES (6 dimensiones)
•exsolution vs Answerlist (longitud coincide)
•Funciones matematicas sobre strings
•Variables TikZ hardcodeadas

PASO 4: Decidir siguiente accion

•Si todo OK: Aprobar para produccion
•Si hay errores: Continuar a FASE 3 (diagnosticar-errores)

Los 4 Tipos de Coherencia

Ver tipos de coherencia para:

•Checklists detallados por tipo
•Ejemplos de errores comunes
•Patrones de deteccion

Resumen rapido

Tipo	Codigo	Que verifica
Matematica	ERR_C1	Formulas, calculos, exsolution
Imagen-Texto	ERR_C2	Sincronizacion R <-> TikZ/grafico
Codigo	ERR_C3	Funciones sobre numeros, orden variables
Metadatos	ERR_C4	ICFES 6 dimensiones, exsolution formato

Errores comunes detectados

Variables TikZ hardcodeadas (ERR_C2)

Incorrecto:

latex

\def\radio{3}   % Hardcodeado

Correcto:

tikz_code <- paste0("\\def\\radio{", radio_cilindro, "}")

Funcion sobre string (ERR_C3)

Incorrecto:

b_formateado <- sprintf("%.1f", b)
resultado <- abs(b_formateado)  # Error: abs sobre string

Correcto:

b_abs <- abs(b)  # abs sobre numero
b_formateado <- sprintf("%.1f", b_abs)

exsolution desincronizado (ERR_C4)

Incorrecto:

yaml

exsolution: 1  # Debe ser binario

Correcto:

yaml

exsolution: 10000  # 5 opciones, 1ra correcta

Condiciones criticas

Pre-validacion

•Archivo paso FASE 1 (renderiza en 4 formatos)
•Acceso al archivo .Rmd

Durante validacion

•Verificar los 4 tipos de coherencia
•Documentar todos los errores encontrados

Post-validacion

•Si hay errores: Continuar a FASE 3
•Si todo OK: Aprobar para produccion

Referencias

•Tipos de coherencia - Checklists detallados
•Ciclo Validacion: .claude/rules/ciclo-validacion.md
•Codigo .Rmd: .claude/rules/codigo-rmd.md
•Metadatos ICFES: .claude/skills/analizar-icfes/SKILL.md

Integracion con otros skills

code

validar-renderizado (FASE 1)
    |
validar-coherencia (FASE 2) <- ESTE SKILL
    |
diagnosticar-errores (FASE 3)
    |
promover-ejercicio