memory del curso

Memoria · Readme

memory/ — Memoria del curso

Fuente de verdad del estado del curso. Cualquier agente (o humano) que tome el hilo debe leer esto antes de impartir nada, y actualizarlo al terminar cada sesión.


Protocolo para agentes (léelo completo)

1. Antes de impartir

  1. Lee memory/course-state.json → lección actual, siguientes, progreso por módulo.
  2. Lee memory/progress-log.md → contexto de la última sesión (máx. las 2 últimas entradas).
  3. Lee memory/student-profile.md → stack, nivel, proyecto y preferencias del alumno.
  4. Si hay entradas en memory/pending.md, tenlas presentes (repasos, dudas abiertas).
  5. Consulta CURRICULUM.md para ver la posición en el mapa general.
  6. Confirma al alumno en una frase dónde retomas el hilo antes de empezar.

2. Cómo impartir una lección

  • Lee la lección existente en lessons/NN-nombre/ antes de modificarla; conserva su estilo.
  • Estructura obligatoria: lesson.md (teoría + objetivos + autoevaluación),

exercises.md (enunciados), solutions.md (soluciones completas y comentadas).

  • Adapta todo el código al stack del alumno (student-profile.md).
  • Los ejercicios se entregan en el chat; el profesor los corrige y actualiza estado.
  • No avances de lección sin que la anterior esté al menos (impartida y ejercicios entregados).

Si el alumno pide saltar, regístralo en decisions.md como decisión pedagógica.

  • Registra siempre los trade-offs y por qué (es parte del temario, se predica con el ejemplo).

3. Al terminar una sesión (obligatorio)

  1. course-state.json: actualiza currentLesson, nextLesson, lessonsCompleted,

la entrada del módulo correspondiente y lastSession.

  1. progress-log.md: añade entrada arriba, con formato de las existentes

(fecha, qué se hizo, cómo fue el alumno, siguiente paso).

  1. pending.md: mueve a resueltas las dudas cerradas; añade las nuevas

(repasos, errores recurrentes, ejercicios sin corregir).

  1. student-profile.md: solo si cambió algo relevante (nuevo conocimiento previo, proyecto, ritmo).
  2. decisions.md: añade ADR solo si tomaste una decisión pedagógica o técnica con impacto.

4. Reglas de oro

  • No contradigas course-state.json con el chat: si difieren, gana el JSON y corrige el chat.
  • La memoria es para continuar el curso sin preguntar al alumno lo que ya contestó.
  • No borres entradas antiguas del progress-log.md: es la historia del curso.
  • Escribe SIEMPRE en español (o el idioma que el alumno esté usando).
  • Si el alumno pide algo fuera del temario, impártelo igual y regístralo en decisions.md.

Archivos

ArchivoContenidoCuándo actualizarlo
course-state.jsonEstado exacto: lección actual, progreso por módulo, proyectoCada sesión
student-profile.mdStack, nivel, objetivo, preferencias, proyectoCuando cambie algo
progress-log.mdBitácora cronológica de sesionesCada sesión
decisions.mdADRs de decisiones pedagógicas/técnicasSolo con decisiones nuevas
pending.mdDudas abiertas, repasos, correcciones pendientesCada sesión

Ejemplo de entrada en progress-log.md

markdown
## 🗓️ 2026-09-28 — Sesión 1
**Qué se hizo:** Lección 00: stack definido (Node+NestJS), proyecto elegido (API de biblioteca), entorno montado.
**Cómo fue el alumno:** motivado, le costó la parte de Git.
**Siguiente paso:** Lección 01 (HTTP a fondo).