DEUTSCH LEARNING SYSTEM 2.0

Documento maestro de transferencia a Codex

Versión: 1.0

Fecha: 24 de octubre de 2026

Estado: Inicio de proyecto — repositorio GitHub vacío

Fase actual: Especificación pedagógica v1.1, pendiente de consolidación y aprobación definitiva

Destino: Proyecto Codex conectado a GitHub

1. CONTEXTO GENERAL

Deutsch Learning System 2.0 es un proyecto para desarrollar un sistema integral de aprendizaje autónomo del idioma alemán, dirigido a personas hispanohablantes desde los 14 años.

El objetivo es construir un curso completo desde A1 hasta B2, acompañado de una infraestructura tecnológica capaz de planificar, producir, revisar, validar y publicar material educativo mediante inteligencia artificial y herramientas de automatización.

El proyecto debe contemplar tanto materiales digitales interactivos como versiones imprimibles.

1.1. Antecedentes

Existió un proyecto anterior para crear un curso de alemán A1–B2, con diferentes estructuras, plantillas, prompts y procesos de producción.

Durante ese desarrollo se identificaron problemas recurrentes:

• Lecciones con explicaciones insuficientes.
• Contenidos repetidos o mal distribuidos.
• Falta de continuidad curricular.
• Inconsistencias entre entregas.
• Dependencia de prompts extensos.
• Ejercicios mecánicos sin suficiente valor pedagógico.
• Correcciones manuales constantes.
• Cambios editoriales que afectaban contenido aprobado.
• Dificultades para mantener una fuente única de verdad.

Decisión definitiva: reiniciar el proyecto desde cero.

El proyecto anterior solo debe servir como experiencia para evitar esos errores. No deben reutilizarse automáticamente sus documentos, personajes, temarios, estructuras, textos ni reglas editoriales.

Codex debe tratar este documento como punto de partida y no intentar reconstruir decisiones anteriores que no estén recogidas aquí.

2. OBJETIVO DEL PRODUCTO

Desarrollar un programa estructurado de aprendizaje autónomo del alemán, alineado con el Marco Común Europeo de Referencia para las Lenguas (MCER), que permita desarrollar progresivamente:

1. Comprensión escrita.
2. Comprensión auditiva.
3. Producción escrita.
4. Producción oral.
5. Interacción comunicativa.
6. Mediación lingüística, adaptada al nivel.

El estudiante debe poder estudiar sin depender permanentemente de un profesor.

Para conseguirlo, cada lección debe ofrecer explicaciones suficientes, ejemplos contextualizados, práctica progresiva, retroalimentación y mecanismos de autoevaluación.

El curso no debe limitarse a memorizar vocabulario o completar ejercicios gramaticales.

Importante: completar las lecciones no garantiza automáticamente una certificación B2. El nivel alcanzado dependerá de la práctica adicional, la exposición al idioma y las competencias demostradas.

3. DECISIONES ESTRUCTURALES CONFIRMADAS

3.1. Distribución

• A1: 40 lecciones.
• A2: 40 lecciones.
• B1: 40 lecciones.
• B2: 40 lecciones.

Total: 160 lecciones y 160 horas nominales de estudio base.

Las 160 horas no incluyen necesariamente repasos adicionales, lecturas extensivas, práctica oral complementaria ni preparación específica para certificaciones.

La cantidad de lecciones está definida, pero su contenido todavía debe investigarse y distribuirse curricularmente.

No debe generarse el temario definitivo sin completar primero la investigación correspondiente.

4. PERFIL PEDAGÓGICO DEL ESTUDIANTE

Este requisito es especialmente importante.

El curso está dirigido a personas hispanohablantes de 14 años en adelante que:

• No saben alemán.
• No necesitan conocer otro idioma.
• Pueden hablar español correctamente sin conocer sus reglas gramaticales.
• No necesariamente saben qué es un verbo, sustantivo, adverbio, pronombre, sujeto, predicado o conjugación.
• No tienen formación técnica en lingüística.
• Necesitan explicaciones claras, completas y comprensibles.

4.1. Regla fundamental

Nunca asumir que hablar español implica conocer técnicamente la gramática española.

Toda terminología gramatical necesaria debe explicarse antes de utilizarse como conocimiento previo.

