Revision & Response Document (psychrev-rebuttal)
Write the response after the theory has actually been revised. At a theory journal a
response that argues rather than strengthens the model fails. Revise first, then document.
When to trigger
- A major/minor revision decision has arrived
- You have reviewer comments and must produce a point-by-point response
- You are tempted to defend the model rather than improve it
- You must decide which asks change the theory and which are presentation
Read the letter for the theory, not the edits
Reviewers at Psychological Review are usually proponents or critics of the rival models. Their
comments encode theoretical demands beneath the surface wording. Before drafting, classify
every comment:
| Comment encodes... |
Response strategy |
| "Your model is the same as [rival]" |
Sharpen subsumption/differentiation; show the limiting case (psychrev-contribution-framing) |
| "How do you know this prediction follows?" |
Add/strengthen the derivation (psychrev-argument-development) |
| "Couldn't a simpler account do this?" |
Add the head-to-head on a diagnostic phenomenon |
| "Is this parameter identifiable?" |
Add parameter-recovery simulation (psychrev-boundary-conditions) |
| "The model explains too much" |
State scope and a breakdown regime |
| "What would falsify it?" |
Add a risky novel prediction |
| "This reads as empirical / out of scope" |
Reframe so data only constrain; re-establish fit |
Building the response document
- Open with the substantive changes, not gratitude boilerplate: a short paragraph naming
the two or three ways the theory is now stronger (new derivation, identifiability analysis,
scope statement, head-to-head comparison).
- Point-by-point, quoting each comment, then: what you changed, where (section/figure/eq.
number), and — only where you genuinely disagree — a respectful, evidence-based rebuttal.
- Show the theory changed. For a theory journal, "we clarified the wording" rarely
suffices when the comment was about the model; point to the new derivation, simulation, or
scope statement.
- Concede on your own terms. Where a reviewer is right that the model cannot do Y, fold Y
into the boundary conditions as a stated limit rather than over-reaching to cover it.
- Disagree carefully. You may push back on a rival-modeler reviewer, but only with a
derivation or a diagnostic comparison — never with assertion. Make the editor's adjudication easy.
Tone and discipline
- Respectful, specific, and concrete — every claim of "we revised" carries a location.
- Never dismissive of the rival models the reviewers represent.
- Track changes / a clearly marked revised manuscript accompanies the response (per portal).
- If two reviewers conflict, surface the conflict for the editor and state your principled choice.
Checklist
Anti-patterns
- Arguing the model is fine instead of strengthening it (fatal at a theory journal)
- "We thank the reviewer" boilerplate with no located change
- Defending against a rival-modeler reviewer by assertion rather than derivation
- Over-reaching to cover a phenomenon a reviewer rightly flagged, instead of bounding it
- Cosmetic edits in response to a substantive theoretical objection
- Ignoring a reviewer conflict and hoping the editor does not notice
Output format
【Summary of strengthening】[2–3 ways the theory is now stronger]
【Point-by-point】[comment → change made → location | or reasoned rebuttal with derivation]
【Theory changes】[new derivations / simulations / scope statements added]
【Concessions】[phenomena now bounded out, on our terms]
【Editor notes】[any reviewer conflicts surfaced + principled choice]
【Next step】psychrev-submission (resubmission preflight)
1---2name: psychrev-rebuttal3description: Use when a Psychological Review decision letter (usually a major revision) has arrived and you must write the response document and revise the theory. Drafts the response and revision plan; it does NOT run the resubmission preflight (psychrev-submission) or build new theory from scratch (psychrev-theory-construction).4---56# Revision & Response Document (psychrev-rebuttal)78> Write the response **after** the theory has actually been revised. At a theory journal a9> response that argues rather than strengthens the model fails. Revise first, then document.1011## When to trigger1213- A major/minor revision decision has arrived14- You have reviewer comments and must produce a point-by-point response15- You are tempted to defend the model rather than improve it16- You must decide which asks change the theory and which are presentation1718## Read the letter for the theory, not the edits1920Reviewers at Psychological Review are usually proponents or critics of the rival models. Their21comments encode *theoretical* demands beneath the surface wording. Before drafting, classify22every comment:2324| Comment encodes... | Response strategy |25|-----------------------------------------------------|--------------------------------------------------|26| "Your model is the same as [rival]" | Sharpen subsumption/differentiation; show the limiting case (`psychrev-contribution-framing`) |27| "How do you know this prediction follows?" | Add/strengthen the derivation (`psychrev-argument-development`) |28| "Couldn't a simpler account do this?" | Add the head-to-head on a diagnostic phenomenon |29| "Is this parameter identifiable?" | Add parameter-recovery simulation (`psychrev-boundary-conditions`) |30| "The model explains too much" | State scope and a breakdown regime |31| "What would falsify it?" | Add a risky novel prediction |32| "This reads as empirical / out of scope" | Reframe so data only constrain; re-establish fit |3334## Building the response document35361. **Open with the substantive changes**, not gratitude boilerplate: a short paragraph naming37 the two or three ways the theory is now stronger (new derivation, identifiability analysis,38 scope statement, head-to-head comparison).392. **Point-by-point**, quoting each comment, then: what you changed, where (section/figure/eq.40 number), and — only where you genuinely disagree — a respectful, evidence-based rebuttal.413. **Show the theory changed.** For a theory journal, "we clarified the wording" rarely42 suffices when the comment was about the model; point to the new derivation, simulation, or43 scope statement.444. **Concede on your own terms.** Where a reviewer is right that the model cannot do Y, fold Y45 into the boundary conditions as a stated limit rather than over-reaching to cover it.465. **Disagree carefully.** You may push back on a rival-modeler reviewer, but only with a47 derivation or a diagnostic comparison — never with assertion. Make the editor's adjudication easy.4849## Tone and discipline5051- Respectful, specific, and concrete — every claim of "we revised" carries a location.52- Never dismissive of the rival models the reviewers represent.53- Track changes / a clearly marked revised manuscript accompanies the response (per portal).54- If two reviewers conflict, surface the conflict for the editor and state your principled choice.5556## Checklist5758- [ ] Every reviewer comment addressed point-by-point, quoted, with a located change59- [ ] Each theoretical ask answered with a *theory* change (derivation/simulation/scope), not just wording60- [ ] Disagreements backed by derivation or diagnostic comparison, never bare assertion61- [ ] Concessions folded into boundary conditions rather than over-reaching62- [ ] Conflicting reviewer demands surfaced for the editor with a principled resolution63- [ ] A summary of the main strengthening opens the document64- [ ] Revised manuscript marked (track changes) and consistent with the response6566## Anti-patterns6768- Arguing the model is fine instead of strengthening it (fatal at a theory journal)69- "We thank the reviewer" boilerplate with no located change70- Defending against a rival-modeler reviewer by assertion rather than derivation71- Over-reaching to cover a phenomenon a reviewer rightly flagged, instead of bounding it72- Cosmetic edits in response to a substantive theoretical objection73- Ignoring a reviewer conflict and hoping the editor does not notice7475## Output format7677```78【Summary of strengthening】[2–3 ways the theory is now stronger]79【Point-by-point】[comment → change made → location | or reasoned rebuttal with derivation]80【Theory changes】[new derivations / simulations / scope statements added]81【Concessions】[phenomena now bounded out, on our terms]82【Editor notes】[any reviewer conflicts surfaced + principled choice]83【Next step】psychrev-submission (resubmission preflight)84```
brycewang-stanford