instructional-design-toolkit

instructional-design-toolkit

Plugin de Claude Code para diseño instructional guiado — cursos completos xAPI + cmi5-compliant, contenido de curso end-to-end (módulos, text classes, quizzes, challenges, video scripts, workbooks interactivos, storyboards de video), Paths con credential OpenBadge 3.0, y planes de sesiones 1-on-1 (coaching / mentoring / tutoring) con rigor pedagógico.

Qué hace

Guía a creadores de cursos (instructores externos, founders de startups Launchpad, equipos internos) a través del diseño completo de cursos usando la fórmula CONTEXT → CONCEPT → BUILD → SHIP → REFLECT con Builder's Bloom's Taxonomy, Ship-First Design, y evaluación Kirkpatrick L1-L4. Produce outputs xAPI + cmi5 compliant desde el origen, listos para hospedar en LMS estándar (Moodle con mod_cmi5, Ralph LRS, SCORM Cloud, Cornerstone).

El toolkit es la capa base: ship siempre las invariantes cmi5/xAPI y la pedagogía genérica (SAM, Atomic Habits, Bloom's, Kirkpatrick, Irby). La voz editorial y los frameworks nombrados viven en overlays de plugins consumidores (p. ej. dojo-academy), que se descubren y aplican en runtime sin tocar la base. Ver "Base + Overlay pattern" más abajo.

Core Methodology Insights

Antes de usar el toolkit, vale la pena internalizar estos 5 insights:

1. SAM supera ADDIE

SAM (Successive Approximation Model) de Allen Interactions es la antítesis de ADDIE: iteración rápida con prototipos en vez de diseño completo pre-desarrollo. Ningún curso debería llegar a su primera cohorte de 100+ sin haber pasado por al menos una cohorte piloto de 3-10. Ref: Leaving ADDIE for SAM (Allen, 2012).

2. Atomic Habits aplicado a cursos

Cada lección es un ciclo cue → craving → response → reward (Clear, 2018). El cue suele ser notificación o bloque de calendario; el craving es curiosidad por un concepto nombrado; el response es la sección BUILD; el reward es el SHIP milestone compartible. Los cursos que omiten el reward mueren en silencio — la tasa de abandono entre lesson 2 y 3 es típicamente 60-80%.

3. xAPI Stability Rule

Los id y au_id en el JSON son inmutables. Los title y slug son mutables. Si renombrás "Lesson 3: Widgets" a "Lesson 3: Composición de Widgets", el id debe permanecer lesson:widgets-001. Confundirlos rompe el historial xAPI de todos los alumnos que ya pasaron por ese AU. El agent cmi5-metadata-writer aborta automáticamente si detecta cambio de ID inmutable.

4. Semantic Versioning para cursos

Tipo	Qué cambia	Impacto en alumnos enrolados
MAJOR (2.0.0)	AU removido, masteryScore aumentado, moveOn endurecido, module reorder	🔴 Migration required
MINOR (1.2.0)	AU agregado, lesson agregada, quiz opcional	🟡 Re-enrollment opcional
PATCH (1.1.3)	Typo, reescritura de contenido, update de title/slug	🟢 Transparente

/course-revise clasifica automáticamente y aplica grandfather clauses cuando es posible.

5. Irby 2018 — Coach ≠ Mentor ≠ Tutor

Del editorial Mentoring & Tutoring: Partnership in Learning (Irby, 2018, p. 297):

"mentors can coach, but coaches hardly ever mentor, and mentors and coaches can tutor, but tutors rarely mentor or coach."

El toolkit detecta el tipo automáticamente vía session-type-detector agent pero respeta la distinción pedagógica: cada tipo tiene estructura de session plan distinta (coaching = KPI + withdrawal trigger; mentoring = long-term goal + relationship history; tutoring = specific topic + success criterion).

Commands (33)

Los comandos escriben a dos árboles de output distintos según su origen:

• docs/instructional-design/ — comandos core v1 (diseño y ciclo de vida de cursos y session plans a nivel course.json / session-plan.json). 12 comandos.
• content/ — comandos de authoring de contenido migrados desde dojo-academy (el árbol de contenido real: módulos, clases, quizzes, workbooks, storyboards, paths, tracks, traducciones, ilustraciones, QA de release). 21 comandos.

(Además existen commands/_translation-pipeline.md y commands/_translation-strategy.md: son docs internos de referencia sin frontmatter, no comandos invocables.)

Core — cursos y session plans → docs/instructional-design/