El lenguaje debe ser sencillo, preciso y natural, pero nunca infantil, condescendiente o excesivamente simplificado.

El objetivo es enseñar conceptos complejos de manera comprensible sin sacrificar el rigor.

4.2. Método de explicación

Cuando se introduzca un concepto nuevo, seguir preferentemente esta secuencia:

1. Explicación cotidiana.
2. Ejemplo familiar en español.
3. Identificación del concepto.
4. Ejemplo equivalente o relacionado en alemán.
5. Aplicación práctica.
6. Comprobación de comprensión.

Ejemplo:

Concepto: verbo

Un verbo es una palabra que nos ayuda a expresar lo que alguien hace, lo que sucede o cómo está alguien.

Ejemplos:

• María cocina.
• El niño duerme.
• Pedro está cansado.

En alemán:

*Ich lerne Deutsch.*

«Lerne» es el verbo porque expresa la acción de aprender.

Este enfoque debe aplicarse a toda la terminología técnica relevante.

4.3. Glosario pedagógico acumulativo

El sistema debe mantener un glosario estructurado de conceptos lingüísticos.

Cada entrada incluirá:

• Identificador.
• Nombre.
• Definición sencilla.
• Función.
• Ejemplo en español.
• Ejemplo en alemán cuando corresponda.
• Primera lección donde aparece.
• Conceptos previos necesarios.
• Referencias a lecciones posteriores.

El glosario debe permitir comprobar que ninguna lección utiliza conceptos técnicos que el estudiante todavía no ha aprendido.

También debe permitir recuperar explicaciones anteriores cuando sea necesario.

4.4. Criterios pedagógicos específicos

• PED-01: Ningún término técnico aparece sin explicación previa o referencia accesible.
• PED-02: Toda definición nueva incluye un ejemplo comprensible.
• PED-03: Las explicaciones no presuponen conocimientos formales de gramática española.
• PED-04: Los ejercicios comprueban la comprensión, no únicamente la memorización de nombres o definiciones.

Estos requisitos deben incorporarse al sistema de auditoría.

5. PRINCIPIOS PEDAGÓGICOS

El sistema debe aplicar los siguientes principios:

5.1. Progresión

Cada contenido debe partir de conocimientos previos identificados.

5.2. Claridad

Las explicaciones deben ser suficientes para aprender sin profesor.

5.3. Aprendizaje activo

El estudiante debe utilizar lo aprendido, no limitarse a leer.

5.4. Contextualización

Los contenidos deben aparecer en situaciones comunicativas realistas.

5.5. Recuperación activa

Las lecciones deben recuperar conocimientos anteriores.

5.6. Repetición espaciada

El sistema debe permitir programar repasos según el tiempo transcurrido y el desempeño del estudiante.

5.7. Práctica intercalada

Las actividades deben combinar progresivamente conocimientos nuevos y anteriores.

5.8. Retroalimentación

Las respuestas deben acompañarse de explicaciones cuando sea necesario.

5.9. Autonomía

El estudiante debe disponer de instrucciones, ejemplos, soluciones y ayudas suficientes.

5.10. Evaluación por competencias

No basta con completar ejercicios: deben existir evidencias de que el estudiante puede utilizar el idioma.

6. MODELO INICIAL DE LECCIÓN

Se ha propuesto una estructura orientativa de 60 minutos.

Esta distribución es una propuesta inicial, no una plantilla rígida definitivamente aprobada.

Las lecciones podrán variar según los objetivos, la complejidad y las habilidades trabajadas.

No debe imponerse una cantidad artificial de palabras o ejercicios.

La profundidad se evaluará mediante comprensión, suficiencia explicativa y desempeño comunicativo.

6.1. Componentes funcionales

Cada lección debe contemplar, cuando corresponda:

• Objetivos observables.
• Prerrequisitos.
• Introducción contextual.
• Explicación conceptual.
• Ejemplos.
• Vocabulario.
• Gramática.
• Comprensión escrita o auditiva.
• Ejercicios graduados.
• Producción escrita u oral.
• Evaluación.
• Soluciones.
• Retroalimentación.
• Recursos multimedia.
• Referencias para repaso.

El diseño editorial definitivo sigue pendiente.

7. IDIOMA DE LAS EXPLICACIONES

Se ha propuesto una transición gradual desde el español hacia el alemán.

