steffen74/to-slides

A diapositivas

Construye las diapositivas para una unidad. Lee COURSE-CANVAS.md, RESOURCES.md, DECISIONS.md, la sección ## Creación agentiva del curso de AGENTS.md, y el plan de sesión aprobado de la unidad y la página del participante. Las diapositivas se construyen a partir del plan, nunca al revés: si el plan de sesión no está aprobado todavía, detente y sugiere /draft-unit.

1. Establecer el formato una vez

El formato normalmente se establece en /setup-course. Si AGENTS.md no tiene una línea Diapositivas:, pregunta, liderando con una recomendación basada en lo que existe (presentaciones anteriores, las herramientas del bloque 5):

• Formato y herramienta: por ejemplo un artifact de claude.ai para Slides, .pptx, Google Slides, diapositivas Markdown (Marp, reveal.js).

• Dónde viven las presentaciones y quién las ve: solo se muestran en clase, o se publican para los participantes después. Las presentaciones publicadas son material del participante.

• Plantilla: una presentación existente o un sistema de diseño cuyo estilo seguir.

• Dónde viven los esquemas: recomienda una carpeta privada junto a los planes de sesión (por ejemplo slides/<unidad>-esquema.md), ya que los esquemas contienen respuestas de ejemplo.

Escribe la respuesta como - Diapositivas: <formato>, <ubicación presentación>, <ubicación esquema>, <publicado para participantes: sí|no>, plantilla <enlace> en AGENTS.md y regístrala en DECISIONS.md.

2. Esquema a partir del plan

Escribe el esquema en su archivo antes de cualquier diapositiva: una tabla de tiempos (minutos del plan, diapositivas y minutos por diapositiva para cada bloque), luego una entrada por cada bloque del plan de sesión, en su orden:

• Apertura: una portada y una diapositiva de agenda con los bloques y minutos del plan, aunque el plan no los liste.

• Bloque de entrada: una sección dimensionada a sus minutos (como regla, una diapositiva de contenido por cada dos o tres minutos). Enumera las afirmaciones que hace cada diapositiva y de dónde vienen: el plan de sesión, sus respuestas de ejemplo, el canvas, la página del participante. Los números provienen de las respuestas de ejemplo del plan o se calculan de nuevo; nunca inventados. Cuando el plan solo da una palabra clave ("tipos de escala"), no la completes con tu propio conocimiento: marca la diapositiva como contenido faltante en el plan y conviértelo en una decisión.

• Trabajo grupal: una diapositiva de tarea con la tarea en la misma redacción que la página del participante, el tiempo asignado, el resultado esperado, dónde trabajar (repositorio, datos, notebook de inicio) y dónde publicar o entregar. Carga learner-instructions. Si la página del participante no contiene la tarea (las tareas dentro de la sesión a menudo viven solo en el plan de sesión), toma la redacción del plan y márcala: la diapositiva es entonces el único lugar donde los estudiantes ven la tarea, y es material del participante sin importar si la presentación se publica. Marca cada tarea con más de una lectura razonable (por ejemplo "promedio" por días o por filas) como una decisión.

• Plenario: una diapositiva con la pregunta o los criterios para la retroalimentación. El contenido producido en la sala (respuestas de grupos, gráficos) recibe un marco vacío para llenar en vivo.

• Control de video: el enlace del cuestionario de RESOURCES.md (y un código QR cuando el formato lo permita), no las preguntas; las respuestas y explicaciones solo en las notas del orador. Si la unidad aún no tiene cuestionario, sugiere /to-quiz primero.

• Descanso, panorama: una diapositiva cada uno; el panorama repite la tarea en la redacción de la página del participante.

Marca cada diapositiva que revelaría una respuesta de ejemplo antes de que los estudiantes hayan trabajado en ella. Aquellas van después de la diapositiva de tarea, como diapositivas ocultas o de respaldo, o se omiten de la presentación publicada.

Termina el esquema con las decisiones que necesita (bloques sobrecargados, contenido faltante, tareas ambiguas, si la presentación se publica), cada una con opciones y una recomendación, y el resultado de las verificaciones de diapositivas de course-checks que ya puedan ejecutarse sobre un esquema. Muéstralo y espera al instructor. Este es el punto de parada; las ediciones al contenido van primero al plan de sesión, luego al esquema.

3. Construir

Construye la presentación en el formato y plantilla establecidos:

• Un título en cada diapositiva que exprese su punto ("La mayoría de los errores de pronóstico caen en días festivos"), no un tema ("Resultados").
• Poco texto; lo que dice el instructor va en las notas del orador, tomado del plan de sesión.
• Cada enlace, nombre de repositorio, comando y fecha límite exactamente como en su fuente de verdad en RESOURCES.md.
• Las demostraciones en vivo reciben una diapositiva de respaldo (una captura de pantalla o la salida esperada) en caso de que la demo falle.

4. Verificar y entregar

Ejecuta las verificaciones de diapositivas de course-checks (coherencia con el plan y la página del participante, tiempos, sin respuestas de ejemplo anticipadas, enlaces). Corrige lo que falle, luego muestra la presentación con una lista de las diapositivas sobre las que tenías dudas.

Las presentaciones son espejos: repiten hechos del plan de sesión y de la página del participante, incluyendo sus vacíos. Agrega cada presentación a los espejos de esos hechos en RESOURCES.md, para que una corrección en una página también alcance a las presentaciones que la repiten.

Si las presentaciones se publican para los participantes, publica la presentación aprobada en el manual: expórtala como PDF (cuando la herramienta de diapositivas solo pueda exportarse manualmente, pide al instructor que la exporte y dile exactamente dónde guardarla), nómbrala según la unidad (por ejemplo semana-02-diapositivas.pdf), colócala en la ruta de activos del manual desde AGENTS.md, elimina las notas del orador y las diapositivas de respuesta ocultas de la exportación, y enlázala desde la página del participante de la unidad bajo sus materiales. Un cambio posterior en la presentación significa una nueva exportación; el PDF en el manual es un espejo de la presentación.

Terminado cuando el instructor ha aprobado la presentación, RESOURCES.md la lista para la unidad con estado borrador, y su ubicación está enlazada desde el plan de sesión, y, si se publica, el PDF está enlazado desde la página del participante de la unidad. Si la presentación se publica para los participantes, sugiere /walk-through <unidad> a continuación; de lo contrario /review-unit <unidad>.