---
name: brycewang-stanford/ahr-revision-and-response
source: https://app.decimal.ai/s/brycewang-stanford-ahr-revision-and-response@1/SKILL.md
source_sha256: b1e2116c787f
---

# Revision & Response (ahr-revision-and-response)

An AHR decision typically comes with **multiple expert reports** (the journal uses at least six
readers). An R&R is a strong signal at a journal that accepts roughly **8–10%**. The response must
convert demanding specialists while keeping the editor confident the revision converges — without
diluting the historiographical intervention.

## When to trigger

- An R&R arrived and you are planning the revision + response letter
- Reviewers disagree with each other and you must reconcile their demands
- A reviewer challenges your reading of a source or asks for more archival work
- Writing the cover note to the editor summarizing the revision

## Strategy

1. **Read the editor's letter as the rubric.** The editor signals which points are decisive; solve
   those first. The editor adjudicates disagreements among readers.
2. **One point-by-point response, every comment addressed.** Quote each comment, then respond. Silence
   reads as non-compliance.
3. **Concede or rebut explicitly, with evidence.** For each: did what was asked (say where, with the
   new passage/note), or push back **respectfully with a reason** grounded in sources, historiography,
   or interpretation. Historians respect a well-argued disagreement more than a hollow capitulation.
4. **Answer source challenges with the archive.** If a reviewer doubts a reading, return to the
   document — quote more fully, supply provenance, or qualify the claim (see
   `ahr-sources-and-archives`).
5. **Reconcile conflicting readers openly.** When two reviewers want opposite things, say so, choose a
   principled path, and explain the tradeoff to the editor.
6. **Protect the intervention.** Add evidence and nuance; resist changes that flatten the argument or
   over-extend it beyond what the sources bear.
7. **Keep anonymity intact** in the revised manuscript (still double-blind) and ensure new notes stay
   in **Chicago** form (see `ahr-citation-and-style`).

## Response-letter format

For each reviewer comment:

```
> [Quoted reviewer comment]

Response: [What we did / why we respectfully disagree, grounded in sources or historiography].
Change: [Section/page/note where the revision appears].
```

Open with a short **summary of the main changes** to the editor; group by reviewer; end each entry with
the location of every change so the editor can verify quickly.

## Anti-patterns

- Ignoring or merging away a comment without a visible response
- Capitulating to a request that breaks the argument just to please a reader
- Defensive or dismissive tone toward reviewers
- "We thank the reviewer" with no actual change or argued reason
- Adding claims the sources cannot bear to satisfy a reviewer
- Letting the revised manuscript reveal the author's identity

## Triage table for an AHR reviewer demand

With at least six expert readers, an AHR R&R generates more requests than any revision can adopt wholesale.
Sort each demand before you draft the response so the editor sees principled judgment, not reflexive
compliance.

| Demand from a report | Disposition | The venue-specific move |
|----------------------|-------------|-------------------------|
| Goes to the editor's decisive points | Adopt first | Make the change and cite the exact section/note in the letter |
| "Read this source more fully" | Adopt with evidence | Return to the document; quote more, supply provenance, or qualify |
| Two readers want opposite things | Choose openly | Pick a principled path and explain the tradeoff to the editor |
| Would flatten or over-extend the argument | Rebut respectfully | Decline with a reason grounded in sources or historiography |
| "Do more archival work" | Scope honestly | Add what is feasible; mark what exceeds the article and why |

## Worked vignette: reconciling two readers

Suppose Reader A wants the manuscript's microhistorical chapter expanded into the heart of the article,
while Reader B wants it cut as a digression. Capitulating to either breaks something. The response letter
names the conflict explicitly, then chooses a principled middle: the micro case stays but is reframed so it
visibly carries the article's general claim (answering B's "digression" worry) without ballooning into a
second paper (answering A only in part). The letter tells the editor exactly why — the case earns its space
by doing argumentative work, not by length — and points to the revised transition that makes that work
legible. Each new footnote is in Chicago form and the revised file remains masked.

## Calibration anchors

- An R&R at a journal with single-digit acceptance is a genuine signal; protect the historiographic
  intervention rather than diluting it to placate every reader (confirm current acceptance figures against
  the journal's current submission guidelines).
- The editor adjudicates among the AHA flagship's many readers; treat the editor's letter as the rubric and
  solve its decisive points before the marginal ones.
- New evidence must be real archival material in correct Chicago notes, and the resubmitted manuscript stays
  double-blind — anonymity is not relaxed at the revision stage.

## Output format

```
【Editor's decisive points】addressed first? [list]
【Coverage】every reviewer comment answered? [Y/N]
【Concede vs rebut】each tagged with evidence + change location
【Source challenges】answered from the archive? [Y/N]
【Reviewer conflicts】reconciled and explained to editor? [Y/N]
【Intervention protected + anonymity kept】[Y/N]
【Next】resubmit via ScholarOne
```

## Supplementary resources

- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — review model, reviewer count, acceptance rate
- [`../../resources/external_tools.md`](../../resources/external_tools.md) — manuscript prep and Chicago-notes tooling