No se han aprobado porcentajes rígidos.

El criterio debe ser la comprensión del estudiante y la progresión pedagógica.

8. EVALUACIÓN DEL APRENDIZAJE

Se proponen tres niveles de evaluación.

8.1. Evaluación por lección

Comprobar los objetivos específicos mediante ejercicios y tareas comunicativas.

8.2. Evaluación por bloque

Cada cinco lecciones, evaluar integración, recuperación y aplicación de conocimientos.

8.3. Evaluación por nivel

Comprobar las competencias correspondientes a A1, A2, B1 o B2 mediante tareas alineadas con el MCER.

Estas evaluaciones no deben presentarse como certificaciones oficiales.

8.4. Umbral de aprobación

Se planteó inicialmente un 80 % de respuestas correctas en ejercicios cerrados, acompañado de desempeño satisfactorio en tareas comunicativas.

Este porcentaje todavía no está validado ni aprobado como requisito definitivo.

Una puntuación elevada en ejercicios cerrados no debe compensar automáticamente dificultades graves de comprensión o producción.

9. AUDIO NATURAL

Se ha decidido incorporar el audio como componente fundamental del aprendizaje desde A1.

El sistema debe permitir producir:

1. Pronunciación de vocabulario.
2. Pronunciación de frases.
3. Diálogos con voces diferenciadas.
4. Ejercicios de comprensión auditiva.
5. Mensajes, anuncios y situaciones cotidianas.
6. Material para práctica de pronunciación.

9.1. Características deseadas

• Alemán natural.
• Pronunciación correcta.
• Entonación adecuada.
• Pausas naturales.
• Voces consistentes.
• Diferenciación de interlocutores.
• Buena calidad técnica.

9.2. Modalidades propuestas

Natural: conversación con ritmo habitual.

Aprendizaje: pronunciación ligeramente pausada, sin deformar los sonidos.

Repetición: palabras o fragmentos con pausas para practicar.

9.3. Proveedores candidatos

Se mencionaron:

• OpenAI TTS.
• ElevenLabs.
• Azure Neural TTS.
• Google Cloud TTS.

No se ha seleccionado proveedor.

Antes de hacerlo, se recomienda realizar pruebas comparativas con un mismo diálogo, evaluando naturalidad, pronunciación, consistencia y coste.

9.4. Audio en los formatos

En la WebApp, el audio deberá poder reproducirse directamente.

En materiales imprimibles, se propone ofrecer acceso mediante códigos QR o enlaces estables, acompañados de transcripciones cuando corresponda.

10. RECONOCIMIENTO Y EVALUACIÓN DE VOZ

Se ha definido como objetivo incorporar un módulo de práctica oral interactiva.

El estudiante deberá poder:

1. Escuchar una palabra, frase o pregunta.
2. Activar el micrófono.
3. Pronunciar una respuesta.
4. Enviar el audio para análisis.
5. Recibir retroalimentación.
6. Repetir o continuar según el resultado.

10.1. Componentes técnicos

Captura de audio: mediante las capacidades del navegador, por ejemplo MediaRecorder.

Reconocimiento de voz (STT): transcripción del alemán pronunciado.

Evaluación fonética: análisis especializado de pronunciación, ritmo y fluidez.

Retroalimentación pedagógica: transformación de resultados técnicos en instrucciones comprensibles.

10.2. Distinción obligatoria

Reconocer correctamente las palabras no equivale a evaluar correctamente su pronunciación.

El sistema no debe utilizar exclusivamente la coincidencia entre transcripción y frase esperada para decidir si una pronunciación es buena.

10.3. Modalidades de práctica

Repetición: el estudiante escucha y reproduce palabras o frases.

Respuesta guiada: responde preguntas con contenido variable, por ejemplo su nombre.

Conversación: mantiene intercambios con un interlocutor virtual.

La complejidad aumentará progresivamente desde A1 hasta B2.

10.4. Estados de evaluación

Se proponen tres resultados:

• Correcto.
• Necesita practicar.
• No se pudo evaluar.

El último estado es fundamental para distinguir problemas técnicos de errores lingüísticos.

10.5. Reglas de seguridad pedagógica

