write-scientific

name	write-scientific
description	Gera prose acadêmica genérica quando o usuário tem texto-base ou só uma seção isolada e não cabe em paper/CEP/statistics. Aceita --seed, --section, --template. Citação strict do acervo.
when_to_use	Quando o usuário pedir "escreve essa seção", "expande este parágrafo", "me ajuda a redigir X", sem gênero formal específico.
argument-hint	[--section NAME] [--seed TEXT] [--template PATH] [--into PATH | --out PATH] [--lang pt-BR|en-US]
allowed-tools	Read Write Edit Glob Grep Bash(prumo write *) Bash(cat *)
prumo	{"version":"1.1.0","schema":"WriteOutput/v1","determinism":"agentic","agent_compat":["claude-code"],"cost_estimate":"~5-15k tokens","prose":true,"inputs":{"lang":"optional","section":"optional","seed":"optional","template":"optional","into":"optional","out":"optional","slug":"optional"},"requires":["cli"]}

Write Scientific — prose acadêmica genérica

Preflight (contrato ADR-0019) — execute ANTES de qualquer operação desta skill:

1. CLI: rode prumo --version. Se o comando NÃO existir: não simule NENHUMA operação desta skill; roteie para /prumo-assist:start (instalação guiada com consentimento) e pare aqui.
2. Drift CLI×plugin (evidência da Fase 0): se $CLAUDE_PLUGIN_ROOT estiver definido, compare a versão do CLI com o campo version de $CLAUDE_PLUGIN_ROOT/.claude-plugin/plugin.json. CLI mais antigo → avise ("CLI X < plugin Y — comandos novos podem não existir") e ofereça uv tool upgrade prumo-assist (rode SÓ com consentimento). Sem a variável, pule este passo em silêncio.
3. Estrutura: se o diretório não tiver references/ + docs/ de um pj_*, oriente prumo init pj_<nome> — NUNCA crie o scaffold manualmente (o agente não simula trabalho do CLI) e NUNCA cite tooling do monorepo do autor.

Recusar-se a operar sem dependência NÃO é falha — é o contrato fail-closed (D1): operação exata nunca é simulada.

Contrato de prosa (gerado de .github/scripts/prose_conventions.md — não edite este bloco).

1. Idioma. Já vem resolvido: prumo write prep --json devolve language e language_source (flag, pj_config ou default). Use esse valor e declare-o ao usuário com a origem — não releia pj_config.toml nem recomponha a cascata na mão. Para escrever em outro idioma, passe --lang pt-BR|en-US ao prep. Se language_source for default e o projeto tiver prosa em outro idioma, avise antes de escrever. Nunca traduza texto existente: se o idioma resolvido divergir do idioma do texto, avise e escreva no idioma do texto.
2. Citação no fim do período. Toda citação fica imediatamente antes do terminador do período (., ?, !), nunca no meio da frase. Sem exceção para autor-sujeito: reescreva (Liang et al. [@a] propõem X. → X foi proposto por Liang et al. [@a].). Isso vale também para a citação narrativa (@a sem colchetes), que é mid-período por construção: reescreva para a forma marcada no fim do período. Duas fontes sustentando claims distintos viram dois períodos, um para cada.
3. Agrupamento. Fontes que sustentam a mesma afirmação vão num colchete só, separadas por ; — [@a; @b; @c]. Nunca [@a], [@b] nem colchetes adjacentes.
4. Pontuação. Em texto corrido, sem —, : nem ;. Use vírgula, ponto, parênteses ou conectivo. Preservados em YAML, tabelas, URLs/DOIs, títulos da lista de referências e notação matemática.
5. Sem superlativo. Intensificador sem número não existe em escrita científica: remova (highly accurate → accurate) ou troque pelo valor medido. significant/significativo só no sentido estatístico, com p ou IC no mesmo período. Claim descalibrado (causalidade em desenho associacional, hedging excessivo, antropomorfismo de modelo) é sinalizado, nunca reescrito.
6. Voz e tempo. pt-BR impessoal ou passiva (avaliou-se, foram coletados); en-US aceita we ativo em Methods e Results (AMA/ICMJE) e evita passiva desnecessária. Methods e Results em pretérito; estado da arte no presente.
7. Padrão en-US (só quando o idioma resolvido é en-US). Ortografia americana (analyze, behavior, center, modeling); vírgula serial; decimal com ponto e milhar com vírgula (0.89, 1,200); pontuação final dentro das aspas; numerais exceto em início de período. Termo técnico em inglês sem itálico — o itálico é regra de pt-BR.

Skill flexível pra geração que não se encaixa em paper/CEP/statistics. Template default co-localizado: ./template.md — minimal. Override por projeto: <pj>/.claude/writing_templates/scientific.md. Override ad-hoc: --template <path>.

Regras invioláveis

1. Citação strict (mesmo padrão da família).
2. Aceita seed text via --seed <text> ou stdin (se conversa).
3. --section <name> foca em uma seção quando template tem várias.
4. PicotSpec opcional — se ausente, gera baseado só no seed/template.

Fluxo

Mesmo fluxo do write-paper, com --kind scientific — mais permissivo (PicotSpec opcional; se ausente, gere a partir do seed/template):

1. Carregar inputs — prumo write prep --kind scientific --json > /tmp/compose_prep.json. O JSON traz language + language_source (idioma já resolvido; declare ao usuário). Leia inputs + template_path. Use --seed/stdin como texto-base e --section pra focar uma seção, quando passados. 2-4. Resolver template → gerar prose → validar citação strict (idêntico aos outros).
2. Escrever output via prumo write draft:

   cat <<'DRAFT' | prumo write draft \
       --kind scientific \
       --mode drafts \
       --date "<hoje ISO>" \
       --slug "<slug derivado>" \
       --sections '["<seção>"]' --json
   <draft completo gerado>
   DRAFT
   

   (--mode into --into <path> --section <nome> ou --mode out --out <path> quando aplicável.)
3. Reportar.

Boundaries

• Não substitui os outros 3 — se gênero é claro (paper / CEP / statistics), use a skill específica.
• Não amplia escopo sem pedido — se usuário pede 1 parágrafo, gere 1 parágrafo.