1---2name: research-rebuttal3description: Draft venue-aware academic rebuttals and author responses from reviewer comments, scores, and paper artifacts. Use when concrete reviewer comments already exist and Codex needs to analyze reviews, build a reviewer issue board, plan evidence or manuscript fixes, draft a rebuttal, respond to AC or meta-review feedback, manage multi-round author-reviewer discussion, or prepare a paste-ready response for conference or journal review systems. Prefer `research-paper-review` for initial manuscript diagnosis before reviews arrive, `research-review-loop` for internal tracked review without external reviewer comments, and `research-novelty-review` for prior-art positioning disputes.4---56# Research Rebuttal78## Quick start9101. Decide whether this stays standalone or becomes `./rebuttal/` inside an orchestrated research suite.112. Route the venue first with `references/venue_rule_matrix.md`; if dates, limits, or policy details are decision-critical, re-check the official venue source before finalizing.123. Initialize the rebuttal pack with `scripts/init_rebuttal_pack.py` unless usable artifacts already exist.134. Build the review analysis and issue board before drafting prose.145. Convert major issues into concrete evidence or manuscript tasks, then draft the correct artifact shape and verify limits with `scripts/count_limits.sh`.1516## Modes1718### Standalone mode1920- Work from pasted reviews, PDFs, screenshots, or local notes.21- Do not require a suite root.22- If the user asks for project-level sequencing, current-state inspection, or coordination across multiple research stages, invoke `research-pipeline-planner` first instead of treating rebuttal drafting as the whole task.23- Remain collaboration-friendly: if `research-paper-plan`, `research-review-loop`, experiment outputs, or manuscript diffs already exist, use them.2425### Orchestrated mode2627- Prefer the canonical directory `./rebuttal/`.28- Read upstream context from `research-brief.md`, `artifact-index.md`, `./paper-plan/`, `./review-loop/`, and relevant result artifacts when present.29- Keep outputs legible to later manuscript revision, camera-ready planning, or follow-up review rounds.3031## Relationship to sibling skills3233- `research-paper-review` should usually happen before rebuttal if the paper still needs a first-pass technical diagnosis.34- `research-review-loop` should track internal revision rounds and issue closure between rebuttal iterations.35- `research-rebuttal` starts when there are concrete reviewer comments and a venue-specific response artifact to produce.36- `research-novelty-review` is a helper when the central dispute is novelty or prior-art overlap rather than general reviewer response.3738## Handling review inputs3940- Pasted text: use directly, but check whether the paste is complete.41- PDF review bundles: extract all review text, scores, and confidence values before analysis.42- Screenshots: transcribe visible review content and flag truncation or unreadable regions.43- OpenReview or CMT links: treat raw platform access as unreliable; ask for pasted review text if needed.44- Paper PDF or source: read as needed to cross-reference challenged claims, tables, or sections.45- If review metadata is incomplete, proceed conservatively and label the missing fields rather than inventing them.4647## Input contract4849- Minimum:50 - concrete reviewer feedback or review text51 - target venue or best-known venue family52- Prefer:53 - scores and confidence values54 - paper PDF, source, or exact section references55 - existing experimental logs, tables, or manuscript diffs56 - deadline and artifact constraints5758## Hard stops5960- Stop if there is no concrete review text or reviewer feedback artifact.61- Stop if the venue materially changes the artifact but cannot be inferred well enough to pick a conservative route.62- Stop if the draft would require invented evidence, fabricated experiments, or unverified manuscript changes.63- In standalone mode, do not force a scaffold pack when a compact direct response is enough.6465## Output contract6667- Primary files:68 - `review-analysis.md`69 - `issue-board.md`70 - `task-list.md`71 - `rebuttal-working.md`72 - `rebuttal-paste-ready.md`73- Optional file:74 - `ac-note.md`75- In orchestrated mode, these live under `./rebuttal/`.76- The working draft may contain `[INTERNAL]` notes; the paste-ready draft must not.7778## Workflow7980### 1) Route venue and policy constraints first8182- Use `references/venue_rule_matrix.md` to choose the artifact structure:83 - one-shot PDF84 - per-review response85 - threaded discussion86 - rolling revision response87 - single-feedback response88- Use `references/platforms_and_policies.md` for platform mechanics, anonymity, disclosure, link, revision, and LLM-policy checks.89- If venue information is incomplete, state the assumption and choose the most conservative valid route.90- Treat dated limits, windows, and policy details as unstable. Re-check official venue sources before final submission when those details matter.9192### 2) Analyze reviews and build the issue board9394- Summarize each reviewer's decision logic, score, confidence, and likely AC-facing concern in `review-analysis.md`.95- Build `issue-board.md` using `references/issue_board_guide.md`.96- Extract a score matrix first. As a default heuristic, treat reviewers as:97 - Champion: strong accept signal or clearly positive language98 - Persuadable: mixed review or borderline score99 - Entrenched: strongly negative decision logic unlikely to flip100- Spend most rebuttal budget on Persuadable reviewers and committee-facing concerns, while maintaining Champion support.101- Group shared concerns across reviewers and mark severity aggressively:102 - Major-Blocking103 - Major-Addressable104 - Minor105 - Misunderstanding106- Classify reviewer stance as Champion, Persuadable, or Entrenched using `references/writing_principles.md`.107- Use an explicit issue-board shape rather than free-form notes. For example:108109```text110issue_id | reviewer | severity | category | strategy | status | shared_with111R1-1 | R1 | Major-Blocking | baselines | TBD | open |112R2-1 | R2 | Misunderstanding | novelty | TBD | open |113R3-1 | R3 | Major-Addressable | ablations | TBD | open | R1-1114```115116- If the user asked only for triage or analysis, stop after the analysis and issue board.117118### 3) Choose response strategies per issue119120- Use `references/response_strategies.md`.121- Prefer one or more of:122 - Accept and fix123 - Clarify misunderstanding124 - Partial agree and narrow claim125 - Respectful disagreement126 - Out of scope127 - Escalate to AC128- Strategy choice must depend on factual correctness, acceptance impact, and venue policy constraints, not rhetorical preference.129- Compound strategies are often correct:130 - clarify misunderstanding + accept a presentation fix131 - accept and fix + provide new evidence132 - partial agree + narrow the claim133- Do not promise evidence you do not have. Missing evidence becomes a task, not a rhetorical flourish.134135### 4) Convert strategy into an execution plan136137- Fill `task-list.md` with owner if known, required input, evidence source, whether the task blocks drafting, and whether it changes the manuscript, rebuttal, or both.138- Prefer real evidence over promises. If evidence is missing, turn the gap into an explicit task rather than bluffing.139- Pull in upstream research artifacts when available:140 - `research-paper-plan` for claim and section mappings141 - `research-review-loop` for tracked issues across rounds142 - experiment or results artifacts for numbers and provenance143144### 5) Draft the correct artifact145146- Draft `rebuttal-working.md` first, then strip it down into `rebuttal-paste-ready.md`.147- Match the venue family:148 - one-shot PDF venues: merge repeated concerns and lead with the few issues most likely to affect the decision149 - per-review venues: keep replies self-contained150 - threaded venues: optimize for concise follow-ups and delta replies151 - rolling venues: emphasize revision plan over argument152- Use direct answer -> evidence -> implication structure.153- Keep every response self-contained enough that the reviewer or AC can scan it without hunting through the manuscript.154- For venues with strict character budgets, allocate rough space before writing:155 - opener or global summary: 10-15%156 - per-reviewer core responses: 75-80%157 - closing or summary of changes: 5-10%158- Use the working draft as the evidence-rich version and the paste-ready draft as the platform-safe compressed artifact.159- Example of a good response shape:160161```text162[R2] Missing comparison to MethodX163Direct answer: We agree this comparison is decision-relevant and have now run it.164Evidence: Table 2 below shows +2.1 points over MethodX on Dataset A.165Implication: This resolves the concern that our gains came only from benchmark selection.166```167168- Avoid defensive responses such as:169 - "the reviewer failed to notice"170 - "it is obvious"171 - "we will fix this in the camera-ready" without evidence or a venue-legal commitment172173### 6) Run mandatory safety gates174175- Provenance gate:176 - every number, experimental result, section reference, and manuscript change must trace to a real source177- Commitment gate:178 - do not claim a manuscript change or experiment unless it already exists or is explicitly labeled as planned179- Coverage gate:180 - every Major-Blocking and Major-Addressable issue must be closed, deferred with justification, or explicitly accepted as a risk181- Verify size limits with `scripts/count_limits.sh <file> [--chars|--words|--pages] [--limit N]`.182- If `paper-review/final_issues.json` or `review-loop/REVIEW_STATE.json` exists, cross-check that the rebuttal does not quietly contradict the internal diagnosis.183184### 7) Handle follow-up rounds carefully185186- Update the issue board rather than rewriting the whole response from scratch.187- Reply only to new or still-open points.188- Increase technical specificity, not argumentative intensity.189- If a disagreement persists after repeated rounds, summarize the positions cleanly and let the committee adjudicate.190- In multi-round venues, treat the issue board as the source of truth and write delta replies only.191192## Scripts193194- `scripts/init_rebuttal_pack.py`: create deterministic rebuttal scaffolds in a standalone directory or `./rebuttal/`.195- `scripts/count_limits.sh`: measure chars, words, or rough page equivalents after stripping common markup.196197## References198199- `references/issue_board_guide.md`200- `references/platforms_and_policies.md`201- `references/response_strategies.md`202- `references/venue_rule_matrix.md`203- `references/writing_principles.md`204- `../research-pipeline-planner/references/review-stage-contract.md`