• No penalizar automáticamente acentos legítimos.
• No exigir imitar exactamente una voz sintética.
• No confundir fallos del micrófono con errores de pronunciación.
• No obligar a repetir indefinidamente.
• Ofrecer ayuda tras varios intentos.
• Permitir marcar contenidos para repaso.
• No presentar puntuaciones fonéticas como verdades absolutas.

10.6. Primer prototipo sugerido

Una WebApp que permita practicar diez frases de A1 y comprobar el funcionamiento de grabación, reconocimiento, evaluación y retroalimentación.

El prototipo debe utilizar audio real y servicios reales para considerarse funcional. Una simulación visual no constituye una validación técnica.

11. ARQUITECTURA DE PRODUCCIÓN CON IA

Se ha propuesto una fábrica editorial asistida por agentes especializados.

Agente 1 — Arquitecto curricular

Responsable de:

• Objetivos de aprendizaje.
• Competencias.
• Prerrequisitos.
• Secuencia curricular.
• Distribución gramatical.
• Distribución de vocabulario.
• Continuidad entre lecciones.

No debe redactar libremente el contenido final ni alterar el currículo aprobado sin autorización.

Agente 2 — Docente y redactor

Responsable de:

• Explicaciones.
• Ejemplos.
• Diálogos.
• Situaciones comunicativas.
• Claridad pedagógica.
• Adaptación a hispanohablantes sin formación gramatical.

Agente 3 — Diseñador de actividades

Responsable de:

• Ejercicios graduados.
• Comprensión.
• Recuperación activa.
• Práctica comunicativa.
• Evaluaciones.
• Solucionarios.
• Rúbricas.

Agente 4 — Auditor lingüístico y pedagógico

Responsable de:

• Corrección gramatical.
• Naturalidad del alemán.
• Coherencia curricular.
• Claridad explicativa.
• Calidad de ejercicios.
• Detección de omisiones.
• Correspondencia entre actividades y soluciones.
• Cumplimiento de PED-01 a PED-04.

Componente 5 — Validador determinista

Implementado preferentemente en Python.

Debe comprobar elementos verificables automáticamente, como:

• Estructura.
• Campos obligatorios.
• Identificadores.
• Referencias.
• Dependencias.
• Duplicados.
• Correspondencia entre ejercicios y soluciones.
• Estados editoriales.
• Integridad de archivos.

Los agentes pueden ser funciones especializadas de un mismo modelo. No es obligatorio utilizar cuatro proveedores o cuatro modelos diferentes.

La arquitectura debe separar responsabilidades y permitir sustituir modelos sin reconstruir el sistema.

12. FLUJO EDITORIAL PROPUESTO

Cada lección seguirá el siguiente proceso:

1. Planificación curricular.
2. Redacción pedagógica.
3. Creación de actividades.
4. Auditoría lingüística y pedagógica.
5. Validación técnica.
6. Corrección localizada.
7. Revisión humana.
8. Aprobación.
9. Publicación.

No debe regenerarse una lección completa cuando únicamente falla una sección, salvo que el problema afecte su estructura global.

Los cambios deberán ser trazables.

13. ARQUITECTURA TECNOLÓGICA

Se propuso utilizar inicialmente:

• GitHub como repositorio central.
• Git para versionado.
• Python para validadores y automatización.
• Markdown para contenido editorial.
• JSON o YAML para datos estructurados.
• HTML, CSS y JavaScript para la WebApp.
• SQLite para seguimiento curricular o del estudiante cuando resulte necesario.
• Sistemas TTS y STT para audio.
• Exportadores para PDF y DOCX.

La selección tecnológica es una propuesta, no una obligación absoluta.

Codex puede recomendar alternativas si demuestra ventajas concretas en mantenimiento, portabilidad o simplicidad.

13.1. Fuente única de verdad

Debe existir una representación estructurada del contenido desde la cual puedan generarse:

• Lecciones digitales.
• Material imprimible.
• Ejercicios interactivos.
• Solucionarios.
• Glosarios.
• Tarjetas de vocabulario.
• Recursos de audio.

No deben mantenerse manualmente dos versiones independientes de una misma lección.

13.2. Estructura inicial sugerida

deutsch-learning-system/
├── docs/
│   ├── specification/
│   ├── architecture/
│   └── decisions/
├── curriculum/
│   ├── competencies/
│   ├── grammar/
│   ├── vocabulary/
│   └── lessons/
├── agents/
│   ├── curriculum/
│   ├── teacher/
│   ├── activities/
│   └── auditor/
├── content/
│   ├── A1/
│   ├── A2/
│   ├── B1/
│   └── B2/
├── schemas/
├── validators/
├── exporters/
├── audio/
├── web/
├── tests/
└── README.md

