/review-introduction
Diagnose an introduction on all three dimensions the course defines: the information it carries,
the way its ideas flow, and how it uses the literature. Report specific rewrites, not impressions.
This reviews the writing, not the science.
Before anything else
- Load the style rules. Invoke
paper-writing-style and read references/human-voice.md.
- Lock the language. Use the language of the user's first message for the whole run. Any
rewritten text is English.
- Get the material. Read the introduction, and the rest of the manuscript if available: the
results section is what tells you whether the introduction's promises are kept. Read the
.bib file to audit the citations.
Dimension 1: information
Label each paragraph, and each sentence within it, with the movement it implements:
| Label |
Movement |
CONTEXT |
Broad field, its importance, terms and jargon defined |
GAP |
What is unresolved, unexplained, contested, or too costly |
SOTA |
Where the knowledge frontier is now |
PURPOSE |
What this paper does |
NONE |
Implements no movement. A finding in itself |
Present it as a table of paragraph number, opening words, and label.
Then report:
- Missing movements, most serious first. A missing purpose is fatal. A missing gap makes the
paper look unnecessary. A missing state of the art is the commonest omission and means the
reader cannot tell whether anything was advanced.
- Order. Movements should run context, gap, state of the art, purpose. Purpose belongs in the
last paragraph; flag it appearing early unless it works.
- Paragraphs labelled
NONE. Say what would be lost by deleting them.
- Proportion. Three paragraphs of context and one sentence of gap is the usual imbalance.
Dimension 2: flow
The section must funnel from general to specific, continuously, and never widen back out.
- Trace the funnel. For each paragraph, state whether it is broader than, narrower than, or
level with the one before. Report every place it widens.
- Check inside paragraphs too. A paragraph should also narrow across its own sentences.
- Check the purpose is the narrowest point in the whole section. Nothing should be more
specific than what this paper set out to do.
Report a widening as a concrete problem: name the two paragraphs and what the reader loses.
Dimension 3: citation and referencing
Audit against the three classes the course defines:
| Class |
Should appear in |
Check |
| Seminal, founding the field or technique |
Context, sometimes gap |
Present at all? |
| Most recent relevant work |
State of the art, gap |
Check the years. How old is the newest citation? |
| High-impact work between the poles |
Relevance and motivation |
Present? |
Then check:
- Recency. If the newest citation is more than two years old, say so plainly. It reads as out
of touch and reviewers notice.
- Density. A gap or state-of-the-art claim with no citation at all is a defect. So is a
paragraph where every sentence carries four keys.
- Placement. A seminal 1997 paper cited as the state of the art is a misuse of the class.
- Uncited claims. Any statement about the field or prior work that carries no reference.
- Keys that are not in the
.bib, which will not compile.
Text reuse. If a passage reads as copied rather than restated, flag it. The rule is absolute:
citation records where an idea came from, never where text came from. Paraphrasing while citing is
correct; reproducing sentences while citing is still plagiarism. The one exception is a direct
quotation in quotation marks, which is rare in this genre. Flag suspected reuse as something for
the researcher to verify; do not accuse.
Style pass
Report each hit with the sentence and a rewrite:
- Em dashes. Any
---, or -- outside a numeric range.
- Specificity. Any sentence that could appear unchanged in another paper in the field.
- Sentence length. Any sentence whose opening is forgotten by its end.
- Nominalization.
an improvement was observed for improved.
- Redundancy, including
introduce a new, which appears constantly in purpose paragraphs.
in this work, which should be in this paper, in this study or here we report.
- Words to use sparingly.
preliminary, careful, novel, successfully.
- Plain English.
utilization, in order to, the majority of, due to the fact that.
- Empty openers.
it is important to note that.
- AI tells.
delve, harness, leverage, underscore, pave the way, crucial role,
in recent years there has been growing interest in.
- Stacked passive voice.
- Monotonous sentence openers. If most sentences in a paragraph open subject-then-verb, the
paragraph lacks rhythm. Propose replacements using an adverb, a prepositional phrase, a
dependent clause or an infinitive phrase.
- Ambiguity.
as or since where because is meant; any pronoun with two possible referents.
- Abbreviations defined at first use, not stacked several to a short sentence.
Do not flag however, moreover, in contrast, nevertheless, in this paper,
here we report, Recently, significant advances have been made in X \cite{}, or single
deliberate hedges. These are the vocabulary the course teaches. Flagging them is a false positive
and makes the whole review untrustworthy.
Connection to the rest of the paper
Only if the manuscript is available, and this is the check reviewers make hardest:
- Does the gap get answered? Every gap the introduction states should have its counterpart in
the results and discussion. A promise the paper never keeps is the commonest structural fault in
a manuscript.
- Does the purpose match? Compare the introduction's final paragraph against the abstract's
purpose and the conclusions. All three should agree.
- Is the relevance claim supported by what the paper actually shows?
Report each mismatch naming both places.
Deliver
- The three labelled tables: movements, funnel trace, citation audit.
- Structural verdict, most serious first.
- Style hits, each with sentence and rewrite.
- Connection mismatches against the rest of the paper.
- One rewritten introduction as a LaTeX fragment with movement labels, applying everything
above, with
% TODO: where the researcher must supply a citation or a fact.
Then ask whether to apply it. Never edit their files unasked.
Hard rules
- Never invent a citation to fill a gap you found. Name what is needed.
- Never invent recent literature. If the state of the art is thin, report that it is thin and
ask the researcher which papers belong there.
- Never emit an em dash.
- Separate the writing verdict from scientific merit.
- If the introduction is already good, say so and keep the review short rather than manufacturing
findings.
1---2name: review-introduction3description: Review a scientific paper introduction from a writing perspective, labelling each paragraph and sentence with the movement it implements (contextualization, gap, state of the art, purpose), checking the general-to-specific funnel, auditing the three citation classes, and reporting style defects with concrete rewrites. Use when asked to review, critique, check or improve an introduction.4---56# /review-introduction78Diagnose an introduction on all three dimensions the course defines: the information it carries,9the way its ideas flow, and how it uses the literature. Report specific rewrites, not impressions.1011This reviews the writing, not the science.1213## Before anything else14151. **Load the style rules.** Invoke `paper-writing-style` and read `references/human-voice.md`.162. **Lock the language.** Use the language of the user's first message for the whole run. Any17 rewritten text is English.183. **Get the material.** Read the introduction, and the rest of the manuscript if available: the19 results section is what tells you whether the introduction's promises are kept. Read the20 `.bib` file to audit the citations.2122## Dimension 1: information2324Label each paragraph, and each sentence within it, with the movement it implements:2526| Label | Movement |27| :--- | :--- |28| `CONTEXT` | Broad field, its importance, terms and jargon defined |29| `GAP` | What is unresolved, unexplained, contested, or too costly |30| `SOTA` | Where the knowledge frontier is now |31| `PURPOSE` | What this paper does |32| `NONE` | Implements no movement. A finding in itself |3334Present it as a table of paragraph number, opening words, and label.3536Then report:37381. **Missing movements**, most serious first. A missing purpose is fatal. A missing gap makes the39 paper look unnecessary. A missing state of the art is the commonest omission and means the40 reader cannot tell whether anything was advanced.412. **Order.** Movements should run context, gap, state of the art, purpose. Purpose belongs in the42 last paragraph; flag it appearing early unless it works.433. **Paragraphs labelled `NONE`.** Say what would be lost by deleting them.444. **Proportion.** Three paragraphs of context and one sentence of gap is the usual imbalance.4546## Dimension 2: flow4748The section must funnel from general to specific, continuously, and never widen back out.4950- **Trace the funnel.** For each paragraph, state whether it is broader than, narrower than, or51 level with the one before. Report every place it widens.52- **Check inside paragraphs too.** A paragraph should also narrow across its own sentences.53- **Check the purpose is the narrowest point** in the whole section. Nothing should be more54 specific than what this paper set out to do.5556Report a widening as a concrete problem: name the two paragraphs and what the reader loses.5758## Dimension 3: citation and referencing5960Audit against the three classes the course defines:6162| Class | Should appear in | Check |63| :--- | :--- | :--- |64| Seminal, founding the field or technique | Context, sometimes gap | Present at all? |65| Most recent relevant work | State of the art, gap | **Check the years.** How old is the newest citation? |66| High-impact work between the poles | Relevance and motivation | Present? |6768Then check:6970- **Recency.** If the newest citation is more than two years old, say so plainly. It reads as out71 of touch and reviewers notice.72- **Density.** A gap or state-of-the-art claim with no citation at all is a defect. So is a73 paragraph where every sentence carries four keys.74- **Placement.** A seminal 1997 paper cited as the state of the art is a misuse of the class.75- **Uncited claims.** Any statement about the field or prior work that carries no reference.76- **Keys that are not in the `.bib`**, which will not compile.7778**Text reuse.** If a passage reads as copied rather than restated, flag it. The rule is absolute:79citation records where an idea came from, never where text came from. Paraphrasing while citing is80correct; reproducing sentences while citing is still plagiarism. The one exception is a direct81quotation in quotation marks, which is rare in this genre. Flag suspected reuse as something for82the researcher to verify; do not accuse.8384## Style pass8586Report each hit with the sentence and a rewrite:8788- **Em dashes.** Any `---`, or `--` outside a numeric range.89- **Specificity.** Any sentence that could appear unchanged in another paper in the field.90- **Sentence length.** Any sentence whose opening is forgotten by its end.91- **Nominalization.** `an improvement was observed` for `improved`.92- **Redundancy**, including `introduce a new`, which appears constantly in purpose paragraphs.93- **`in this work`**, which should be `in this paper`, `in this study` or `here we report`.94- **Words to use sparingly.** `preliminary`, `careful`, `novel`, `successfully`.95- **Plain English.** `utilization`, `in order to`, `the majority of`, `due to the fact that`.96- **Empty openers.** `it is important to note that`.97- **AI tells.** `delve`, `harness`, `leverage`, `underscore`, `pave the way`, `crucial role`,98 `in recent years there has been growing interest in`.99- **Stacked passive voice.**100- **Monotonous sentence openers.** If most sentences in a paragraph open subject-then-verb, the101 paragraph lacks rhythm. Propose replacements using an adverb, a prepositional phrase, a102 dependent clause or an infinitive phrase.103- **Ambiguity.** `as` or `since` where `because` is meant; any pronoun with two possible referents.104- **Abbreviations** defined at first use, not stacked several to a short sentence.105106Do **not** flag `however`, `moreover`, `in contrast`, `nevertheless`, `in this paper`,107`here we report`, `Recently, significant advances have been made in X \cite{}`, or single108deliberate hedges. These are the vocabulary the course teaches. Flagging them is a false positive109and makes the whole review untrustworthy.110111## Connection to the rest of the paper112113Only if the manuscript is available, and this is the check reviewers make hardest:114115- **Does the gap get answered?** Every gap the introduction states should have its counterpart in116 the results and discussion. A promise the paper never keeps is the commonest structural fault in117 a manuscript.118- **Does the purpose match?** Compare the introduction's final paragraph against the abstract's119 purpose and the conclusions. All three should agree.120- **Is the relevance claim supported** by what the paper actually shows?121122Report each mismatch naming both places.123124## Deliver1251261. The three labelled tables: movements, funnel trace, citation audit.1272. Structural verdict, most serious first.1283. Style hits, each with sentence and rewrite.1294. Connection mismatches against the rest of the paper.1305. **One rewritten introduction** as a LaTeX fragment with movement labels, applying everything131 above, with `% TODO:` where the researcher must supply a citation or a fact.132133Then ask whether to apply it. Never edit their files unasked.134135## Hard rules136137- **Never invent a citation** to fill a gap you found. Name what is needed.138- **Never invent recent literature.** If the state of the art is thin, report that it is thin and139 ask the researcher which papers belong there.140- **Never emit an em dash.**141- Separate the writing verdict from scientific merit.142- If the introduction is already good, say so and keep the review short rather than manufacturing143 findings.