storytelling-loop

Bucle de Narrativa (Storytelling Loop)

La escritura de historias (obras dramáticas, guiones, narrativas audiovisuales, adaptaciones de hechos reales) funciona de manera diferente a la escritura informativa. No se basa en listas de hechos, sino en una sola línea de logline como punto de referencia para todas las etapas. En lugar de puntuaciones, se usan minas (🔴🟠🟡) y la refutación del autor para decidir; los diálogos no se pulen artificialmente. El conocimiento de escritura reside en el paquete screenwriting, y el avance de etapas y el estado se guardan en sw-workflow dentro de él. Este skill añade sobre esa tabla de etapas: contraste con la logline, revisión adversarial, puertas de hechos reales/interés público, reglas de devolución y traspaso a otros skills.

Ubicación del skill: carpeta de skills de la cuenta Aside skills/user/<skill>/ (screenwriting, screenplay-review-checklist, writing-loop, marketingskills, humanize-korean, doc-coauthoring, policy-media-desk). Consulta la tabla en README para el repositorio original.

Diferencias con writing-loop

	writing-loop (textos informativos/persuasivos)	storytelling-loop (narrativa/obra dramática)
Punto de referencia	Lista de evidencias (hechos originales)	Logline (promesa de una línea al espectador)
Unidad	Párrafo, sección	Beat, escena, episodio
Decisión	Puntuación 5 ejes 40/50	Minas 🔴🟠🟡 + refutación del autor; criterios de aprobación por etapa
Pulido	humanize-korean obligatorio	No se usa en diálogos (acentos, dialectos, frases entrecortadas son del personaje). Solo se aplica light a descripciones, sinopsis y planes
Devolución	Máximo 3 vueltas	A la etapa causante. Si la logline se tambalea, parar y volver a ①. Número de vueltas lo decide el autor
Estado	Lista de verificación de episodios	story-bible.md (se continúa escribiendo entre sesiones)
¿Quién escribe?	Borrador de Aside	Selección de modo: coautoría / coach (el autor escribe; Aside solo corrige) / solo revisión

Bucle

⓪ Recepción → ① Taller de logline → ② Esqueleto → ③ Personajes → ④ Diseño de escenas/episodios → ⑤ Borrador → ⑥ Revisión → ⑦ Veredicto ── Aprobado → ⑧ Traspaso/Registro
              ▲  (Estrella Polar)        ▲        ▲              ▲                  ▲                │
              └──────────────────────────┴────────┴──────────────┴──────────────────┴─── Devolución ──┘
              Al final de cada etapa: "Contraste con la logline": ¿El resultado de esta etapa respeta esa única línea?

⓪ Recepción

1. Elegir formato: references/forms.md (largometraje, serie dramática/miniserie, cortometraje/webdrama/shorts, obra teatral, documental/video institucional, shorts, narrativa de hechos reales/biografía, novela).
2. Preguntar modo (ask_user_question una vez): Coautoría (Aside redacta borradores), Coach (Aside solo pregunta, diagnostica, propone ejercicios; el autor escribe), Solo revisión (solo etapa ⑥).
3. Definir: duración (minutos/páginas/episodios), plataforma/destino y sus especificaciones (las normas del concurso/emisora prevalecen sobre la estructura del skill), fecha límite, si hay obra original/hechos reales, ubicación de story-bible.
4. Si ya hay borrador: usar "llenar tabla inversa" de la entrada de sw-workflow para extraer logline, estructura y personajes del borrador e insertarlos en story-bible; los campos vacíos se toman como lista de correcciones y se inicia desde ⑥.
5. Línea de inicio: Bucle de Narrativa · Formato {formato} · Modo {modo} · Ruta {largometraje 0~7 | serie S0~S7 | ruta corta}.

① Taller de logline (Establecer la Estrella Polar)

Llenar la tarjeta de references/logline-card.md. Crear 5 candidatos, filtrarlos con pruebas, fijar uno y escribirlo en la casilla "Estrella Polar" al inicio de story-bible. Para series, debe pasar también la prueba del motor (por qué la historia se regenera cada semana) y la prueba de expansión por episodios. Skills de apoyo: sw-premise-theme, sw-industry-business (verificación PROBLEM); para series, sw-series-engine-bible.

②~⑤ Esqueleto · Personajes · Escenas · Borrador

Seguir exactamente la tabla de etapas de screenwriting/modules/sw-workflow/GUIDE.md (largometraje etapas 25, serie S2S6). En cada etapa, escribir los entregables de esa tabla en story-bible y verificar los criterios de aprobación. Al final de cada etapa, dejar una línea de Contraste con la logline: ② Contraste: ¿El punto medio (falsa victoria) amplifica el deseo del protagonista que '... intenta hacer algo'? → Sí.