Esta estructura es orientativa. No está aprobada como arquitectura definitiva.

14. CONTROL DE CALIDAD

El sistema debe aplicar las siguientes reglas:

Una sola fuente de verdad: los agentes no pueden alterar silenciosamente decisiones curriculares aprobadas.

Separación entre contenido y presentación: el diseño visual no debe condicionar la corrección pedagógica.

Versionado: toda modificación importante debe quedar registrada.

Pruebas de regresión: los cambios en plantillas, agentes o validadores no deben romper contenidos aprobados.

Producción incremental: no generar las 160 lecciones de una vez.

Revisión humana: el sistema de IA no puede considerarse único responsable de aprobar la calidad lingüística y pedagógica.

14.1. Clasificación de incidencias

Se recomienda registrar:

• Errores lingüísticos.
• Errores pedagógicos.
• Omisiones curriculares.
• Redundancias.
• Ejercicios ambiguos.
• Soluciones incorrectas.
• Referencias inexistentes.
• Fallos estructurales.
• Problemas de audio.
• Errores de evaluación oral.

15. CRITERIOS DE ACEPTACIÓN DE LA FASE 1

La especificación pedagógica deberá cumplir:

ESP-01: Alcance definido: A1–B2, 160 lecciones.

ESP-02: Público definido: hispanohablantes desde los 14 años.

ESP-03: Ningún idioma previo requerido.

ESP-04: Ningún conocimiento formal de gramática requerido.

ESP-05: Modalidad de aprendizaje autónomo.

ESP-06: Sesiones de 60 minutos como referencia editorial.

ESP-07: Competencias lingüísticas identificadas.

ESP-08: Principios pedagógicos documentados.

ESP-09: Modelo inicial de lección establecido.

ESP-10: Evaluación por lección, bloque y nivel contemplada.

ESP-11: Producción digital e imprimible desde una fuente común.

ESP-12: Audio incorporado al diseño desde A1.

ESP-13: Práctica oral interactiva contemplada.

ESP-14: Limitaciones técnicas y pedagógicas documentadas.

ESP-15: Criterios PED-01 a PED-04 incorporados.

ESP-16: Diferenciación entre decisiones aprobadas y propuestas pendientes.

La especificación debe quedar consolidada antes de comenzar la producción curricular.

16. PLAN DE DESARROLLO

Fase 1 — Especificación pedagógica

Definir objetivos, público, modalidad, metodología, evaluación, accesibilidad y requisitos multimedia.

Estado: en desarrollo.

La versión v1.0 fue propuesta y posteriormente ampliada con los requisitos de accesibilidad lingüística de la v1.1.

La conversación también incorporó requisitos de audio y evaluación oral que deben consolidarse en la siguiente revisión.

Fase 2 — Investigación curricular

Investigar y documentar referencias como:

• MCER y su volumen complementario.
• Descriptores de competencias.
• Goethe-Institut.
• Modelos de examen pertinentes.
• Referencias didácticas reconocidas.

Crear la matriz de competencias A1–B2.

No inventar referencias ni afirmar alineación curricular sin evidencia.

Fase 3 — Diseño del temario

Distribuir competencias en las 160 lecciones.

Definir:

• Objetivos.
• Prerrequisitos.
• Contenidos.
• Vocabulario.
• Gramática.
• Habilidades.
• Evaluaciones.
• Dependencias.

Fase 4 — Contrato editorial

Diseñar y aprobar la plantilla de lección y las reglas de redacción.

Fase 5 — Motor de producción

Implementar agentes, esquemas de datos, validadores y pruebas.

Fase 6 — Lección piloto

Producir A1-001.

Auditar, corregir y comprobar la calidad.

Fase 7 — Bloque piloto

Producir A1-002 a A1-005.

Comprobar progresión, continuidad y acumulación de conocimientos.

Fase 8 — Producción controlada

Escalar gradualmente hacia las 160 lecciones.

Fase 9 — Plataforma interactiva

Implementar la experiencia web, los ejercicios, el audio y la evaluación oral.

