Arquitectura Técnica (Overview)

Arquitectura: Open Assessment Standard (OAS v1beta1)

Propósito: Explicar el funcionamiento técnico del motor de orquestación de LLMs, demostrando cómo la separación de responsabilidades (Assessment as Code) permite evaluar cualquier paradigma educativo hispanohablante sin requerir entrenamiento adicional de modelos (Fine-Tuning).

El Problema: El Monolito de “Prompt Engineering”

Históricamente, las plataformas EdTech intentaron usar LLMs enviándoles un “Mega-Prompt” en texto plano. Este prompt contenía mezcladas la ley educativa, el texto a leer, las instrucciones de diseño del reporte (ej. “usa negritas” o “crea una tabla en Markdown”) y las reglas particulares del profesor.

El modelo de lenguaje era forzado a actuar simultáneamente como evaluador pedagógico, analista legal y diseñador de frontend. Las consecuencias de este enfoque eran desastrosas a escala de producción:

1. Prompt Drift y Alucinaciones: Los LLMs tienen un mecanismo de atención limitado. Al inundarlos con instrucciones contradictorias, el modelo sufría “amnesia”, olvidando aplicar reglas críticas de calificación por gastar su capacidad en cuadrar el formato.
2. Fragilidad Técnica: Si el LLM omitía un tag de formato, el parser del backend fallaba, provocando un error en cascada.
3. Dependencia Crítica del Fine-Tuning: Se incurría en costes masivos entrenando modelos específicos por cada ley educativa, generando una obsolescencia rápida ante cualquier cambio curricular.

La Solución Modular

Para solucionar este caos, la arquitectura de OAS descompone el problema en componentes especializados, de forma análoga a como la arquitectura de microservicios revolucionó el desarrollo web tradicional.

A lo largo de las siguientes secciones de esta documentación, exploraremos en detalle los pilares técnicos que sostienen el ecosistema ColabEdu:

1. Assessment as Code (Las 4 Capas): Cómo fragmentamos el conocimiento usando el patrón MVC.
2. Relación de Entidades (El Ejercicio): Cómo se relacionan ExerciseSpec, AssessmentItem y ExerciseType.
3. El Motor de Evaluación (Late Binding y UI): Cómo inyectamos el contexto en tiempo real e imponemos esquemas JSON estructurados.
4. Ecosistema de Agentes: La red de inteligencias especializadas operando sobre el Spec Manager.
5. Jerarquía GitOps: El modelo de herencia de repositorios que permite escalabilidad mundial.