ahsanmandhar-ui/research-poster-maker

Habilidad para Crear Pósteres de Investigación

Produce pósteres de investigación científica listos para congresos que parecen diseñados por un diseñador gráfico académico experimentado (adecuados para congresos de Nature, reuniones de BMJ, ACC, ASN, congresos europeos y simposios universitarios)—nunca infografías genéricas de IA.

Todas las rutas de archivo a continuación son relativas al directorio raíz de esta habilidad (research-poster-maker/).

---

Reglas Inamovibles Esenciales

1. Cero Fabricación Científica: Nunca inventes tamaños de muestra, estimaciones de efecto, intervalos de confianza, valores p, recuentos de exclusiones, citas, números de subvención o afiliaciones. Conserva la precisión decimal exacta, las unidades y el marco de significación estadística.
2. Destila Prosa—No Pegues Muros de Texto: Transforma los párrafos del manuscrito en declaraciones analíticas concisas y puntos paralelos de alta claridad (~350–600 palabras en total en el cuerpo) mientras conservas el significado exacto.
3. Nunca Reduzcas Todas las Fuentes para Aliviar el Hacinamiento: Si el contenido desborda un diseño con tamaños de fuente legibles a distancia de visualización, reescribe la prosa verbosa, poda los puntos de antecedentes secundarios, reequilibra las columnas o cambia de diseño.
4. Diseño Editorial Moderado: Evita tarjetas redondeadas idénticas alrededor de cada sección, clip-arts/emojis decorativos, sombras paralelas, degradados de arcoíris y el azul médico por defecto. Utiliza reglas tipográficas limpias, espacios en blanco intencionales, alto contraste WCAG y visualizaciones de datos reales.
5. Informe Técnico y de Impresión Honesto: Nunca escale una imagen rasterizada de baja resolución y afirme que tiene 300 DPI. Nunca reclame cumplimiento CMYK PDF/X para impresión offset en salidas sRGB. Reporta las dimensiones exactas, el factor de escala de .pptx (si >56 pulgadas) y el backend de exportación PDF de forma transparente.

---

Flujo de Trabajo Paso a Paso

Paso 1 — Inspeccionar el Material de Investigación Disponible Primero

Antes de hacer preguntas al usuario, localiza e inspecciona todos los manuscritos proporcionados (.docx, .pdf, .md, .txt), conjuntos de datos (.csv, .xlsx) y figuras/logos existentes:

python scripts/analyze_research.py <archivos_o_carpeta_de_entrada> --output-dir <directorio_de_trabajo>

Revisa <directorio_de_trabajo>/research_extraction.json y <directorio_de_trabajo>/extraction_summary.md para verificar los 18 campos canónicos (Título, Autores/Afiliaciones, Antecedentes, Brecha de Investigación, Objetivos, Diseño del Estudio, Métodos, Población, Tamaño de Muestra, Métodos Estadísticos, Resultado Primario, Resultados Secundarios, Hallazgos Importantes, Tablas/Figuras, Limitaciones, Conclusión, Referencias, Financiamiento/Agradecimientos).

Paso 2 — Solicitar Solo la Información Esencial Faltante

No presentes un cuestionario extenso cuando el manuscrito ya proporcione los detalles del estudio. Pregunta de forma concisa solo cuando:

• Faltan hechos científicos críticos en la fuente (por ejemplo, autores/afiliaciones faltantes o números de resultado primario faltantes) y no se pueden inferir.
• No se especificaron las dimensiones/orientación del panel del congreso (ofrece un valor predeterminado regional sensato—por ejemplo, 48 × 36 pulgadas apaisado o ISO A0 vertical—claramente etiquetado como suposición).
• Se desea la marca institucional/logotipo o la URL del código QR del estudio.

Paso 3 — Seleccionar Arquitectura y Consultar Documentos de Referencia Según sea Necesario

Carga guías de referencia detalladas de docs/ bajo demanda:

• Dimensiones, límite de PowerPoint de 56 pulgadas y especificaciones de impresión: docs/print-specifications.md
• Paletas de colores y anti-patrones editoriales: docs/design-system.md
• Combinaciones tipográficas y escalas de puntos de distancia de visualización: docs/typography.md
• 8 Estrategias de composición de diseño: docs/layout-recipes.md
• 15 Tipos de gráficos/diagramas científicos: docs/visualization-guide.md
• Reglas de integridad científica y extracción: docs/scientific-integrity.md
• Contraste WCAG 2.1 y seguridad para daltonismo Okabe-Ito: docs/accessibility.md

Plantillas disponibles en templates/<id>/template.json:

• clinical-research | systematic-review | meta-analysis | experimental-research | epidemiology | minimalist-editorial

Recetas de diseño disponibles:

• three_column_classic | two_column_editorial | asymmetric_grid | results_focused | timeline_flow | central_visual | clinical_workflow | systematic_review_prisma

Paletas disponibles:

• academic_navy | charcoal_ivory | deep_teal | burgundy_offwhite | forest_cream | monochrome_editorial (más anulaciones hexadecimales personalizadas)

Paso 4 — Presentar Especificación de Diseño Breve Antes de la Generación

Antes de la representación final, presenta un bloque de especificación conciso:

Póster: Investigación Clínica
Orientación: Apaisado
Dimensiones: 48 × 36 pulgadas (explícito / valor predeterminado asumido)
Diseño: clinical_workflow (30% : 41% : 29%)
Tipografía: IBM Plex Sans
Paleta: Oxford Navy & Crisp White (#0F2742 / #FFFFFF / #D55E00)
Enfoque visual: Curva de punto final primario de Kaplan-Meier + tabla de resultados de subgrupos
Salida: PPTX + PDF + PNG + Informes de Contenido y Diseño

Paso 5 — Redactar poster_spec.json y Ejecutar la Canalización de Producción

Construye <directorio_de_trabajo>/poster_spec.json estrictamente a partir de los datos de origen verificados:

{
  "template_id": "clinical-research",
  "dimensions_preset": "48x36",
  "layout_recipe": "clinical_workflow",
  "palette": "academic_navy",
  "font_pairing": "clinical_precision",
  "study_badge": "COHORTE MULTICÉNTRICA PROSPECTIVA · STROBE",
  "title": "Título Exacto del Estudio Verificado en Mayúsculas y Minúsculas",
  "authors_line": "Primer Autor, MD¹; Segundo Autor, PhD²",
  "affiliations_line": "¹Depto. de Medicina, Institución A; ²Depto. de Bioestadística, Institución B",
  "study_url": "https://doi.org/...",
  "logo_path": null,
  "items": [
    {
      "id": "background",
      "column": 0,
      "item_type": "text",
      "style": "editorial_rule",
      "title": "01  Antecedentes Clínicos y Objetivo",
      "paragraphs": ["Contexto conciso extraído de la fuente."],
      "bullets": ["Objetivo: Hipótesis primaria precisa."]
    },
    {
      "id": "primary_outcome",
      "column": 1,
      "item_type": "callout",
      "style": "focal_callout",
      "title": "Punto Final Clínico Primario",
      "hero_metric": "aHR 0.68 (IC 95% 0.56–0.82; p < 0.001)",
      "paragraphs": ["Resumen analítico exacto del hallazgo primario."]
    },
    {
      "id": "fig1",
      "column": 1,
      "item_type": "figure",
      "title": "03  Supervivencia Acumulada Libre de Eventos",
      "chart_spec": {
        "id": "fig1_km",
        "chart_type": "kaplan_meier",
        "width_in": 16.5,
        "height_in": 9.2,
        "x_label": "Seguimiento (Meses)",
        "y_label": "Supervivencia Libre de Eventos",
        "data": { "groups": [], "risk_times": [], "stat_summary": "..." }
      },
      "caption": "Figura 1. Curvas de supervivencia de Kaplan-Meier con número en riesgo (N = ...)."
    },
    {
      "id": "tbl1",
      "column": 2,
      "item_type": "table",
      "title": "04  Resultados Multivariables",
      "table_data": {
        "headers": ["Punto Final", "HR Ajustado (IC 95%)", "valor p"],
        "rows": [["Compuesto primario", "0.68 (0.56–0.82)", "<0.001"]],
        "col_weights": [1.9, 1.3, 0.7]
      },
      "footnote": "Ajustado por covariables basales preespecificadas."
    }
  ],
  "colophon": {
    "references": ["[1] Autor et al. Revista Año;Vol:Páginas."],
    "funding": "Financiamiento: ID de Subvención.",
    "correspondence": "Correspondencia: [email protected]"
  },
  "missing_information_notes": []
}

Ejecuta el generador unificado (que ejecuta la generación de gráficos, la resolución del diseño, la construcción de PPTX, la exportación a PDF, la representación de la vista previa PNG y la validación de calidad en varias capas):

python scripts/generate_poster.py \
  --spec <directorio_de_trabajo>/poster_spec.json \
  --extraction <directorio_de_trabajo>/research_extraction.json \
  --output-dir <directorio_de_trabajo>/output

Las etapas individuales de la canalización también se pueden invocar de forma independiente mediante scripts/generate_charts.py, scripts/export_poster.py, scripts/generate_preview.py y scripts/validate_poster.py.

Paso 6 — Inspección Visual y Refinamiento Iterativo Acotado

1. Lee <directorio_de_trabajo>/output/validation_report.md para confirmar que las comprobaciones técnicas, científicas, de accesibilidad y visuales se hayan superado.
2. Inspecciona visualmente <directorio_de_trabajo>/output/poster_preview.png utilizando herramientas de visualización de imágenes siempre que estén disponibles. Verifica la jerarquía visual general, el equilibrio de columnas, la legibilidad de los gráficos, la alineación y los espacios en blanco.
3. Si se encuentra algún problema (Generar → Exportar → Renderizar → Inspeccionar → Validar → Revisar → Finalizar), ajusta poster_spec.json (condensa los puntos detallados, ajusta las asignaciones de column o aspect_ratio, o cambia de layout_recipe) y vuelve a ejecutar. Detente cuando las comprobaciones objetivas pasen o informa honestamente cualquier restricción no resuelta (como una fotografía de baja resolución proporcionada por el usuario).

---

Lista de Verificación de Entregables Obligatorios

Verifica que los cinco archivos existan en <directorio_de_salida> antes de concluir:

1. poster.pptx — Póster de PowerPoint nativo editable (formas, cadenas de texto, tablas booktabs, gráficos de alta DPI/nativos).
2. poster.pdf — PDF listo para impresión que conserva las dimensiones físicas exactas y las fuentes incrustadas.
3. poster_preview.png — Imagen de vista previa renderizada del póster completo.
4. poster_content.md — Contenido del póster extraído y destilado con notas de integridad.
5. design_specification.md — Informe completo de auditoría física, tipográfica, de contraste de color y de calidad (acompañado de validation_report.md).