From 7c00b4ed9a3c37ed5cace135ccdef62ac46b4844 Mon Sep 17 00:00:00 2001
From: ChemaVX <jmivanez@gmail.com>
Date: Tue, 21 Jul 2026 07:52:48 +0000
Subject: [PATCH] =?UTF-8?q?prompt:=20encabezados=20descriptivos=20(ES+EN)?=
 =?UTF-8?q?=20y=20may=C3=BAscula=20de=20oraci=C3=B3n=20(ES)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

La plantilla daba los encabezados LITERALES («## Contexto», «## Hechos
Clave»), así que el modelo los escupía tal cual o los usaba de prefijo. Se ve
en los dos blogs: 219 encabezados sucios en el ES (limpiados hoy a mano) y 77
de los 340 del EN empezando por la etiqueta de la plantilla — 37 artículos
ingleses terminan con un H2 que dice «Conclusion».

Ahora la estructura va entre corchetes, con la advertencia de que es guía
interna, y una regla prohíbe la etiqueta como encabezado y como prefijo.

Además, solo en el ES: mayúscula de oración. El prompt no decía nada de
capitalización y la única muestra que veía el modelo era «Hechos Clave», en
Title Case; generalizaba ese estilo a todos los encabezados, que en español
es incorrecto. Va con contraejemplo y con el caso de los dos puntos y la raya.
En el EN no se toca: ahí el Title Case es lo correcto.

Sin verificación posible hasta el próximo artículo — un prompt no se prueba en
seco. El check de mayúsculas de seo_watch (chemavx-seo-tools b0d5e1b) cubre la
regresión en el ES a partir de ahora.
---
 src/generator/generator.py | 42 ++++++++++++++++++++++++--------------
 1 file changed, 27 insertions(+), 15 deletions(-)

diff --git a/src/generator/generator.py b/src/generator/generator.py
index f7f3949..412ad12 100644
--- a/src/generator/generator.py
+++ b/src/generator/generator.py
@@ -50,23 +50,27 @@ RULES — follow strictly:
 - Do NOT summarize previous sections at the start of each new section
 - Do NOT repeat facts — if a fact appears once, do not mention it again
 - Use concrete details, numbers, names — avoid vague generalities
+- DESCRIPTIVE HEADINGS: every ## must name the specific fact of ITS section
+  ("The summer of 1947", "The diary nobody has finished analysing").
+  NEVER write the template label as a heading or as a prefix: no "Background",
+  "Key Facts", "Analysis", "Significance", "Conclusion", "Hook: ..."
 - Target: 1000-1500 words
 
-STRUCTURE:
+STRUCTURE (bracketed text is internal guidance: do NOT copy it verbatim)
 # [Impactful headline]
 
 [Hook paragraph — the most surprising fact]
 
-## Background
-[Context — what, when, who — only facts not covered elsewhere]
+## [descriptive heading for the background: what, when, who]
+[Only facts not covered elsewhere]
 
-## Key Facts
+## [descriptive heading for the main findings]
 [Most significant findings — each point must be distinct]
 
-## Analysis / Significance
-[What this means — without repeating the Key Facts section]
+## [descriptive heading for the analysis: what this means]
+[What this means — without repeating the previous section]
 
-## Conclusion
+## [descriptive heading for the closing]
 [No more than 2 sentences summarizing, then a forward-looking statement]
 
 RESEARCH MATERIAL:
@@ -120,24 +124,32 @@ REGLAS — sigue estrictamente:
 - NO resumas secciones anteriores al inicio de cada nueva sección
 - NO repitas hechos — si un hecho aparece una vez, no lo menciones de nuevo
 - Usa detalles concretos, números, nombres — evita generalidades vagas
+- ENCABEZADOS DESCRIPTIVOS: cada ## nombra el hecho concreto de SU sección
+  («El verano de 1947», «El diario que nadie ha terminado de analizar»).
+  NUNCA escribas la etiqueta de la plantilla como encabezado ni como prefijo:
+  nada de «Contexto», «Hechos Clave», «Análisis», «Conclusión», «Gancho: ...»
+- ENCABEZADOS EN MAYÚSCULA DE ORACIÓN: solo la primera palabra y los nombres
+  propios llevan mayúscula. «La noche que el cielo se apagó», NUNCA «La Noche
+  Que El Cielo Se Apagó» — eso es estilo inglés y en español es incorrecto.
+  Tampoco va mayúscula después de dos puntos ni de raya
 - Objetivo: 1000-1500 palabras
 
-ESTRUCTURA:
+ESTRUCTURA (lo que va entre corchetes es guía interna: NO lo copies literal)
 # [Titular impactante]
 
 [Párrafo gancho — el hecho más sorprendente]
 
-## Contexto
-[Contexto — qué, cuándo, quién — solo hechos no cubiertos en otro lugar]
+## [encabezado descriptivo del contexto: qué, cuándo, quién]
+[Solo hechos no cubiertos en otro lugar]
 
-## Hechos Clave
+## [encabezado descriptivo de los hallazgos principales]
 [Los hallazgos más significativos — cada punto debe ser distinto]
 
-## Análisis / Importancia
-[Qué significa esto — sin repetir la sección de Hechos Clave]
+## [encabezado descriptivo del análisis: qué significa]
+[Qué significa esto — sin repetir la sección anterior]
 
-## Conclusión
-[Conclusión — no más de 2 oraciones resumiendo, luego una declaración prospectiva]
+## [encabezado descriptivo del cierre]
+[No más de 2 oraciones resumiendo, luego una declaración prospectiva]
 
 MATERIAL DE INVESTIGACIÓN:
 {context}