slides-preview

# Preview de Slides Marp Convierte cada lección del course.json en un Marp deck standalone con estructura CONTEXT → CONCEPT (N slides) → BUILD → SHIP → REFLECT. ## Prerequisito `marp-cli` debe estar disponible globalmente. Si falta: ``` ERROR: marp-cli no encontrado. Instalalo con: npm install -g @marp-team/marp-cli (o ver alternativas en https://marp.app) ``` ABORT si falta. ## Inputs - `course-slug` (required, desde `$ARGUMENTS`). - Optional filter: `module-N` (renderiza solo ese módulo), `lesson-N` (renderiza solo esa lesson — global N o "module-X.lesson-Y"). ## Flujo 1. Verificar `course.json` existe. 2. Verificar `marp-cli` (abort si falta). 3. Parsear `$ARGUMENTS` para filtros opcionales. 4. **Aplicar overlays al deck (Base + Overlay protocol).** Antes de invocar al `slides-renderer`, leer `${CLAUDE_PLUGIN_ROOT}/assets/runtime/overlay-protocol.md` y ejecutar Discovery §2 + Invocation §3 + Layer 1 validator §5 sobre el payload de slides: - `command` = `"slides-preview"` - `cwd` = directorio de trabajo desde donde se invocó `/idt:slides-preview` - `baseDraft` = objeto con forma `{ course, lessons: [...] }` donde cada `lesson` ya está estructurada (CONTEXT/CONCEPT/BUILD/SHIP/REFLECT como bloques de texto, `marp_slide_count` calculado). Un overlay de voz puede reemplazar texto dentro de bloques (p.ej. "the learner will" → "you will ship") sin tocar `lesson.id`, `module.au_id`, ni `course.meta.id`. Un overlay estructural puede insertar slides adicionales (p.ej. una slide "BUILD section header" entre CONCEPT y BUILD). - `context.locale` derivado de `course.meta.language`. Reglas clave: - Layer 1 invariants (todos los IDs estables, `au_id`, semver) se revalidan después de cada overlay. Si un overlay los muta: ABORT con error apuntando al `SKILL.md` ofensor. NO se renderiza nada. - Si discovery devuelve cero overlays: el deck es voice-neutral cmi5-compliant. Ningún warning. - Warnings de overlays se acumulan y se presentan al final junto al listado de paths generados. 5. Despachar `${CLAUDE_PLUGIN_ROOT}/agents/slides-renderer.md` con: - course_json_path - module_order (opcional) - lesson_order (opcional) - overlaid_lessons (opcional) — el array de lessons post-overlay del paso 4 si discovery encontró overlays. Sin este parámetro, el agent renderiza lessons del `course.json` tal cual. 6. El agent itera lessons (overlaid o base), sustituye variables del template `${CLAUDE_PLUGIN_ROOT}/assets/templates/marp-lesson.md.tmpl`, escribe `.md`, ejecuta `marp ... --html -o ....html`. 7. Reportar paths generados al usuario (incluyendo cualquier warning surgido de overlays en el paso 4): > "Slides renderizados: > - `lessons/lesson-01-{slug}.md` (Marp source) > - `lessons/lesson-01-{slug}.html` (deck preview) > - ... > > Abrí cualquier `.html` en Chrome para ver el deck. Para presentar: > `marp --preview lessons/lesson-01-*.md`." ## Sin gates Idempotente con warning si sobrescribe. ## Recursos - `${CLAUDE_PLUGIN_ROOT}/agents/slides-renderer.md` - `${CLAUDE_PLUGIN_ROOT}/assets/templates/marp-lesson.md.tmpl` - `${CLAUDE_PLUGIN_ROOT}/assets/schemas/overlay-protocol.schema.json` — contrato `OverlayInput`/`OverlayOutput` para el paso 4 - `${CLAUDE_PLUGIN_ROOT}/assets/runtime/overlay-protocol.md` — discovery + invocation + Layer 1 invariant validator - Marp docs: <https://marp.app>