Escrita Científica

Propósito

Produzir prosa científica clara sem inventar evidências ou ocultar incertezas. Mantenha o rascunho, a verificação de evidências e a aprovação de submissão como etapas separadas.

Os autores humanos responsáveis controlam as decisões científicas e a aprovação final. A IA não é autora, e a fluência gerada nunca é evidência [SW-S01, SW-S03].

Regras de segurança inegociáveis

Confidencialidade

Não envie manuscritos não publicados, material de revisão por pares ou editorial, dados sensíveis ou restritos, PHI ou outros dados pessoais, conteúdo proprietário ou documentos de origem para um serviço externo sem:

1. autorização explícita de uma pessoa ou órgão com poder para concedê-la; e
2. uma revisão documentada da política da revista, institucional, do financiador, de consentimento, de ética, contratual, legal e de uso de dados.

Quando a autorização ou a política for incerta, mantenha o processamento local e use apenas os metadados mínimos necessários. A desidentificação requer revisão especializada; remover nomes óbvios não é suficiente. Veja references/authorship_ai_confidentiality.md.

Sem fabricação

Nunca invente ou complete:

• citações, referências, DOI, PMID, PMCID, ISBN, URLs ou citações;
• resultados, valores de dados, denominadores, tamanhos de amostra, unidades, estimativas de efeito, incerteza, testes estatísticos ou alegações de significância;
• métodos, materiais, detalhes do protocolo, versões de software, escolhas de análise ou desvios;
• registros, aprovações, consentimento, declarações de ética, detalhes do participante ou datas;
• autores, ordem dos autores, papéis CRediT, agradecimentos ou permissões;
• financiamento, papéis de patrocinador, conflitos, disponibilidade de dados ou código, ou divulgações de IA.

Use um estado explícito de ausente, não verificado ou não aplicável. Não substitua por um texto padrão plausível.

Vinculação de evidências

Toda alegação factual ou numérica do manuscrito deve ser mapeada para IDs de evidências verificadas. Um verificador humano deve abrir a fonte, confirmar a proposição e o localizador, verificar os metadados bibliográficos e registrar quem verificou e quando.

Trechos de pesquisa, resumos gerados, memória e a bibliografia de outro trabalho podem auxiliar na descoberta, mas não verificam uma alegação. Veja references/evidence_workflow.md.

Fidelidade científica

• Preserve a incerteza e as explicações alternativas.
• Distinga trabalhos confirmatórios, exploratórios, descritivos e post hoc.
• Mantenha métodos e resultados consistentes.
• Reconcilie unidades, denominadores, tamanhos de amostra, populações, pontos de tempo e rótulos.
• Para desfechos binários de ensaios, relate as contagens de eventos/denominadores do grupo, além de efeitos absolutos e relativos com incerteza quando a diretriz de relato os exigir. Distinga diferença de risco (pontos percentuais), risco relativo e odds ratio; não reescreva um como outro ou infira um efeito absoluto sem o risco de base. Veja explicação do CONSORT 2025.
• Relate achados negativos, nulos, adversos, inesperados, falhos e inconclusivos quando eles pertencerem ao registro do estudo.
• Declare limitações concretas e limite a generalização.
• Não converta associação em causalidade ou não significância em equivalência.

Entrada

Antes de redigir, obtenha ou marque o que não foi resolvido:

• tipo de documento, desenho do estudo, estágio, público e local de destino;
• instruções atuais para autores e data de acesso à política;
• protocolo, registro, plano de análise, emendas e diretriz de relato;
• escopo do manuscrito ou seção;
• manifesto de origem verificado e registro de alegações;
• métodos, resultados, tabelas, figuras e suplementos;
• autoria, CRediT, declarações e registros de aprovação;
• classificação de confidencialidade e limite de processamento autorizado;
• restrições de dados, código, materiais e repositório.

Não solicite material de origem restrito se metadados ou uma auditoria local executada pelo usuário forem suficientes.

Fluxo de trabalho

1. Estabelecer o espaço de trabalho local

Para um novo rascunho, gere opcionalmente andaimes em Markdown, JSON e CSV com falha fechada:

python3 scripts/scaffold_manuscript.py \
  --output-dir ./draft-workspace \
  --document-id local-draft \
  --study-design randomized_trial \
  --guideline consort-2025

O gerador nunca sobrescreve arquivos. Sua saída não está explicitamente pronta para submissão e contém placeholders que o linter rejeita.

2. Selecionar orientação de relato

Escolha pelo desenho real e tipo de artigo, em seguida, abra a declaração oficial atual, checklist, documento de explicação, extensões e instruções da revista de destino.

python3 scripts/select_reporting_guidelines.py select \

…