Redactar una unidad
Redacta los recursos de una unidad. Lee COURSE-CANVAS.md, PLAN.md, PERSONAS.md, RESOURCES.md, DECISIONS.md y el material de la unidad anterior. Usa la estructura existente de los archivos del curso (encabezados, tablas, tono); si el curso aún no tiene ninguna, propón una y espera confirmación.
1. Escribir la trayectoria primero
Antes de cualquier contenido, escribe la trayectoria del alumno para la unidad como una lista numerada en las notas del instructor del archivo de sesión: cada paso que da un alumno desde que abre la página del participante hasta que entrega el trabajo, cada uno con
- lo que necesita (concepto, herramienta, archivo, enlace, cuenta) y de dónde proviene (límite, unidad anterior, esta página),
- el resultado esperado que puede ver.
Carga assumed-knowledge. Un paso cuya necesidad no tiene origen es una brecha: resuélvela ahora añadiendo un paso, un enlace o una explicación, o pásala al instructor. Muestra la trayectoria y espera confirmación; esta es la especificación contra la que se verifica el material.
2. Redactar
Redacta lo que la unidad necesita según RESOURCES.md, cada parte en su propia ubicación:
- Instructor: plan de sesión con tiempos, input, trabajo en grupo, respuestas modelo y puntos de discusión. Escribe los bloques de input como contenido (afirmaciones, números, ejemplos) pensando en las notas del orador; las diapositivas se construyen a partir de ellos más tarde con
/to-slides. - Participante: objetivos, tareas, entregable, material con longitudes. Carga
learner-instructions. - Plantilla o código: cuadernos, datos, configuración de los que dependen las tareas.
Calcula las respuestas modelo ejecutando el código sobre los datos del curso, nunca de memoria. Cita los números indicando cómo se calcularon.
3. Punto de parada
Muestra los borradores con una breve lista de las decisiones que tomaste (redacción de tareas, qué video, cuánto es opcional) y qué te generó dudas. El instructor edita o aprueba. Registra las decisiones que afecten a otras unidades en DECISIONS.md.
Terminado cuando el instructor ha aprobado los borradores y RESOURCES.md lista la unidad como borrador. Sugiere /to-slides <unidad> si la sesión tiene bloques de input, luego /walk-through <unidad>; nunca marques una unidad como liberada en esta habilidad.