Esta secuencia es orientativa. Pueden desarrollarse prototipos técnicos de audio o interfaz en paralelo, siempre que no alteren el currículo ni retrasen su validación.

17. DECISIONES PENDIENTES

No considerar aprobados los siguientes elementos:

1. Distribución definitiva de contenidos por nivel.
2. Temario de las 160 lecciones.
3. Estructura editorial exacta.
4. Número de ejercicios por lección.
5. Umbrales de evaluación.
6. Selección del proveedor TTS.
7. Selección del proveedor STT.
8. Motor de evaluación fonética.
9. Arquitectura definitiva de la WebApp.
10. Esquema de base de datos.
11. Sistema de cuentas y progreso.
12. Formato definitivo de archivos.
13. Política de almacenamiento y privacidad de grabaciones.
14. Presupuesto operativo de servicios de IA.
15. Criterios de publicación automatizada.
16. Evaluación externa de la calidad pedagógica.

También se han propuesto, sin aprobación definitiva:

• Hochdeutsch contemporáneo como variedad de referencia.
• Contextos culturales relacionados con la vida cotidiana en Alemania.
• Evaluaciones diagnósticas y finales.
• Repasos complementarios fuera de las 40 lecciones principales.

18. INSTRUCCIONES ESPECÍFICAS PARA CODEX

Estás trabajando en un repositorio GitHub inicialmente vacío.

Tu función inicial no es producir lecciones ni desarrollar una WebApp completa.

Tu primera responsabilidad es establecer una base documental y técnica coherente, verificable y mantenible.

Reglas de trabajo

1. No recuperar ni reutilizar automáticamente contenido del proyecto anterior.
2. Considerar este documento como contexto inicial.
3. Diferenciar decisiones confirmadas, propuestas y cuestiones pendientes.
4. No inventar decisiones pedagógicas.
5. No generar las 160 lecciones anticipadamente.
6. No crear funcionalidades complejas antes de establecer sus requisitos.
7. Mantener los documentos maestros versionados.
8. Registrar decisiones arquitectónicas relevantes.
9. Priorizar simplicidad, mantenibilidad y pruebas.
10. No introducir dependencias innecesarias.
11. No almacenar credenciales en el repositorio.
12. No declarar funcionalidades como operativas sin pruebas reales.
13. Solicitar aprobación antes de modificar requisitos pedagógicos fundamentales.
14. Mantener una documentación clara y comprensible en español.

Primera tarea solicitada

Analiza este documento y prepara la base inicial del proyecto.

Realiza lo siguiente:

1. Inspecciona el repositorio y confirma su estado.
2. Propón una estructura mínima y escalable.
3. Crea un README que explique el propósito y el estado del proyecto.
4. Consolida la especificación pedagógica en una versión 1.2, incorporando los requisitos de audio y evaluación oral.
5. Crea un registro de decisiones confirmadas y pendientes.
6. Define criterios de aceptación verificables para la Fase 1.
7. Propón el esquema de datos mínimo necesario para representar competencias, conceptos, lecciones y actividades.
8. Prepara una hoja de ruta de implementación por fases.
9. Añade un documento de instrucciones para agentes de Codex que establezca las reglas del proyecto.
10. Ejecuta las comprobaciones disponibles y reporta los resultados.

No desarrolles todavía el motor completo de agentes, la WebApp ni las 160 lecciones.

Al finalizar, presenta:

• Archivos creados.
• Estructura del repositorio.
• Decisiones implementadas.
• Supuestos utilizados.
• Validaciones ejecutadas.
• Riesgos identificados.
• Cuestiones que requieren aprobación.
• Próximo paso recomendado.

Resultado esperado

Un repositorio inicial documentado, ordenado y preparado para continuar con la investigación curricular, sin repetir los errores metodológicos del proyecto anterior.

19. PRINCIPIO RECTOR

El proyecto no busca producir 160 documentos de alemán mediante inteligencia artificial. Busca construir un sistema educativo capaz de generar, evaluar, mantener y distribuir 160 lecciones de calidad verificable.

La tecnología debe servir a la pedagogía, no sustituirla.

La calidad del aprendizaje tiene prioridad sobre la velocidad de generación, la cantidad de texto y la sofisticación visual.

FIN DEL DOCUMENTO DE TRANSFERENCIA.