Metodología

Pipeline del análisis (9 etapas)

Cada análisis que pides ejecuta estas 9 etapas en orden. Las etapas 1-2 son determinísticas (sin LLM). Las 3-9 invocan a Gemini con prompts versionados y trazables.

1. 1Parser. Extracción del texto del PDF / Word / TXT con limpieza profunda: folios de página, folios pegados al inicio de líneas de acción, palabras partidas por guion al final de línea, texto espaciado letra a letra, encabezados y pies repetidos. Sin LLM.
2. 2Stats. Segmentación en escenas con heurísticas calibradas sobre un corpus de guiones reales en producción profesional: detección INT/EXT, locaciones especiales (FLASHBACK, SUEÑO, MONTAJE), paréntesis al final del slug line, exclusiones de nombre de personaje, encabezados ambiguos y continuaciones. Cálculo de palabras, distribución de interiores/exteriores, duración estimada. Sin LLM.
3. 3Análisis por escena con Gemini 3 Flash. Resumen, emociones (Plutchik), personajes en escena con objetivo y arco emocional, diálogos con subtexto, campo semántico (Greimas), props y elementos de producción visual/sonora.
4. 4Análisis global con Gemini 3.1 Pro. Conflicto central (McKee / Egri), plot points typed (Field / Snyder), arcos de personaje (Truby / Campbell), clusters temáticos (Greimas / Bal), patrones estructurales y de ritmo (Mamet), curvas emocionales agregadas.
5. 5Propuesta de revisiones con Gemini 3.1 Pro. Detección de posibles incidencias en ortografía, gramática y concordancia, puntuación, tildes, formato de encabezado, consistencia de personajes, paréntesis inconsistentes, repeticiones cercanas, coherencia temporal y de locaciones, tiempos verbales. El sistema sugiere; el guionista decide qué aceptar.
6. 6Síntesis ejecutiva con Gemini 3.1 Pro. Premise / controlling idea (McKee), género primario + sub-géneros con confianza y justificación, comparables cinematográficos (3-5 títulos con dimensiones explícitas de similitud).
7. 7Diversidad y representación con Gemini 3.1 Pro. Test de Bechdel automatizado (Alison Bechdel, 1985: ≥2 personajes femeninos con nombre, que hablan entre sí, sobre algo que no sea un hombre). Composición del cast por género detectado en el texto. Notas de representación.
8. 8Extracción estructurada con LangExtract (Gemini 3 Flash). Personajes, emociones, locaciones, acotaciones, relaciones, objetos y temas con cita literal y offsets de carácter al texto del guion (zero-hallucination).
9. 9Embeddings por escena con gemini-embedding-2 (output_dim 768 vía MRL truncado, auto-normalizado). El chat RAG embebe cada pregunta y recupera las top-5 escenas más similares por similitud coseno antes de invocar a Gemini 3.1 Pro — respuestas trazables, acotadas al análisis, o explícitamente "no aparece en el guion".

Modelos en uso

Configurables vía env vars del backend. Permiten cambiar fácilmente entre Gemini Flash (rápido, barato) y Gemini Pro (razonamiento profundo) por etapa.

• Análisis por escena, extracción estructurada (LangExtract): gemini-3-flash-preview. Cada escena es contexto manejable; lo importante es velocidad y coste.
• Análisis global, corrección, síntesis, diversidad, chat RAG: gemini-3.1-pro-preview. Contexto largo + razonamiento sobre todo el guion.
• Embeddings por escena: gemini-embedding-2 (SDK nuevo google-genai). 768 dimensiones vía MRL truncado, auto-normalizado para coseno.

Análisis derivados (sin LLM extra)

Una vez termina el pipeline de 9 etapas, varias vistas calculan métricas adicionales sobre los datos ya producidos. NO consumen tokens ni añaden coste por análisis — son cálculos puros sobre el JSON resultante. Por eso son rápidos y repetibles sin esperar.

