/update-results-discussion
The section exists and needs to change. This is the most frequently updated section in any
manuscript: reviewers ask for extra experiments, data gets reanalysed, and drafts stall halfway
through the figure list.
Assume the text was correct once. This is a revision, not a rewrite. In this section that rule
is stricter than elsewhere: the researcher's interpretations are theirs, and you preserve them
verbatim unless the data no longer supports them, in which case you flag it rather than replacing
them.
Before anything else
- Load the style rules. Invoke
paper-writing-style. If absent, use the condensed rules in
create-results-discussion.
- Lock the language. Language of the user's first message, whole run. Output LaTeX is English.
- Read the context. The section, all figures and captions, tables, the
.bib, any data files,
and the introduction and conclusions.
Pick the mode
State the mode before starting.
| Mode |
Signal |
What it does |
| A. Integrate new or revised data |
New figures, changed values, a reanalysis |
Fold the new results in and fix what they contradict |
| B. Apply suggestions |
Reviewer comments, co-author notes, /review-results-discussion output |
Incorporate each change deliberately |
| C. Resume |
The section stops partway through the figure list |
Continue from where it stopped |
Where several apply, run B, then C, then A.
Mode A here is not the same as reconcile-against-the-paper elsewhere: this section is the paper's
evidence, so what it reconciles against is the data.
Mode A: integrate new or revised data
- Inventory what changed. List every value, figure and table that differs from what the section
describes. Read the figures and data files; do not rely on the researcher's summary alone.
- Report the consequences, in this order of severity:
- An interpretation the new data contradicts. Most serious. Quote the interpretation, the old
value and the new one, and stop. Do not rewrite the interpretation yourself; ask the
researcher what the new data means. This is their science.
- A comparison that no longer holds, for example a result that was better than prior work and
now is not.
- A value stated in the text that no longer matches the figure.
- A new result with no block at all, needing a full four-class block written.
- A figure whose number changed, breaking
\ref ordering and the narrative sequence.
- A result now removed but still discussed.
- Check the downstream sections. New or changed results almost always invalidate something in
the abstract, the conclusions or the introduction's gap. Name what is now stale and suggest
/update-abstract, /update-conclusions and /update-introduction rather than editing them
here.
Mode B: apply suggested updates
Reviewer comments on this section cluster into recognizable requests:
| Comment |
Usually means |
| "The discussion is superficial" |
Interpretation and comparison classes are thin or missing |
| "How does this compare to X?" |
A missing comparison block. Ask for the values; never invent them |
| "The mechanism is not supported" |
The interpretation overclaims relative to the evidence. The researcher decides how to soften it |
| "Statistics needed" |
Out of scope for the wording. Say so and leave it |
| "Figure N is unclear" |
Usually the caption, not the figure. Check self-containment first |
| "Too long" |
Which blocks compress. Background sentences are the usual candidate |
Then:
- Enumerate every suggestion as a numbered item, splitting reviewer prose.
- Classify each: direct, interpretive, conflicting, out of scope.
- Apply, propose, resolve. Requests that need new scientific claims are not yours to satisfy:
surface them and ask.
- Account for every item, including the ones not applied and why.
Where a request conflicts with the house style, apply it and note the tension. The reviewer outranks
the style guide.
Mode C: resume after a pause
- Inventory the figure list and mark which figures already have blocks. This shows exactly where
the draft stopped, and it is usually mid-figure-list rather than mid-sentence.
- Run the information-class matrix over the blocks that exist. A stalled draft often has several
blocks with description only, written quickly before the writer ran out of momentum.
- Ask for what is genuinely missing, in batches of at most four: the values for undescribed
figures, and the interpretation for each. Read the data files first so you only ask for what the
files do not contain.
- Match the existing voice: tense pattern, hedging level, caption style, how much background
each block carries.
- Check the narrative order still works. A resumed section commonly loses the thread of why the
figures are in this sequence. Say so if the order no longer tells a story.
Do not restyle the blocks already written. If they have defects, say so and suggest
/review-results-discussion separately.
Produce the revision
Emit the changed blocks as LaTeX fragments with information-class labels, and:
- Preserve the researcher's wording and interpretations.
- Emit only the blocks that changed, not the whole section, since it is long. Say clearly which
blocks you are showing and leave the rest untouched.
- Mark each change:
% UPDATED: retention now 96\% per Fig.~4,
% ADDED: comparison block, reviewer 2 asked about Park 2024,
% FLAG: this interpretation may no longer hold, see note above.
% TODO: for every value or interpretation you could not obtain.
Show the fragments, then summarize. Finish by listing which other sections are now stale.
Offer to write it out
Only after approval.
Hard rules
- Never invent, estimate or infer a value. Not from a figure, not from a trend. This is the
section where fabrication does the most damage.
- Never write or rewrite an interpretation the researcher did not give you. If new data breaks an
old interpretation, flag it and ask. Supplying a mechanism is inventing science.
- Never invent a comparison citation.
- Never emit an em dash.
-- only in numeric ranges.
- Never silently drop researcher text, an interpretation, or a suggestion.
- If nothing needs changing, say so and change nothing.
1---2name: update-results-discussion3description: Update Results Discussion4---56# /update-results-discussion78The section exists and needs to change. This is the most frequently updated section in any9manuscript: reviewers ask for extra experiments, data gets reanalysed, and drafts stall halfway10through the figure list.1112Assume the text was correct once. This is a **revision, not a rewrite**. In this section that rule13is stricter than elsewhere: **the researcher's interpretations are theirs**, and you preserve them14verbatim unless the data no longer supports them, in which case you flag it rather than replacing15them.1617## Before anything else18191. **Load the style rules.** Invoke `paper-writing-style`. If absent, use the condensed rules in20 `create-results-discussion`.212. **Lock the language.** Language of the user's first message, whole run. Output LaTeX is English.223. **Read the context.** The section, all figures and captions, tables, the `.bib`, any data files,23 and the introduction and conclusions.2425## Pick the mode2627State the mode before starting.2829| Mode | Signal | What it does |30| :--- | :--- | :--- |31| **A. Integrate new or revised data** | New figures, changed values, a reanalysis | Fold the new results in and fix what they contradict |32| **B. Apply suggestions** | Reviewer comments, co-author notes, `/review-results-discussion` output | Incorporate each change deliberately |33| **C. Resume** | The section stops partway through the figure list | Continue from where it stopped |3435Where several apply, run B, then C, then A.3637Mode A here is not the same as reconcile-against-the-paper elsewhere: this section *is* the paper's38evidence, so what it reconciles against is the data.3940## Mode A: integrate new or revised data41421. **Inventory what changed.** List every value, figure and table that differs from what the section43 describes. Read the figures and data files; do not rely on the researcher's summary alone.442. **Report the consequences**, in this order of severity:45 - **An interpretation the new data contradicts.** Most serious. Quote the interpretation, the old46 value and the new one, and stop. **Do not rewrite the interpretation yourself**; ask the47 researcher what the new data means. This is their science.48 - **A comparison that no longer holds**, for example a result that was better than prior work and49 now is not.50 - **A value stated in the text that no longer matches the figure.**51 - **A new result with no block at all**, needing a full four-class block written.52 - **A figure whose number changed**, breaking `\ref` ordering and the narrative sequence.53 - **A result now removed** but still discussed.543. **Check the downstream sections.** New or changed results almost always invalidate something in55 the abstract, the conclusions or the introduction's gap. Name what is now stale and suggest56 `/update-abstract`, `/update-conclusions` and `/update-introduction` rather than editing them57 here.5859## Mode B: apply suggested updates6061Reviewer comments on this section cluster into recognizable requests:6263| Comment | Usually means |64| :--- | :--- |65| "The discussion is superficial" | Interpretation and comparison classes are thin or missing |66| "How does this compare to X?" | A missing comparison block. Ask for the values; never invent them |67| "The mechanism is not supported" | The interpretation overclaims relative to the evidence. The researcher decides how to soften it |68| "Statistics needed" | Out of scope for the wording. Say so and leave it |69| "Figure N is unclear" | Usually the caption, not the figure. Check self-containment first |70| "Too long" | Which blocks compress. Background sentences are the usual candidate |7172Then:73741. **Enumerate every suggestion** as a numbered item, splitting reviewer prose.752. **Classify each**: *direct*, *interpretive*, *conflicting*, *out of scope*.763. **Apply, propose, resolve.** Requests that need new scientific claims are not yours to satisfy:77 surface them and ask.784. **Account for every item**, including the ones not applied and why.7980Where a request conflicts with the house style, apply it and note the tension. The reviewer outranks81the style guide.8283## Mode C: resume after a pause84851. **Inventory the figure list** and mark which figures already have blocks. This shows exactly where86 the draft stopped, and it is usually mid-figure-list rather than mid-sentence.872. **Run the information-class matrix** over the blocks that exist. A stalled draft often has several88 blocks with description only, written quickly before the writer ran out of momentum.893. **Ask for what is genuinely missing**, in batches of at most four: the values for undescribed90 figures, and the interpretation for each. Read the data files first so you only ask for what the91 files do not contain.924. **Match the existing voice**: tense pattern, hedging level, caption style, how much background93 each block carries.945. **Check the narrative order still works.** A resumed section commonly loses the thread of why the95 figures are in this sequence. Say so if the order no longer tells a story.9697Do not restyle the blocks already written. If they have defects, say so and suggest98`/review-results-discussion` separately.99100## Produce the revision101102Emit the changed blocks as LaTeX fragments with information-class labels, and:103104- **Preserve the researcher's wording and interpretations.**105- Emit **only the blocks that changed**, not the whole section, since it is long. Say clearly which106 blocks you are showing and leave the rest untouched.107- Mark each change: `% UPDATED: retention now 96\% per Fig.~4`,108 `% ADDED: comparison block, reviewer 2 asked about Park 2024`,109 `% FLAG: this interpretation may no longer hold, see note above`.110- `% TODO:` for every value or interpretation you could not obtain.111112Show the fragments, then summarize. Finish by listing which other sections are now stale.113114## Offer to write it out115116Only after approval.117118## Hard rules119120- **Never invent, estimate or infer a value.** Not from a figure, not from a trend. This is the121 section where fabrication does the most damage.122- **Never write or rewrite an interpretation the researcher did not give you.** If new data breaks an123 old interpretation, flag it and ask. Supplying a mechanism is inventing science.124- **Never invent a comparison citation.**125- **Never emit an em dash.** `--` only in numeric ranges.126- **Never silently drop** researcher text, an interpretation, or a suggestion.127- If nothing needs changing, say so and change nothing.