# Unidad Moodle Forge > Genera el material didactico completo de una unidad para el aula virtual Moodle de TUP (tup.sied.utn.edu.ar) a partir del programa de la materia o apuntes: un archivo HTML por cada bloque real de cada sub-seccion (Introduccion, Actividades, Practica, Microteaching, Autoevaluacion, Encuesta de cierre) -nunca un unico HTML con varios bloques pegados-, preguntas en formato XML de Moodle para importar (5 por actividad, 10 en autoevaluacion), el prompt para Gamma que resuelve el Material de apoyo de cada actividad, el documento y PDF de Lectura obligatoria de cada actividad, los guiones y el render automatizado (via la skill hyperframes) de los videos de cada actividad, guiones para generar los Notebooks LM de cada actividad, el guion del video de introduccion de la unidad (generado al cierre, coherente con el contenido ya completo), la consigna y el PDF del Trabajo Practico Integrador, y -al final del proceso- el material de Evaluaciones (parciales/recuperatorios) a nivel curso. Tambien genera, bajo pedido explic - Skill: `juancruzrobledo/unidad-moodle-forge` (Agent Skill, multi-file: 6 files) - Install (CLI): `npx skillmds@latest add juancruzrobledo/unidad-moodle-forge` - Raw SKILL.md: https://api.skillmd.com/api/skills/juancruzrobledo/unidad-moodle-forge/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Web & Frontend - License: Apache-2.0 - Author: juancruzrobledo (https://skillmd.com/u/juancruzrobledo) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/juancruzrobledo/unidad-moodle-forge --- # Unidad Moodle Forge Convierte el programa de una materia (o los apuntes que le pases) en el material completo de una unidad del aula virtual, calcando la estructura real del campus TUP: no la que "se supone" que tiene una unidad, sino la que confirmamos recorriéndolo en vivo. El principio que ordena todo: **generar es barato, pero publicar contenido pedagógico mal fundamentado es caro** — por eso cada bloque parte de material real que aportó el usuario (nunca se inventan resultados de aprendizaje o consignas de la nada), y los pasos irreversibles o que dependen de una herramienta externa (PDF, NotebookLM, Gamma, la skill `hyperframes` para video) esperan confirmación explícita antes de ejecutarse. ## Cuándo aplica El usuario es docente/tutor de una materia en el campus TUP y quiere producir el contenido de una unidad completa (o retomar una a medio hacer) a partir de: el programa de la materia, apuntes propios, un PDF de cátedra, o simplemente el nombre del tema. No tiene por qué traer todo listo — puede pedir "armá la unidad 2 de CSS" y vos completás con el patrón ya validado contra el aula real, pidiendo solo lo que no se pueda derivar razonablemente (ej. el tema puntual de cada actividad si no lo aportó). ## Workflow — 7 fases + 2 extensiones opcionales + cierre + retrofit + presentación general ``` 0. Relevar estado → qué unidad/sub-sección falta (lee estado.yml); si es unidad NUEVA, preguntar qué componentes opcionales incluir 1. Introducción → 3 HTML separados: 00-descripcion-seccion, banner-foro, hoja-de-ruta (el video de introducción se resuelve al CIERRE, ver abajo) 2. Actividades → 00-descripcion-seccion + por actividad, EN ORDEN DE DEPENDENCIA: actividad-N.html + cuestionario-actividad-N.html → Material de apoyo (prompt Gamma) → Lectura PDF (documento + PDF) → XML (5 preguntas) → Videos de actividad (3, on-demand) → guion NotebookLM (recién con todo lo anterior generado) 3. Práctica (TP) → documento PDF con membrete *bajo aprobación* → entrega HTML → consigna HTML (+ 00-descripcion-seccion) 4. Microteaching → 2 HTML separados: 00-descripcion-seccion + 01-contenido-microteaching (1 solo Label) — opcional 5. Autoevaluación → 00-descripcion-seccion + cuestionario-autoevaluacion (Descripción del Quiz, sin Label) + XML (10 preguntas) — opcional 6. Encuesta de cierre → 2 HTML separados (00-descripcion-seccion + descripción) — opcional Cierre de unidad → guion-video-introduccion.md, recién ahora (ver "Cierre de la unidad") 7. (final, opcional) → Evaluaciones y Trabajo Práctico Integrador (curso-level) 8. (opcional, bajo pedido explícito) → Importación del material generado al aula real de Moodle 9. (opcional, bajo pedido explícito) → Completar pendientes en una unidad ya generada (retrofit) 10. (opcional, una vez por materia) → Presentación General del curso (pestaña "[Materia] - General", section=0, siempre la primera del aula real — ver más abajo) ``` Las fases 1 a 6 son por unidad y se repiten unidad tras unidad. La fase 7 es **aparte**: solo se dispara cuando el usuario la pide explícitamente y después de que las unidades estén encaminadas — no se mezcla con el material de unidad porque vive en secciones de curso distintas (`Evaluaciones` y `Trabajo Practico Integrador`, no `Autoevaluación` ni `Práctica`). La fase 8 es **todavía más aparte**: opera sobre material que ya está `generado`/`confirmado` en el filesystem y lo sube al aula real vía browser automation — nunca se dispara sola, siempre bajo pedido explícito del usuario y después de pasar las precondiciones de seguridad (ver Fase 8). La fase 9 es igual de aparte: opera sobre una unidad que ya tiene material `generado` (o incluso ya `importado`) y solo completa lo que falta, nunca se dispara sola (ver Fase 9). La fase 10 es, como la 7, curso-level y aparte de la jerarquía de unidades — a diferencia de todas las anteriores, se genera **una sola vez por materia** (no una vez por unidad) y modela la pestaña que en el aula real siempre aparece primera, antes que la Unidad 1 (ver Fase 10). **Regla de generación que aplica a las Fases 1-6**: nunca generes un único HTML con varios bloques (`
`) de nivel superior pegados uno atrás del otro. Cada bloque de `references/plantillas-html.md` es un componente independiente en Moodle (una sección/sub-sección, un Label, o la descripción de un cuestionario) — generalo como su propio archivo, siguiendo el nombre que indica esa referencia junto a cada bloque (`→`). Esto no es un capricho de organización: así es como se mapea 1:1 contra el aula real (ver `references/estructura-aula-real.md`), y es lo que la Fase 8 necesita para poder pegar cada archivo en el lugar correcto sin tener que adivinar dónde corta un bloque y empieza el siguiente. **Nunca generes el PDF de la Práctica sin que el usuario haya confirmado antes que el documento (`documento-practica.html`) está bien.** El PDF es una conversión fiel de ese documento (no un HTML aparte que puede quedar desincronizado) — generarlo antes de la confirmación duplica el trabajo si el documento cambia. Este documento **no es** el bloque `consigna-practica.html` que va en la página de Moodle — son dos archivos distintos, ver Fase 3. ## Fase -1 — Configuración de la skill (una vez por máquina, no por proyecto) Antes de la Fase 0, chequeá si existe `.env` en la raíz de la skill (no lo leas con tus herramientas de archivo — hay una política global que bloquea Read/Edit sobre `.env`/`.env.*`, así que ni vas a poder aunque quieras; esto es a propósito, para que una API key nunca termine expuesta en una conversación con el agente). Para saber si existe sin leer su contenido, alcanza con listar el directorio (`ls`/`Glob`). - Si **no existe** `.env`: es la primera vez que se usa esta skill en esta máquina. Avisale al usuario que puede correr `python scripts/configurar.py` (una sola vez, en su propia terminal — no se lo pidas vos por Bash si necesita tipear la API key, porque `getpass` no la va a ocultar bien en una terminal no interactiva) para activar automatizaciones y configuraciones opcionales (hoy: generación directa del Material de apoyo vía la API de Gamma, imagen del encabezado de los PDF con membrete — Práctica/Lectura/Evaluaciones/TPI, sin foto por default —, y subida automatizada de videos a YouTube). Si el usuario no quiere configurarlo ahora, seguí normalmente — todo funciona igual en modo manual/default, esto es puramente opcional. - Si **ya existe** `.env`: no preguntes de nuevo. Cuando la Fase 2 llegue al paso de Material de apoyo, dejá que el script correspondiente (`scripts/gamma_generate.py`) lea `GAMMA_AUTOMATIZADO`/`GAMMA_API_KEY`/`GAMMA_THEME_ID` por su cuenta vía `python-dotenv` — vos nunca leas esos valores directo. Lo mismo para `scripts/render_pdf.py`, que lee `PDF_HEADER_LOGO` para saber si el encabezado de los PDF con membrete lleva una imagen (vacío/no configurado = sin imagen, el default) — ver `references/plantilla-pdf-practica.md` § Generar el PDF. Y para la subida de videos: si `YOUTUBE_AUTOMATIZADO=true`, `scripts/youtube_upload.py` toma sus credenciales solo (ver `references/automatizacion-subida-youtube.md` para el setup completo, que sí requiere pasos manuales del usuario en Google Cloud Console la primera vez — a diferencia de Gamma, esto no se resuelve solo con `configurar.py`). Este paso es agnóstico del proyecto/materia: se resuelve una vez por instalación de la skill, no se repite por cada unidad ni por cada materia. ## Fase 0 — Relevar estado Antes de escribir nada, buscá `estado.yml` en la raíz de la carpeta de la materia (ver esquema completo en `references/estado-yml-schema.md`). Si no existe, es la primera unidad: creala con `scripts/scaffold_unidad.py`. Si existe, leelo para saber qué sub-secciones de qué unidad ya están `generado`, `confirmado` o `pendiente` — así no repetís trabajo ni perdés el hilo entre sesiones. Preguntale al usuario solo por lo que el estado no resuelve (ej. "¿confirmás que el HTML de la Práctica quedó bien para generar el PDF?"). ### Selección de componentes opcionales (solo al crear una unidad NUEVA) Antes de correr `scripts/scaffold_unidad.py` para una unidad que **todavía no existe** en `estado.yml` (nunca al retomar una ya scaffoldeada), preguntale al usuario con `AskUserQuestion` (multiSelect) qué componentes opcionales incluir en esa unidad: **Actividad lúdica**, **Microteaching**, **Material de apoyo por actividad** (prompts para Gamma), **Videos de actividad automatizados** (HyperFrames), **Autoevaluación**, **Encuesta de cierre**. No preguntes esto para unidades que ya tienen `estado.yml` — para esas, el bloque `incluir` (si no existe) se asume todo en `true` por retrocompatibilidad. Pasá la selección como flags al script (`--con-` / `--sin-`, ver el docstring de `scaffold_unidad.py`) — el script la graba en el bloque `incluir` de esa unidad dentro de `estado.yml`. A partir de ahí, cada fase de este documento que dependa de un componente opcional lo chequea ahí antes de generar nada: si está en `false`, esa fase se saltea por completo para esa unidad, sin volver a preguntar. **Heurística de clasificación (por texto, sin necesidad de scrapear nada en cada corrida)**: al leer el programa de la materia, cada unidad/bloque cae en uno de tres destinos según su título u objetivo: - Contiene "Evaluación Integradora", "Examen", "Parcial" → va a la pestaña **Evaluaciones** (Fase 7, `references/plantilla-evaluacion.md`). - Contiene "Proyecto Integrador", "Trabajo Integrador", "Defensa Final" → va a la pestaña **Trabajo Práctico Integrador** (Fase 7, `references/plantilla-tpi-standalone.md`). - Todo lo demás → flujo normal de unidad (Fases 1-6). Esto es puro análisis del texto del programa — no requiere volver a recorrer el aula real cada vez que arranca una unidad nueva. **La Presentación General del curso (Fase 10) es aparte de esta heurística**: no se detecta del texto del programa (no es "una unidad más"), es un artefacto fijo que existe una sola vez por materia. Si estás arrancando una materia nueva desde cero, podés mencionarle al usuario que existe esta opción (siempre conviene tenerla lista temprano, es la primera pestaña que ve el alumno), pero **nunca la generes de oficio** — arranca solo cuando el usuario la pide explícitamente (ver Fase 10). ## Fase 1 — Introducción de la unidad Es la página raíz de la sección de la unidad en Moodle (no una sub-sección aparte — así es como vive en el aula real). Generá los **4 bloques de `references/plantillas-html.md` § Introducción como 4 archivos separados** dentro de `Introduccion/`, en este orden: 1. `00-descripcion-seccion.html` — banner con resultados de aprendizaje (completá 3-5 resultados concretos a partir del material que trajo el usuario). Es la Descripción de la sección raíz de la unidad, no un Label. Generá también la imagen del banner (`URL_DE_LA_IMAGEN`) con el MCP `gemini-nanobanana-mcp`, siguiendo `references/imagen-banner-introduccion.md` **desde el Paso 0** (ofrecerle al usuario 2-4 conceptos visuales distintos del tema real de la unidad y esperar que elija uno — nunca generar directo y mostrar después) — guardala en `Introduccion/imagen-banner-introduccion.png`, forzá el tamaño a 600×600px con `scripts/resize_imagen_banner.py` (obligatorio, el modelo no siempre devuelve ese tamaño), mostrásela al usuario para confirmar, y marcá `introduccion.imagen_banner.status` en `estado.yml`. El `src` del HTML sigue como placeholder hasta que la Fase 8 la suba al aula real. 2. `01-video-introduccion.html` — video colapsable con `URL_DEL_VIDEO_YOUTUBE` como placeholder. **En esta fase generás solo el HTML con el placeholder, no el guion todavía** — el guion de grabación (`guion-video-introduccion.md`) se escribe recién al **cierre de toda la unidad** (después de Fase 6), para que pueda ser coherente con el contenido ya cerrado de Actividades/Práctica/Autoevaluación en vez de anticiparse a un material que todavía no existe. Ver "Cierre de la unidad" más abajo. 3. `02-banner-foro.html` — sección con link al foro de la unidad. 4. `03-hoja-de-ruta.html` — hoja de ruta con la tabla de tiempos Pomodoro (la tabla de tiempos se completa recién al final, cuando ya generaste todas las actividades y sabés cuántos minutos estimar). ## Fase 2 — Actividades Generá `Actividades/00-descripcion-seccion.html` una sola vez por unidad (`references/plantillas-html.md` § Banner principal de la sección de Actividades) — es la Descripción de la sub-sección, no un Label. Por cada actividad (normalmente 3-4, confirmá la cantidad con el usuario si no la trajo), generá **dos archivos separados**, no uno solo: 1. `Actividades/actividad-N/actividad-N.html` — el bloque `
` (`references/plantillas-html.md` § Cuerpo para cada actividad) con sus 3 tarjetas (Infografía con modal+script, Lectura PDF, Asistente IA). Este es el Label de la actividad — **no le pegues el bloque de Cuestionario abajo**, va aparte (siguiente punto). 2. `Actividades/actividad-N/cuestionario-actividad-N.html` — el bloque "Cuestionario de la Actividad" (`references/plantillas-html.md` § Descripción para cada cuestionario). No es un Label: es el contenido que va en el campo Descripción del `mod_quiz` de esa actividad. Generá también el XML de exactamente 5 preguntas para importar al banco de Moodle (`scripts/generar_pregunta_xml.py` + `references/formato-preguntas-moodle-xml.md`; seguí la convención de códigos de pregunta vista en el aula real, ej. `TEMA 1`.. `TEMA 5`). ### Cadena de dependencias por actividad: Material de apoyo → Lectura PDF → Videos → NotebookLM Los 3 recursos de la actividad que hoy quedan como placeholder (`URL_PDF`, `URL_VIDEO_1/2/3`, `URL_IA_NOTEBOOKLM`) **no se generan en cualquier orden** — cada uno depende de que el anterior ya esté al menos planificado, para no inventar contenido ni duplicarlo entre documentos. Solo corré este bloque si `incluir.material_apoyo`/`incluir.videos_actividad` de la unidad (ver Fase 0) lo habilitan. 3. **Material de apoyo** (si `incluir.material_apoyo`): escribí el/los prompt(s) para Gamma que van a generar la carpeta "Material de apoyo – Actividad N" (1 o más documentos, según lo que necesite la actividad — ver `references/prompt-gamma-material-apoyo.md`). Guardá el prompt en `Actividades/actividad-N/material-apoyo/prompt-gamma-N-K.md` y marcá `material_apoyo.prompts[K].prompt_status: generado` en `estado.yml`. Después, según cómo esté configurada esta máquina (`.env`, ver Fase -1): si `GAMMA_AUTOMATIZADO=true`, corré directo `scripts/gamma_generate.py` para generar el PDF sin preguntar; si no, el entregable es el texto del prompt para que el usuario lo pegue a mano en Gamma. En los dos casos el resultado se revisa antes de darlo por bueno. 4. **Lectura PDF**: con el contenido del Material de apoyo ya planificado (no hace falta que el usuario ya lo haya corrido en Gamma, alcanza con que el prompt exista), escribí `documento-lectura-actividad-N.html` (documento sobrio con membrete, ver `references/plantilla-pdf-lectura.md`) cubriendo el contenido núcleo/obligatorio de la actividad sin repetir lo que ya va a cubrir el Material de apoyo. **Mostraselo al usuario y esperá su confirmación explícita antes de correr `scripts/render_pdf.py --materia ""`** — mismo gate que la Práctica (`lectura_pdf.pdf_confirmado_por_usuario` en `estado.yml`). 5. **Videos de actividad** (si `incluir.videos_actividad`): los 3 videos de la actividad se generan **on-demand**, cuando el usuario pida avanzar esa actividad puntual — nunca en lote automático para varias actividades/unidades. Ver `references/automatizacion-videos-actividad.md` para el guion, la invocación de la skill `hyperframes`, y por qué se prefiere ese mecanismo al video nativo de NotebookLM. Marcá `videos[K].guion_status` y `render_status` en `estado.yml` a medida que avanza cada video. Una vez renderizado el `.mp4`, la subida a YouTube tiene el mismo patrón que Gamma: por default el usuario lo sube a mano y te devuelve la URL real (`videos[K].url_subida` + `url`); existe un camino opcional automatizado vía la YouTube Data API v3 si el usuario ya configuró credenciales — ver `references/automatizacion-subida-youtube.md` (incluye la regla del título real que sube a YouTube, distinta del texto del link en el HTML, y por qué la organización en playlists nunca se asume). 6. **Guion de NotebookLM**: generá `references/notebooklm-guion.md` (guion/fuente de la actividad) **solo cuando** Material de apoyo y Lectura PDF estén como mínimo `generado` y los 3 videos tengan `guion_status: generado` (no hace falta que estén renderizados) — el paquete de fuentes de NotebookLM lista esos archivos reales, así que generarlo antes documentaría fuentes que no existen. **Nunca crees el notebook vos**: NotebookLM no tiene API pública, así que tu entregable es el guion/fuente listo para pegar, y el link de la tarjeta "Asistente IA" queda como placeholder hasta que el usuario lo suba a mano y te devuelva la URL real. Si `incluir.actividad_ludica` está en `true` y el tema se presta, sumá una Actividad Lúdica como `Actividades/actividad-ludica.html` (mismo archivo de referencia, bloque separado, un único Label — no trae Cuestionario aparte). ## Fase 3 — Práctica / Trabajo Práctico Acá se generan **cuatro archivos distintos**, no uno solo, y **en este orden** — no es arbitrario: el formato de entrega (punto 3) describe qué se entrega, y eso recién se sabe con precisión una vez que la consigna completa (punto 2) está escrita; el resumen para la página de Moodle (punto 4) linkea al PDF ya generado, así que necesita que el PDF ya exista. 0. **`Practica/00-descripcion-seccion.html`** — el banner "Trabajo Práctico – [Unidad]" (`references/plantillas-html.md` § Banner principal de la sección). Es la Descripción de la sub-sección Práctica, no un Label — podés generarlo apenas sepas el nombre de la unidad, no depende de los otros tres. 1. **`documento-practica.html`** — PRIMERO. El documento completo con membrete institucional que el alumno descarga como PDF desde la pestaña Práctica. Es un documento sobrio (sin tarjetas ni degradés del resto del aula), con estructura tipo TP real de cátedra: Objetivo general, Marco teórico (opcional), y el cuerpo de la consigna — que puede ser un **Caso Práctico** con pasos numerados (TP de código/procedimental), **preguntas de análisis por sección temática** (TP de reflexión/teoría), o una combinación de ambos según lo que pida el TP real — cerrando con Consideraciones y Conclusiones esperadas. Ver `references/plantilla-pdf-practica.md` para la plantilla completa y cuándo usar cada bloque. Mostraselo al usuario y **esperá su confirmación explícita antes de correr `scripts/render_pdf.py`** sobre ese archivo, pasando `--materia ""` para que agregue el membrete (logo UTN + institución en el encabezado, barra de color + número de página en el pie, repetidos en cada hoja vía `header_template`/`footer_template` de Playwright — no se duplican a mano en el HTML). Recién ahí generás el PDF fiel. Actualizá `estado.yml` marcando `documento_html_status` y, tras la confirmación, `pdf_status` como generado. 2. **`entrega-practica.html`** — SEGUNDO, ya con la consigna confirmada a mano. El bloque de formato de entrega, usando la variante correcta según la carrera/materia: Python de archivo único (Programación 1), o estructura de paquetes en Java (Programación 2/3) — las 3 variantes están en `references/plantillas-html.md` § Trabajo Práctico. Necesita la consigna ya escrita porque describe qué archivo(s) exactos entrega el alumno (nombre del TP, cantidad de fichas/archivos, etc.), no se puede redactar bien antes. Este archivo va en la Descripción de la Tarea (`mod_assign`) de entrega. 3. **`consigna-practica.html`** — TERCERO. El bloque `
` que va en la página de Moodle (resumen breve del TP) — **solo ese `
`, sin el banner** (el banner ya salió aparte en el punto 0). Con el documento PDF (punto 1) ya generado, este bloque es un resumen corto con un link de descarga al PDF, no la letra completa del TP. Es un Label independiente. ## Fase 4 — Microteaching (opcional) Solo si `incluir.microteaching` está en `true` para esta unidad (ver Fase 0) — hay materias/aulas donde esta sub-sección directamente no se usa. Generá **dos archivos** dentro de `Microteaching/` (`references/plantillas-html.md` § Microteaching): 1. `00-descripcion-seccion.html` — banner de la sub-sección (Descripción, no Label). 2. `01-contenido-microteaching.html` — la tarjeta introductoria ("Material de la Microteaching") **y** el contenido con el link al video de microteaching y al repositorio de código, concatenados en ese orden dentro del mismo archivo. A diferencia del resto de las sub-secciones, acá los dos bloques de la plantilla van juntos en **un solo Label** — confirmado contra un curso real bien armado (esa sub-sección solo tiene un Label además de la Descripción de sección). Es la sección más liviana — no tiene NotebookLM ni preguntas. ## Fase 5 — Autoevaluación (opcional) Solo si `incluir.autoevaluacion` está en `true` para esta unidad (ver Fase 0). Generá **dos archivos separados**: 1. `Autoevaluacion/00-descripcion-seccion.html` — banner, Descripción de la sub-sección (no un Label). 2. `Autoevaluacion/cuestionario-autoevaluacion.html` — descripción del cuestionario (casi fija entre unidades, solo cambia el nombre de la unidad). **No es un Label**: esta sub-sección no tiene ningún Label — va directo al campo Descripción del `mod_quiz` de Autoevaluación (con "Mostrar descripción en la página del curso" activado), igual que `cuestionario-actividad-N.html` en Actividades. Confirmado contra un curso real bien armado: esa sub-sección solo tiene el módulo Cuestionario, nada más. Mismo patrón que Actividades para las preguntas, pero con **exactamente 10 preguntas** en el XML (`scripts/generar_pregunta_xml.py`), reutilizando o extendiendo el banco de preguntas de las actividades de la misma unidad (en el aula real comparten banco: los códigos de autoevaluación son un superset de los de actividades). ## Fase 6 — Encuesta de cierre (opcional) Solo si `incluir.encuesta_cierre` está en `true` para esta unidad (ver Fase 0). Generá `EncuestaCierre/00-descripcion-seccion.html` (banner, Descripción de la sub-sección) y `EncuestaCierre/01-encuesta-cierre.html` (descripción de la encuesta, va en la Descripción del `mod_feedback` existente) como **dos archivos separados** — el contenido no cambia entre unidades salvo el nombre de la unidad en el banner. No hace falta pedirle nada al usuario acá. Al importar (Fase 8), renombrá la Encuesta existente con el patrón `💬 Tu opinión nos interesa 🌟 U` (ver `references/plantillas-html.md` § Encuesta de cierre) — no dejes el nombre genérico del template reciclado. ## Cierre de la unidad — guion del video de Introducción Recién ahora, con Actividades, Práctica y (si aplican) Autoevaluación/Encuesta de cierre ya generadas, escribí `Introduccion/guion-video-introduccion.md` — guion de grabación de 4-6 minutos (gancho, desarrollo, cierre) para que el usuario lo grabe cuando pueda. Generarlo acá y no en la Fase 1 es intencional: así el guion puede referenciar el contenido real y ya cerrado de toda la unidad (qué actividades tiene, qué logra el TP) en vez de anticiparse a un material que todavía no existía. Marcá `introduccion.video_guion_status: generado` en `estado.yml`. El HTML (`01-video-introduccion.html`, ya generado en Fase 1) no cambia — sigue con `URL_DEL_VIDEO_YOUTUBE` como placeholder hasta que el usuario suba el video grabado y devuelva la URL real. ## Fase 7 — Evaluaciones y Trabajo Práctico Integrador (curso-level, opcional y al final) Solo si el usuario la pide explícitamente, o si la heurística de clasificación de Fase 0 detectó una unidad/bloque que corresponde a alguna de las dos. Viven fuera de la carpeta de unidades (son secciones de curso aparte) — no las generes de oficio ni las mezcles con el material de unidad. Documentá su propio estado en `estado.yml` bajo las claves separadas `evaluaciones_curso` y `trabajo_practico_integrador` (ver `references/estado-yml-schema.md`). Las dos siguen el mismo flujo mínimo de 3 pasos, con su propia plantilla: 1. **Consigna → PDF con membrete.** Escribí el documento completo (`documento-tpi.html` o `documento-evaluacion-.html`), mostraselo al usuario, y **recién con su confirmación explícita** corré `scripts/render_pdf.py --materia ""` — mismo mecanismo y misma regla dura que la Práctica de unidad (`plantilla-pdf-practica.md`). Nunca generes el PDF sin ese OK. 2. **Presentación en Moodle.** El bloque HTML que va en la página de la sección: banner + tarjeta de descarga con link al PDF ya generado (+ tabla de fechas de examen si es Evaluaciones). Ver plantillas abajo. 3. **Entrega / certificado / foro.** La tarjeta de descripción del `assign` de entrega (con las reglas de formato), y la nota de que el certificado (si aplica) es un módulo nativo del LMS gateado a que esa entrega esté marcada como realizada — no HTML que redacte la cátedra. El foro de consultas es nativo, sin HTML propio. **Evaluaciones** (parciales, recuperatorios, Integrador de nota): usá `references/plantilla-evaluacion.md`. Modela una instancia canónica (consigna → tarjeta "Importante" con video de referencia opcional → entrega → certificado gateado → foro) que se clona por cada parcial real de la materia — no le agregues variantes por mesa de examen/grupo salvo que el usuario las pida. **Trabajo Práctico Integrador** (proyecto final del curso): usá `references/plantilla-tpi-standalone.md`. Mismo espíritu que la Práctica de unidad pero a escala de curso: consigna completa en PDF, bloque de "Método de Entrega" separado de la consigna, y foro/rúbrica nativos sin HTML propio. Ambas plantillas están contrastadas contra HTML real relevado en vivo (curso Programación 3, TUP) — ver `assets/tpi-evaluaciones-html-real.txt` para el detalle completo, incluida la sección de qué se descartó a propósito (variantes por mesa de examen, recursos específicos de una materia, contenido legacy sin estilo) para no confundir ruido operativo real con el estándar a replicar. ## Fase 8 — Importación al aula real de Moodle (opcional, bajo pedido explícito) **Nunca se dispara sola.** Solo arranca cuando el usuario pide explícitamente subir/ importar/publicar el material ya generado en el aula real ("importá la unidad 2", "subí esto a Moodle", "quiero que el aula quede tal cual el material"). No es un paso automático al final de las Fases 1-7 — el material queda en el filesystem hasta que el usuario pide este paso aparte. No hay atajo de API real para esto (Moodle no expone un endpoint que arme secciones/Labels/Cuestionarios de punta a punta — ver la investigación del propio workspace del usuario si la tiene, típicamente `INVESTIGACION-API-MOODLE.md`), así que la Fase 8 opera por **browser automation** (Claude in Chrome) sobre la sesión ya logueada del usuario en Moodle, replicando los atajos de URL/JS confirmados en `references/importacion-moodle.md`. Cargá esa referencia completa antes de tocar nada — tiene el detalle técnico de cada paso; acá va solo el orden y las precondiciones. ### Precondiciones obligatorias — cortar si alguna no se cumple No avances con NINGUNA acción de escritura sobre el aula hasta tener las 5: 1. **Pedí la URL exacta del curso** a modificar. Nunca la asumas ni la adivines a partir de conversaciones previas — un aula equivocada es contenido real de otra materia/comisión pisado por error. 2. **Confirmá explícitamente con el usuario que su cuenta tiene rol de gestor/editor** (Teacher con permisos de edición) en ese curso. La skill no puede verificar permisos por API — se lo preguntás y tomás su palabra, pero si en la práctica no aparece el botón "Activar edición" o similar, cortá y avisá en vez de forzar. 3. **Avisá EXPLÍCITAMENTE, en texto claro, antes de tocar nada**: esta acción MODIFICA EL AULA REAL — crea, edita, oculta y potencialmente borra contenido existente. Moodle no tiene un "deshacer" real más allá de logs/papelera que no siempre alcanza. Pedí una confirmación explícita del usuario ("sí, dale" / "confirmo") antes de arrancar. Si existe un curso de prueba/sandbox (el usuario suele tener uno, ej. un `campustest` documentado en su propia bitácora de importación del workspace), **recomendá practicar ahí primero** antes de tocar el curso de producción real — no lo exijas si el usuario ya lo descartó, pero ofrecelo. 4. **Confirmá el mapeo explícito** unidad-local ↔ sección-real: qué carpeta local (`Unidad N - /`) corresponde a qué `section=N` del curso. Nunca lo asumas por orden numérico/alfabético sin chequear contra el nombre real de la sección en el curso. 5. **Relevá la estructura real ANTES de tocar nada**: contá los módulos reales de cada sub-sección a importar (técnica de `fetch` + regex de `id="module-(\d+)"`, ver `references/importacion-moodle.md`) para detectar de entrada contenido duplicado u otras sorpresas, y decidí junto al usuario qué hacer si aparece algo inesperado — no asumas. ### Reglas duras específicas de esta fase - **Nunca toques ni borres una copia "roja" de referencia** si el curso usa esa convención (copia editable + copia de referencia que el usuario duplica a mano más adelante). Si no está claro cuál copia es cuál, preguntá antes de tocar nada. - **Preferí OCULTAR antes que BORRAR** contenido del curso sin equivalente en el material generado — nunca borres de una sin confirmación explícita. - **Nunca asumas qué hacer ante contenido duplicado.** Preguntá la primera vez que aparezca en una unidad; una vez que el usuario define el criterio para un caso (expandir plantilla vs. contenido único), aplicalo consistentemente al resto sin volver a preguntar por cada sub-sección. - **Pegá HTML siempre vía `tinymce.get('').setContent(html)`**, nunca tipeando en el diálogo "Código fuente" del editor (el auto-cierre de etiquetas corrompe el HTML). Verificá el id del editor correcto antes de setear contenido en formularios con 2+ editores TinyMCE en la misma página (Tarea: `id_introeditor` vs `id_activityeditor`; Encuesta: `id_introeditor` vs `id_page_after_submit_editor`) — nunca asumas `tinymce.activeEditor`. - El archivo `00-descripcion-seccion.html` de cada sub-sección (Fases 1-6) va al campo Descripción de esa sección (`course/editsection.php`), **no a un Label**. - El archivo `cuestionario-actividad-N.html` de cada actividad va a la Descripción del `mod_quiz` correspondiente (con "Mostrar descripción en la página del curso" activado), **no al Label de la actividad**. El archivo `cuestionario-autoevaluacion.html` va al mismo lugar, en el `mod_quiz` de Autoevaluación — esa sub-sección **no tiene Label**, solo el Cuestionario. - **Nunca subas ni generes el PDF de la Práctica sin que `estado.yml` ya tenga `pdf_confirmado_por_usuario: true`** para esa unidad — si no está, cortá esa sub-sección y pedí la confirmación antes de seguir. - Los placeholders sin resolver (`URL_...`) se suben tal cual, no se inventan valores para completarlos — quedan documentados en el reporte final. - **Nunca saques el widget de infografía (botón + modal + `