• Score de calidad 0-100. Síntesis ponderada de las severidades de las incidencias detectadas en la corrección. 100 = sin incidencias; cada alta resta 4 puntos, media 1.5, baja 0.3. No es una nota subjetiva del guion — es una medida cuantitativa de cuánta corrección formal pendiente queda.
• Subtexto global. % de diálogos con subtexto explícito según el análisis por escena. Categorías: Sutil (>60%), Equilibrado (30-60%), Explícito (<30%). Útil para entender el registro del guion sin juzgar si es bueno o malo.
• Filmabilidad. Detección de marcadores introspectivos ("piensa", "recuerda", "imagina", "siente"…) en acción/descripción. Penaliza fuertemente texto interno. Útil sobre todo para adaptaciones de novela, donde la densidad introspectiva no es directamente visualizable.
• Complejidad de producción. Score 0-100 calibrado sobre 4 ejes (locaciones únicas, escenas especiales, tamaño del cast, props únicos), con curvas distintas por eje. No predice presupuesto en euros; sitúa el proyecto en una franja (micro-budget / indie / estudio / blockbuster).
• Production breakdown. Lista de elementos físicos (props, vehículos, locaciones) extraídos del análisis por escena, agrupados y contados. Útil como punto de partida para un breakdown manual de producción.
• Balance de diálogo. Reparto del total de líneas de diálogo entre personajes. Detecta protagonistas absorbentes (>50% del diálogo) y personajes infradesarrollados (varias escenas pero pocas líneas).
• Diff entre versiones. Compara dos análisis del mismo guion por similitud coseno de embeddings de escena. Identifica escenas mantenidas, movidas, añadidas y eliminadas. Útil cuando iteras un guion y quieres ver qué cambió de verdad.
• Co-apariciones de personajes. Grafo ligero de qué personajes aparecen juntos en escena, basado en los rosters por escena del análisis global.
• Detección de escenas duplicadas. Pares de escenas con similitud coseno > 0.85 sobre los embeddings. Detecta repeticiones temáticas o escenas casi idénticas que pueden estar pidiendo una fusión.
• Coherencia de roster. Detecta personajes que tienen líneas de diálogo en una escena pero no figuran en su roster declarado. Suele indicar un olvido en el análisis o una inconsistencia del propio guion.

Diversidad y representación

Ventana de festivales

Lo que el sistema NO hace (deliberadamente)

Hay decisiones que pertenecen exclusivamente al juicio humano profesional. El sistema no las suplanta.

• No sugiere casting ni perfiles de actores. La elección de reparto depende del director, del productor, del proceso de pruebas y de la disponibilidad real del talento. Cualquier sistema que prediga "actor ideal para este personaje" simplifica un proceso complejo y sesga inconscientemente hacia caras conocidas.
• No predice éxito comercial ni recaudación. Para eso necesitarías datos de marketing, distribución y mercado que no derivan del guion.
• No emite juicio estético. El sistema dice "este guion tiene 5 escenas especiales con efectos" pero no "este guion es bueno/malo". El gusto es del lector.
• No reescribe. La pestaña Ajustes propone revisiones, pero NO aplica cambios automáticos al texto. El guionista mantiene control total.
• No sustituye a un asesor de guion humano. Por eso ofrecemos la tab Asesor experto: para conectarte con un profesional cuando el análisis automatizado se queda corto.

Bibliografía

Referencias en formato APA con explicación de qué tomamos de cada autor. Las citas en las vistas de resultados enlazan a su entrada aquí.

• Reagan, A. J., Mitchell, L., Kiley, D., Danforth, C. M., & Dodds, P. S. (2016). The emotional arcs of stories are dominated by six basic shapes. EPJ Data Science, 5(31).

  Qué usamos de este autor

  Estudio empírico (Project Gutenberg, 1.327 obras) que demuestra que la mayoría de relatos siguen una de 6 formas emocionales arquetípicas (rags-to-riches, tragedy, man-in-a-hole, etc.). Base para la clasificación de la curva emocional del guion.

  #reagan-2016

• Moretti, F. (2011). Network theory, plot analysis. New Left Review, 68.

  Qué usamos de este autor

  Análisis de la trama como red de interacciones entre personajes. Inspira nuestra vista de co-apariciones de personajes y la centralidad relativa en el cast.

  #moretti-2011

• Truby, J. (2007). The anatomy of story: 22 steps to becoming a master storyteller. Faber & Faber.

  Qué usamos de este autor

  Arco moral del personaje en 7 pasos: necesidad, deseo, oponente, plan, gran batalla, revelación, nuevo equilibrio. Esquema que estructura los character arcs reportados en el análisis global.

  #truby-2007

• Snyder, B. (2005). Save the cat! The last book on screenwriting you'll ever need. Michael Wiese Productions.

  Qué usamos de este autor

  Beat sheet de 15 beats (opening image, theme stated, catalyst, midpoint, all is lost, etc.). Lo usamos junto a Field para reconocer plot points específicos en el análisis estructural.

  #snyder-2005

• McKee, R. (1997). Story: Substance, structure, style, and the principles of screenwriting. ReganBooks.

  Qué usamos de este autor

  Concepto de controlling idea (premise positiva o negativa con value charge) que identifica la idea controladora del guion. También su definición de conflicto central (interno / interpersonal / extra-personal).

  #mckee-1997

• Mamet, D. (1997). True and false: Heresy and common sense for the actor. Pantheon Books.

  Qué usamos de este autor

  Principios de economía dramática: cada escena debe tener un objetivo claro y un cambio. Lo usamos para evaluar el ritmo y para flaggear escenas que no avanzan la trama.

  #mamet-1997

