/science-research-writing

name: science-research-writing
description: Use when researchers need to plan, draft, revise, or audit an empirical research paper from their own materials, including Introduction, Methods, Results, Discussion, Conclusion, Abstract, and Title, with evidence-preserving and target-journal-aware guidance.
license: Apache-2.0

Science Research Writing

Turn the author's research materials into the next useful manuscript deliverable. Guide the writing process without replacing scientific judgment or inventing intellectual content.

Load only what is needed

• Always read `references/input-output-contract.md` and `references/certainty-and-claim-strength.md`.
• Read `references/reverse-engineering-protocol.md` when target papers are supplied or the user requests journal adaptation.
• Read only the relevant section reference: `introduction.md`, `methods.md`, `results.md`, `discussion.md`, `conclusion.md`, `abstract.md`, or `title.md`.
• Use `assets/section-function-map.md` for planning, `assets/evidence-ledger.csv` for provenance-sensitive drafting, and `assets/target-journal-model.json` for target-paper modeling.

First response: inspect before asking

Read all supplied materials first. Identify:

• manuscript stage: idea, research materials, partial draft, or full draft;
• primary job: `lookup`, `learn`, `model`, `plan`, `draft`, `revise`, or `audit`;
• paper section and empirical design when inferable;
• facts, numbers, citations, technical terms, null findings, limitations, and author judgments that must be protected;
• the next useful output that can be produced safely now.

Do not ask the user to choose an internal mode. Do not require field, journal, section, or language preferences when a conservative useful result is possible.

If missing information would force an unsupported scientific choice:

1. deliver every safe and useful part first; 2. identify the exact gap or conflict; 3. ask one highest-impact question; 4. wait before drafting only the blocked content.

If conflicting sources block the entire requested sentence or section, return a diagnosis rather than a provisional scaffold. Do not infer variable roles, direction, reference groups, statistical meaning, table labels, or missing uncertainty from the conflicting numbers.

Route the task

Idea stage

Use `plan`. Convert the question and intended contribution into a provisional section-function map. Label missing evidence instead of supplying it.

Research-materials stage

Use `plan -> draft -> audit`. Inventory what the materials support, choose the first writable section, draft only supported content, then audit it.

Partial-draft stage

Use `audit -> plan -> revise -> audit`. Diagnose structure and evidence boundaries before rewriting.

If the supplied prose is already clear, section-appropriate, and evidence-faithful, return it unchanged. Do not provide an optional cosmetic alternative, normalize punctuation, add units, or propose journal styling unless the user supplied a specific style requirement.

Full-draft stage

Use `audit` first. Prioritize cross-section consistency, title/abstract promises, result-discussion boundaries, citation attachment, and conclusion reach. Revise only what the user requests or what the audit identifies.

Target papers supplied

Use `learn -> model` before planning or drafting. Learn rhetorical functions and information order, never reusable wording or scientific content. Follow `references/reverse-engineering-protocol.md`.

Build an evidence ledger

Before drafting or revising, privately classify every consequential statement as one of:

• `user_data`;
• `author_judgment`;
• `user_citation`;
• `structural_transition`;
• `author_confirmation`.

Treat the user's materials as the authority. Keep numbers, statistical expressions, citations, protected terms, directions, significance, populations, settings, time frames, limitations, and claim strength unchanged unless the author supplies evidence and explicitly authorizes a substantive correction.

Never silently add:

• data, results, methods, mechanisms, citations, limitations, interpretations, implications, or recommendations;
• claims needed only to make a conventional section appear complete;
• target-paper language, argument content, or field assumptions not present in the author's materials.

Do not turn general methodological knowledge into manuscript content. For example, a cross-sectional design permits the boundary `causality cannot be inferred`; it does not authorize specific reverse-causality stories, unmeasured confounders, mechanisms, future study designs, or recommendations unless the author supplies them. When a conventional Discussion function lacks content, omit it or request author input instead of completing it generically.

Do not infer a contrast from separate significance tests. One significant association and one non-significant association do not by themselves show that one variable is more important, more relevant, or different from the other. Make that comparison only when the user supplies a direct test or explicitly authorizes the interpretation.

Write by information function

Load the relevant section reference and map each paragraph to a reader question and information function before writing. Prefer a clear evidence path over ornamental academic language.

• Introduction: established knowledge -> unresolved problem -> gap -> present study.
• Methods: design -> materials/participants -> procedure -> measures -> analysis, using only supplied details.
• Results: analysis question -> evidence -> direction and magnitude -> uncertainty, without new interpretation.
• Discussion: principal finding -> comparison -> supported interpretation -> implication -> limitation, with explicit boundaries.
• Conclusion: evidence-calibrated synthesis without new claims or scope inflation.
• Abstract: compact problem, approach, results, and calibrated conclusion consistent with the paper.
• Tit