Sci Writing

---
name: sci-writing
description: Use to choose the Science format (Research Article vs Report) and hold its length and structure budgets — main text, word/figure caps, and what belongs in Supplementary Materials.
---

# Main-Text Writing & Format (sci-writing)

## When to trigger

- Unsure whether the work is a **Report** or a **Research Article**.
- The main text is over length, or Methods are bloating the body.
- The structure wanders (lab-notebook order instead of argument order).
- Co-authors keep adding paragraphs and the paper is creeping past budget.

## Pick the format first

| Format               | Use when                                                | Main-text target | Display items |
|----------------------|---------------------------------------------------------|------------------|---------------|
| **Report**           | A single, decisive advance told quickly                 | ~2,500 words     | ≤ 4 (figs+tables) |
| **Research Article** | A larger study needing more development/multiple results | ~4,500 words     | ≤ 6 (figs+tables) |

> Numbers are working targets; confirm current caps in the author guidelines. The principle is fixed: **Science main texts are short**, and most detail lives in Supplementary Materials.

## What goes where

- **Main text (Report)**: no section headers beyond the flow; combined results-and-discussion narrative. **Methods are NOT in the main text** — they go to Supplementary Materials (Materials and Methods).
- **Main text (Research Article)**: may use brief headers; still lean. Extended methods → Supplementary.
- **Supplementary Materials**: full Materials and Methods, supplementary figures/tables, supplementary text, captions, and additional data. This is where rigor lives without bloating the body.

## Structure as argument, not chronology

Order the Results by the **logic of the claim**, not the order experiments were run:

1. Establish the phenomenon (the headline result).
2. Rule out the obvious alternative explanations.
3. Show the mechanism / generality.
4. Demonstrate the broad implication.

Each Results paragraph: **claim sentence first**, then the evidence (figure callout + numbers), then the inference.

## Length discipline tactics

- One idea per paragraph; lead sentence is the claim.
- Move any sentence that a general reader can skip → Supplementary.
- Methods detail, validation, controls → Supplementary (cited as "fig. S3", "table S1").
- Cut "In order to" → "To"; cut "It is worth noting that"; cut throat-clearing.

## Reference and supplement cross-refs

- Main figures: "Fig. 1"; supplementary: "fig. S1" (lowercase f); tables: "Table 1" / "table S1".
- Supplementary Materials are cited in the main text and listed at the end.

## Output format

```
【Format】 Report (~2,500w / ≤4 items) or Research Article (~4,500w / ≤6 items)
【Current main-text word count】 N → over/under budget by M
【Methods location】 main text (FIX → move to SM) / Supplementary (ok)
【Results order】 argument-ordered? yes/no
【Items in main vs SM】 main: [...] / SM: [...]
【Next】 sci-figures
```

## Anti-patterns

- **Do not** keep a full Methods section in a Report's main text.
- **Do not** structure Results chronologically when a logical order is clearer.
- **Do not** treat the word cap as negotiable by shrinking font in figures — move content to SM instead.
- **Do not** add a standalone Discussion that repeats Results; integrate the interpretation.