• Howard, D., & Mabley, E. (1993). The tools of screenwriting: A writer's guide to the craft and elements of a screenplay. St. Martin's Griffin.

  Qué usamos de este autor

  Las 14 herramientas (tema, premise, exposición, etc.). Nos da el vocabulario operacional con el que pedimos al LLM que describa la mecánica de cada escena.

  #howard-mabley-1993

• Vogler, C. (1992). The writer's journey: Mythic structure for writers. Michael Wiese Productions.

  Qué usamos de este autor

  Adaptación práctica del viaje del héroe de Campbell para guionistas. 12 etapas operacionalizadas que nos sirven para detectar patrones míticos en arcos de personaje.

  #vogler-1992

• Ekman, P. (1992). An argument for basic emotions. Cognition and Emotion.

  Qué usamos de este autor

  6 emociones básicas universales (alegría, tristeza, miedo, ira, sorpresa, asco). Marco alternativo a Plutchik que reportamos cuando se identifican emociones más fundamentales.

  #ekman-1992

• Seger, L. (1987). Making a good script great. Samuel French.

  Qué usamos de este autor

  Manual práctico de reescritura. Aporta criterios concretos para reconocer plot points débiles, escenas duplicadas funcionalmente y subtramas que no resuelven. Usado en la pestaña Ajustes.

  #seger-1987

• Bal, M. (1985). Narratology: Introduction to the theory of narrative. University of Toronto Press.

  Qué usamos de este autor

  Distinción entre fábula (eventos), historia (orden) y texto (narración). Complementa Greimas para mapear los clusters temáticos a su despliegue narrativo en el guion.

  #bal-1985

• Bechdel, A. (1985). Dykes to watch out for [comic strip: "The Rule"]. Self-published.

  Qué usamos de este autor

  Origen del test de Bechdel: una obra cumple los 3 criterios si (1) tiene al menos 2 personajes femeninos con nombre, (2) que hablan entre sí, (3) sobre algo que no sea un hombre. Test mínimo de presencia femenina, no certifica representación rica.

  #bechdel-1985

• Bordwell, D. (1985). Narration in the fiction film. University of Wisconsin Press.

  Qué usamos de este autor

  Modelo de narración clásica de Hollywood: la historia se construye con una cadena de causa-efecto donde cada escena motiva la siguiente por la acción/decisión de un personaje. Lo usamos como marco teórico para evaluar la cadena causal escena-a-escena (enlaces fuertes vs. débiles vs. rotos).

  #bordwell-1985

• Plutchik, R. (1980). A general psychoevolutionary theory of emotion. Academic Press.

  Qué usamos de este autor

  Rueda de las 8 emociones primarias (alegría, confianza, miedo, sorpresa, tristeza, asco, ira, anticipación) con intensidades y combinaciones. Es la taxonomía que pedimos al LLM para etiquetar emociones por escena.

  #plutchik-1980

• Field, S. (1979). Screenplay: The foundations of screenwriting. Dell.

  Qué usamos de este autor

  Estructura clásica en 3 actos con plot points en aprox. página 25 (Plot Point 1) y página 85 (Plot Point 2) en un largometraje estándar. Lo usamos para tipar los plot points detectados.

  #field-1979

• Genette, G. (1972). Figures III (incluye "Discours du récit"). Seuil.

  Qué usamos de este autor

  Tipología de tiempo narrativo: orden (anacronías), duración (escena, sumario, pausa, elipsis) y frecuencia. Lo usamos para analizar el ritmo del guion a partir de la longitud de escenas y los plot points.

  #genette-1972

• Greimas, A. J. (1966). Sémantique structurale. Larousse.

  Qué usamos de este autor

  Modelo actancial (sujeto, objeto, destinador, destinatario, ayudante, oponente) y campo semántico como agrupación de oposiciones binarias (vida/muerte, naturaleza/cultura). Lo usamos para identificar los clusters temáticos del guion.

  #greimas-1966

• Jung, C. G. (1959). The archetypes and the collective unconscious. Pantheon Books.

  Qué usamos de este autor

  Arquetipos del inconsciente colectivo (héroe, sombra, anima/animus, sabio, etc.). Vocabulario que el LLM utiliza al describir personajes prototípicos cuando se ajustan al esquema.

  #jung-1959

• Campbell, J. (1949). The hero with a thousand faces. Pantheon Books.

  Qué usamos de este autor

  Monomito: estructura universal del viaje del héroe (separación, iniciación, retorno). Base teórica de los arcos de personaje cuando detectamos viaje transformador.

  #campbell-1949

• Egri, L. (1942). The art of dramatic writing. Simon & Schuster.

  Qué usamos de este autor

  Premise dramática como motor del conflicto, y tridimensionalidad del personaje (fisiología, sociología, psicología). Lo usamos junto a McKee para evaluar el conflicto central.

  #egri-1942