NourEldinShobier/course

Teach Me: espacio de trabajo del curso

El usuario quiere aprender algo durante muchas sesiones. La carpeta actual es el espacio de trabajo. Las rutas del espacio de trabajo se resuelven desde la carpeta actual; <plugin> es la carpeta dos niveles por encima del directorio base de este skill. Las lecciones usan el runtime Teach Me y los pasos 2-6 del skill learn (<plugin>/skills/learn/SKILL.md).

El diseño sigue el skill teach de Matt Pocock (MIT), por lo que cualquiera de las dos herramientas funciona en la misma carpeta.

MISSION.md            por qué el usuario está aprendiendo esto          <plugin>/references/workspace/MISSION-FORMAT.md
RESOURCES.md          fuentes verificadas: conocimiento, comunidades, brechas   RESOURCES-FORMAT.md
GLOSSARY.md           términos que el usuario ha usado correctamente       GLOSSARY-FORMAT.md
NOTES.md              las preferencias del usuario, tus notas de trabajo, metáforas ya utilizadas
learning-records/     0001-slug.md: evidencia de lo que sabe   LEARNING-RECORD-FORMAT.md
lessons/              0001-slug.src.html -> 0001-slug.html (+ notas)
reference/            hojas de referencia: compactas, imprimibles, revisitadas a menudo
queue.json            episodios o capítulos a trabajar
review.src.html       todas las flashcards de todas las lecciones, las vencidas primero
sources/              transcripciones y texto de capítulos (añadir a .gitignore)

Cada sesión

1. Lee el estado: MISSION.md, NOTES.md, los registros de aprendizaje más recientes, queue.json. Si no hay MISSION.md, entrevista primero al usuario (por qué, cómo es el éxito, fecha límite, nivel actual, restricciones) y escríbelo con la forma del archivo de formato. Cambiar la misión más tarde requiere confirmación del usuario y un registro de aprendizaje.
2. Recursos: hasta que RESOURCES.md tenga algunas entradas de alta confianza, encontrarlas es la prioridad (documentación oficial, libros de texto estándar, el curso en sí, una o dos comunidades para sabiduría). Poda sin piedad.
3. Calentamiento: comienza con dos preguntas de recuperación en el chat de lecciones anteriores (no del material de hoy). Menciona cuántas flashcards están vencidas y ofrece review.html.
4. Elige la lección: la solicitud del usuario, si no, el siguiente elemento queued, si no, lo más útil en su zona de desarrollo próximo según los registros y la misión.
5. Enseña una cosa: construye lessons/NNNN-slug.src.html (siguiente número), siguiendo los pasos 2-6 del skill learn, pero construye en el espacio de trabajo: bun <plugin>/scripts/build.ts lessons/NNNN-slug.src.html luego bun <plugin>/scripts/check.ts lessons/NNNN-slug.html. Enlaza la lección anterior y siguiente, y la hoja de referencia relevante. Reutiliza exactamente los términos del glosario. No reutilices una metáfora listada en NOTES.md; añade la nueva allí.
6. Cierre: actualiza la cola, añade las tarjetas de la lección a review.src.html (un componente cards por mazo, con los mismos deck e ids de tarjeta que la lección para que los horarios se trasladen) y reconstruye. Cada tercera lección, o cuando se solicite, destila una hoja de referencia en reference/.
7. Registros: cuando el usuario pegue progreso de una lección o muestre comprensión en el chat, escribe registros solo por evidencia (ver <plugin>/references/pedagogy.md). Promueve los términos del glosario que el usuario haya usado correctamente.

Trabajando con un curso o un libro

queue.json:

{"source": {"kind": "udemy|youtube|book", "title": "…", "url": "…", "file": "…", "courseId": "…"},
 "items": [{"id": "lecture-or-chapter-id", "title": "…", "section": "…", "status": "queued|taught|skipped", "lesson": "lessons/0004-….html"}]}

• Construye la cola una vez a partir del plan de estudios o tabla de contenidos (<plugin>/references/inputs.md: endpoint del plan de estudios de Udemy, yt-dlp -J para una lista de reproducción, esquema PDF o espina EPUB). Omite introducciones, finales, promos y cuestionarios por defecto; pregunta una vez si no estás seguro.
• Un elemento por lección. Obtén solo los subtítulos de ese episodio o el texto de ese capítulo, cuando lo enseñes. Nunca precargues todo un curso.
• "siguiente" significa el siguiente elemento queued. El usuario también puede nombrar un elemento o un rango ("lecciones 12-14 como una lección", "solo el capítulo 3, sección 2").
• Las lecciones de episodio o capítulo usan el formato notes (técnico) o el formato practice (habilidades blandas, vida, no ficción): un resumen breve y legible en términos del usuario, la idea central como figura, lo que el instructor o autor enfatiza, errores comunes, un cuestionario y tarjetas. Añade "dónde encaja esto" enlazando a lecciones anteriores. Para cursos estilo AWS, prefiere un diagram con un rastro de solicitud y una pregunta "¿qué falla si"; anota los hechos relevantes para el examen en un callout cuando el curso apunte a una certificación.
• Cita la lección o capítulo (título, número, marca de tiempo o página) en el pie de página de fuentes. Parafrasea; nunca pegues transcripciones o pasajes largos en las lecciones.

Sesiones de enseñanza inversa

Cuando el usuario dice "ponme a prueba" o "déjame explicarte": ellos explican primero en el chat; tú encuentras la(s) una o dos lagunas más pequeñas, haz una pregunta sobre cada una (socrática) y da la respuesta después de dos intentos. Registra sus propias palabras cuando acierten.