video-explainer-guide

video-explainer-guide

Guía estructurada, en forma de plugin de Claude Code, para producir contenido con intención pedagógica — basada en evidencia cognitiva, teoría del medio y casos actuales. Cubre dos familias de output:

• Explainer videos — tutoriales técnicos, divulgación científica, video-ensayo, documental narrativo, periodismo analítico visual, explainer comercial, how-to, onboarding, conferencia grabada, live stream educativo, podcast audiovisual, personal essay con intención de enseñar.
• Material didáctico no-video (desde v1.4.0) — láminas didácticas secuenciales (estilo libro de historia ilustrado), slides para presentar en vivo (formato Marp), long-form escrito con visualizaciones embebidas. Útil para explicar conceptos difíciles a audiencias sin experiencia.

Qué problema resuelve

Producir buen contenido pedagógico —video o estático— es una cadena larga de decisiones acopladas: a quién le hablas, cuál es la promesa, cómo abres, cómo estructuras, qué muestras encuadre por encuadre o panel por panel, cómo lo aterrizas. Cada decisión tiene consecuencias cognitivas, narrativas y técnicas. Esta guía te acompaña decisión por decisión con justificación citable a fuente.

No cubre vlogs, reacciones, gameplay, entretenimiento puro, videoclips musicales, memes, anuncios puros sin componente explicativo, ni contenido donde no hay un concepto o habilidad para transferir al espectador o lector.

Filosofía

Arquitectura de 3 capas con trazabilidad dura de toda recomendación a una fuente citable.

Capa 1 — Pilares (source of truth)

1. Fundamentos cognitivos y teoría del medio — estable. Ciencia verificada (Mayer, Sweller, Paivio, Bjork, Roediger, Cepeda) + teoría del cine documental, ensayo fílmico, retórica visual y active learning según aplique a cada modalidad. Cambia 1–2 veces por año.
2. Tendencias y casos de éxito — dinámico. Lo que funciona ahora en plataformas y formatos, con fichas por creador (Fireship, Veritasium, Kurzgesagt, Nerdwriter, Johnny Harris, TED, Lex Fridman, ThePrimeagen, Ali Abdaal, etc.). Cambia en semanas/meses.
3. Herramientas — dinámico. Software vigente, releases, alternativas — desde edición y motion hasta live streaming, podcast multi-mic y data-journalism. Agnóstico de hardware.

Todo claim tiene un ID estable ([P1-§2.3-#8], [P2-ficha-fireship], [P3-edicion-postproc]). Los IDs sobreviven renombres. Cuando pilar 2 o 3 contradice pilar 1, el conflicto se flaggea al usuario, no se resuelve en silencio — pilar 1 prevalece salvo override explícito.

Capa 2 — Briefs (síntesis precomputada)

50 briefs en docs/briefs/<etapa>/NN-slug.md (6 concepto + 8 guion + 4 previsualización + 7 grabación + 10 edición + 8 publicación + 7 material), uno por decisión crítica. Cada brief es un ensamblaje denso de 40–120 líneas con contrato estricto: principio cognitivo + 2–3 casos concretos + anti-patrón + heurística numérica + conflictos conocidos + salida esperada. ≥5 citas a IDs estables por brief.

Los briefs son la capa que los skills consumen en runtime. Los skills NO leen pilares completos.

Capa 3 — Skills (consumen briefs)

Uno por etapa de producción. Cada skill carga los briefs de su etapa, camina al creador por las decisiones en orden, propone con cita trazable, flaggea conflictos, espera aprobación.

Contrato con estado (briefs lockeables). Tres skills producen briefs con header estado: draft | locked + locked-at: YYYY-MM-DD:

• concept-explainer produce un Concept Brief (audiencia, objetivo, promesa, ángulo, formato, plataforma, tono, restricciones) que el resto del flujo de video consume read-only.
• storyboard-explainer produce un Production Brief (storyboard, pacing, shotlist, requisitos de captura) que record-explainer y edit-explainer consumen.
• material-explainer produce un Didactic Brief (concepto, audiencia, objetivo cognitivo, mapa conceptual, secuencia didáctica, estilo visual) que se materializa en uno o varios formatos (láminas / slides / long-form).

Mientras está draft, el brief es iterable. Una vez locked, es contrato firme; cambios post-lock requieren re-invocar la skill correspondiente.

Estructura