ahsanmandhar-ui/research-poster-maker

Skill de Criação de Pôsteres Científicos

Produza pôsteres científicos prontos para conferências que pareçam ter sido projetados por um designer gráfico acadêmico experiente (adequados para conferências da Nature, reuniões do BMJ, ACC, ASN, congressos europeus e simpósios universitários) — nunca infográficos genéricos de IA.

Todos os caminhos de arquivo abaixo são relativos ao diretório raiz deste skill (research-poster-maker/).

---

Regras Fundamentais Inegociáveis

1. Zero Fabricação Científica: Nunca invente tamanhos amostrais, estimativas de efeito, intervalos de confiança, valores de p, contagens de exclusão, citações, números de bolsas ou afiliações. Preserve a precisão decimal exata, unidades e o enquadramento de significância estatística.
2. Destile a Prosa — Não Cole Paredes de Texto: Transforme parágrafos do manuscrito em afirmações analíticas concisas e de alta clareza, com tópicos paralelos (~350–600 palavras no corpo no total), preservando o significado exato.
3. Nunca Reduza Todas as Fontes para Currículo Excessivo: Se o conteúdo transbordar um layout em tamanhos legíveis à distância de visualização, reescreva a prosa prolixa, remova pontos secundários de contexto, reequilibre colunas ou troque de layout.
4. Design Editorial Contido: Evite cartões idênticos e arredondados ao redor de cada seção, clip-art/emojis decorativos, sombras projetadas, gradientes arco-íris e o azul médico padrão. Use regras tipográficas limpas, espaços em branco intencionais, alto contraste WCAG e visualizações de dados reais.
5. Relatórios de Impressão e Técnicos Honestos: Nunca aumente a resolução de uma imagem raster de baixa resolução e afirme que ela tem 300 DPI. Nunca afirme conformidade com PDF/X de impressão offset CMYK em saídas sRGB. Reporte dimensões exatas, fator de escala do .pptx (se > 56 pol) e o back-end de exportação de PDF de forma transparente.

---

Fluxo de Trabalho Passo a Passo

Etapa 1 — Inspecione o Material de Pesquisa Disponível Primeiro

Antes de fazer perguntas ao usuário, localize e inspecione todos os manuscritos fornecidos (.docx, .pdf, .md, .txt), conjuntos de dados (.csv, .xlsx) e figuras/logotipos existentes:

python scripts/analyze_research.py <arquivos_ou_pasta_de_entrada> --output-dir <diretorio_trabalho>

Revise <diretorio_trabalho>/research_extraction.json e <diretorio_trabalho>/extraction_summary.md para verificar os 18 campos canônicos (Título, Autores/Afiliações, Contexto, Lacuna de Pesquisa, Objetivos, Desenho do Estudo, Métodos, População, Tamanho Amostral, Métodos Estatísticos, Desfecho Primário, Desfechos Secundários, Descobertas Importantes, Tabelas/Figuras, Limitações, Conclusão, Referências, Financiamento/Agradecimentos).

Etapa 2 — Solicite Apenas Informações Essenciais Ausentes

Não apresente um longo questionário quando o manuscrito já fornecer os detalhes do estudo. Pergunte de forma concisa apenas quando:

• Faltarem fatos científicos críticos na fonte (por exemplo, autores/afiliações ausentes ou números do desfecho primário ausentes) e não puderem ser inferidos.
• As dimensões/orientação do painel da conferência não foram especificadas (ofereça um padrão regional sensato — por exemplo, 48 × 36 pol paisagem ou ISO A0 retrato — claramente rotulado como suposição).
• A marca/logotipo institucional ou URL do QR do estudo for desejada.

Etapa 3 — Selecione a Arquitetura e Consulte os Documentos de Referência Conforme Necessário

Carregue os guias de referência detalhados de docs/ sob demanda:

• Dimensões, limite de 56 pol do PowerPoint e especificações de impressão: docs/print-specifications.md
• Paletas de cores e anti-padrões editoriais: docs/design-system.md
• Combinações tipográficas e escalas de ponto para distância de visualização: docs/typography.md
• 8 Estratégias de composição de layout: docs/layout-recipes.md
• 15 Tipos de gráficos/diagramas científicos: docs/visualization-guide.md
• Integridade científica e regras de extração: docs/scientific-integrity.md
• Contraste WCAG 2.1 e segurança para daltonismo Okabe-Ito: docs/accessibility.md

Modelos disponíveis em templates/<id>/template.json:

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

Receitas de layout disponíveis:

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

Paletas disponíveis:

• academic_navy | charcoal_ivory | deep_teal | burgundy_offwhite | forest_cream | monochrome_editorial (além de substituições hex personalizadas)

Etapa 4 — Apresente a Especificação de Design Pré-Geração Resumida

Antes da renderização final, apresente um bloco de especificação conciso:

Pôster: Pesquisa Clínica
Orientação: Paisagem
Dimensões: 48 × 36 polegadas (explícito / padrão assumido)
Layout: clinical_workflow (30% : 41% : 29%)
Tipografia: IBM Plex Sans
Paleta: Oxford Navy & Crisp White (#0F2742 / #FFFFFF / #D55E00)
Foco visual: Curva de desfecho primário Kaplan-Meier + tabela de resultados de subgrupo
Saída: PPTX + PDF + PNG + Relatórios de Conteúdo e Design

Etapa 5 — Crie poster_spec.json e Execute o Pipeline de Produção

Construa <diretorio_trabalho>/poster_spec.json estritamente a partir dos dados fonte verificados:

{
  "template_id": "clinical-research",
  "dimensions_preset": "48x36",
  "layout_recipe": "clinical_workflow",
  "palette": "academic_navy",
  "font_pairing": "clinical_precision",
  "study_badge": "COORTE MULTICÊNTRICA PROSPECTIVA · STROBE",
  "title": "Título Exato Verificado do Estudo em Case Sentence",
  "authors_line": "Primeiro Autor, MD¹; Segundo Autor, PhD²",
  "affiliations_line": "¹Depto. de Medicina, Instituição A; ²Depto. de Bioestatística, Instituição B",
  "study_url": "https://doi.org/...",
  "logo_path": null,
  "items": [
    {
      "id": "background",
      "column": 0,
      "item_type": "text",
      "style": "editorial_rule",
      "title": "01  Contexto Clínico e Objetivo",
      "paragraphs": ["Contexto conciso extraído da fonte."],
      "bullets": ["Objetivo: Hipótese primária precisa."]
    },
    {
      "id": "primary_outcome",
      "column": 1,
      "item_type": "callout",
      "style": "focal_callout",
      "title": "Desfecho Clínico Primário",
      "hero_metric": "aHR 0,68 (IC 95% 0,56–0,82; p < 0,001)",
      "paragraphs": ["Resumo analítico exato do achado primário."]
    },
    {
      "id": "fig1",
      "column": 1,
      "item_type": "figure",
      "title": "03  Sobrevida Livre de Eventos Acumulada",
      "chart_spec": {
        "id": "fig1_km",
        "chart_type": "kaplan_meier",
        "width_in": 16.5,
        "height_in": 9.2,
        "x_label": "Acompanhamento (Meses)",
        "y_label": "Sobrevida Livre de Eventos",
        "data": { "groups": [], "risk_times": [], "stat_summary": "..." }
      },
      "caption": "Figura 1. Curvas de sobrevida de Kaplan-Meier com número em risco (N = ...)."
    },
    {
      "id": "tbl1",
      "column": 2,
      "item_type": "table",
      "title": "04  Desfechos Multivariáveis",
      "table_data": {
        "headers": ["Desfecho", "HR Ajustado (IC 95%)", "valor-p"],
        "rows": [["Composto primário", "0,68 (0,56–0,82)", "<0,001"]],
        "col_weights": [1.9, 1.3, 0.7]
      },
      "footnote": "Ajustado para covariáveis basais pré-especificadas."
    }
  ],
  "colophon": {
    "references": ["[1] Autor et al. Journal Ano;Vol:Paginas."],
    "funding": "Financiamento: ID da Bolsa.",
    "correspondence": "Correspondência: [email protected]"
  },
  "missing_information_notes": []
}

Execute o gerador unificado (que executa geração de gráficos, solução de layout, criação do PPTX, exportação para PDF, renderização da pré-visualização PNG e validação de QA em múltiplas camadas):

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

Estágios individuais do pipeline também podem ser invocados independentemente por meio de scripts/generate_charts.py, scripts/export_poster.py, scripts/generate_preview.py e scripts/validate_poster.py.

Etapa 6 — Inspeção Visual e Refinamento Iterativo Controlado

1. Leia <diretorio_trabalho>/output/validation_report.md para confirmar que as verificações Técnicas, Científicas, de Acessibilidade e Visuais foram aprovadas.
2. Inspecione visualmente <diretorio_trabalho>/output/poster_preview.png usando ferramentas de visualização de imagem sempre que disponíveis. Verifique a hierarquia visual geral, equilíbrio das colunas, legibilidade dos gráficos, alinhamento e espaços em branco.
3. Se algum problema for encontrado (Gerar → Exportar → Renderizar → Inspecionar → Validar → Revisar → Finalizar), ajuste poster_spec.json (condense tópicos prolixos, ajuste as atribuições de column ou aspect_ratio, ou troque de layout_recipe) e execute novamente. Pare quando as verificações objetivas passarem ou relate honestamente qualquer restrição não resolvida (como uma fotografia fornecida pelo usuário de baixa resolução).

---

Lista de Verificação de Entregáveis Obrigatórios

Verifique se todos os cinco arquivos existem em <diretorio_saida> antes de concluir:

1. poster.pptx — Pôster nativo editável do PowerPoint (formas, textos, tabelas booktabs, gráficos nativos em alta DPI).
2. poster.pdf — PDF pronto para impressão preservando as dimensões físicas exatas e fontes incorporadas.
3. poster_preview.png — Imagem de pré-visualização renderizada do pôster completo.
4. poster_content.md — Conteúdo do pôster extraído e destilado com notas de completude.
5. design_specification.md — Relatório completo de auditoria física, tipográfica, de contraste de cores e de QA (acompanhado por validation_report.md).