• Para la práctica del cine y drama coreanos, añadir como referencias sw-korean-french-screenwriting, sw-series-case-studies (Noh Hee-kyung).
• Formato de guion: sw-format-adaptation (sistema coreano de números de escena S#, Fountain). Usar el formato del destino si lo exige.
• En modo Coach, Aside no escribe los entregables; solo los presenta como lista de preguntas y ejercicios.

⑥ Revisión

Llenar las cinco casillas de references/gates.md.

• L Contraste con logline: ¿Toda la lista de escenas/episodios respeta la Estrella Polar? Lista de escenas que no la respetan.
• W Criterios de aprobación por etapa: Tabla de sw-workflow y preguntas de diagnóstico de cada módulo (estructura 13, personajes 14, diálogos 14, escenas 13, formato).
• R Revisión adversarial: screenplay-review-checklist (7 capas, 37 criterios). Para borradores escritos por IA, usar por defecto el método B (evaluación por subagente → verificación de evidencia).
• F Puerta de hechos reales/interés público: Activar si hay personas reales, hechos reales o videos institucionales (veracidad, honor/privacidad/imagen, consentimiento; si es entidad pública, estilo que no parezca evaluación ni propaganda electoral).
• A Simulación de audiencia: Dar solo el borrador a un subagente y pedirle una "lectura en frío" (cold read): "¿Tienes curiosidad por la siguiente escena/episodio? ¿Qué te confunde? ¿Qué quiere el protagonista en una línea?"

⑦ Veredicto y devolución

Aprobado: Sin 🔴 + los 🟠 se corrigieron o el autor decidió dejarlos como pilares (con refutación) + Contraste L aprobado + Puerta F aprobada (si se activó). La refutación del autor es la última etapa de screenplay-review-checklist. Si el autor dice "es intencional", la mina se registra como pilar y se avanza (registro de decisiones).

Donde falló	Devolver a etapa
Capa A (idea/tema) 🔴, fallo de Contraste L en múltiples etapas, "no tiene sentido en una línea"	① Logline
Capa C (causalidad/estructura), final de acto no plantea nuevas preguntas, bajón a mitad	② Esqueleto
Capa B (personaje), diálogos no fluyen (normalmente el personaje no tiene nada que perder)	③ Personajes
Capas D·F (espacio/ritmo), escenas sin cambio de valor, escenas explicativas	④ Diseño de escenas/episodios
Capa E (diálogo/emoción), violación de formato	⑤ Borrador
Puerta F fallada	Rediseñar esa escena en ④ (no escribir hasta verificar hechos/consentimiento)

• Cambiar la logline es decisión del autor. Aside solo presenta razones y candidatos. Si cambia, registrarlo en el libro de decisiones de story-bible y volver a contrastar desde ②.
• No hay límite de vueltas. Pero si la misma mina aparece dos vueltas seguidas, detenerse y preguntar al autor: "¿La corriges o la dejas como pilar?"

⑧ Traspaso y registro

1. Actualizar story-bible.md (etapa actual, registro de decisiones, próximos pasos). El borrador se entrega en el formato elegido por el usuario (skill docx, skill google-docs, archivo de texto/Fountain).
2. Siguiente bucle (tras confirmación del usuario):
   • Frases para la intención de la obra, sinopsis, documentos de concurso → writing-loop (desde ② borrador, ruta de documentos).
   • Texto publicitario, avances, carteles → writing-loop ruta de promoción (copywriting de marketingskills).
   • Guiones para shorts/clips en redes sociales → marketingskills módulos social/video + ruta corta de este bucle.
   • Videos para YouTube (shorts dramáticos, videos institucionales, narrativas de hechos reales) → youtube-agent (original Jakeschincariol/youtube-agent-skill, MIT): con yt-script añadir el hook de los primeros 15 segundos (21 fórmulas, puntuación) e instrucciones [ON SCREEN]; con yt-package título/miniatura; con yt-chapters·yt-seo descripción. Si el video es largo, extraer shorts con yt-shorts. Si el hook es débil, devolver a etapa ④ diseño de escenas.
   • Producción de video (gráficos animados, reel) → tabla de enlace de policy-media-desk, bucle de difusión ⑤.
   • Narrativa de hechos reales/biografía → fundamentos factuales mediante el método de writing-loop puerta A, registro en el bucle de registro ⑥ de la tabla de enlace.
3. Añadir una línea de aprendizaje a references/lessons.md.

Límites de juicio

• En modo Coach, no se corrigen las frases del borrador del autor. Solo se emiten diagnósticos, preguntas y ejercicios.
• Las historias sobre personas reales no se traspasan a borradores públicos sin el consentimiento del interesado (o familiares) y verificación de hechos. Si es una adaptación, declararlo explícitamente.
• Los videos promocionales institucionales o con apariciones del líder de la entidad deben activar adicionalmente la puerta D de writing-loop (estilo que no parezca evaluación, verificación de ley electoral, prohibición de exagerar efectos). No se emiten juicios legales.
• Las citas de manuales de escritura originales y el texto completo de screenplay-review-checklist no se trasladan a repositorios públicos.

Historial de cambios

• 2026-11-04 v1.1: Añadido enlace a youtube-agent en el traspaso (hooks, títulos, miniaturas, descripciones, shorts para videos de YouTube).
• 2026-11-02 v1.0: Creación inicial. Instalación de screenwriting (jtydhr88) y screenplay-review-checklist (zhlmi), y enlace con writing-loop, marketingskills, humanize-korean, policy-media-desk.