Home
cd ../playbooks
Academic ResearchIntermediate

Grant Proposal Reviser

Apply reviewer and collaborator feedback to grant proposal drafts with voice-consistent revisions, change tracking, and automatic backups.

10 minutes
By communitySource
#grants#proposals#revision#feedback#academic#writing

Your grant got a 'revise and resubmit' with 3 pages of reviewer comments, your co-PI emailed contradictory suggestions, and the resubmission deadline is in 2 weeks. Integrating everyone's feedback without losing your voice or breaking the narrative is a nightmare.

Who it's for: researchers revising grant proposals after reviewer feedback, PIs incorporating co-investigator suggestions, postdocs iterating on fellowship applications, grant writers managing multi-round revisions, academic teams resubmitting to funding agencies

Example

"Revise my NIH R01 proposal using these reviewer comments and my co-PI's feedback" → Updated draft with all feedback addressed, your writing voice preserved, change tracking showing what was modified, backup of the original, and a response-to-reviewers document mapping each critique to the revision

CLAUDE.md Template

New here? 3-minute setup guide → | Already set up? Copy the template below.

# Grant Proposal Reviser

## Your Role
You apply reviewer and collaborator feedback to grant proposal drafts while preserving the writer's voice. You track changes, create backups, and flag conflicts with funder preferences.

## Feedback Input Methods

1. **Conversational** — direct dictation or typed comments
2. **Comments file** — structured feedback from `comments:path`
3. **Formal reviewer** — categorized responses from `reviewer:path`

## Instructions

### Step 1: Locate the Draft

Find the proposal draft:
1. Check arguments for explicit file path
2. Look for recently modified proposal files
3. Ask the user to confirm

Read the draft fully before making changes.

### Step 1.5: Check Context

- Identify the funder from the draft content
- Look for donor profile at `~/Proposal_Resources/donors/`
- Review any prior revision notes in the document

### Step 2: Collect and Organize Feedback

**Conversational input:** Extract specific change requests from the user's message.

**Comments file:** Parse structured feedback from the specified file.

**Formal reviewer (reviewer:path):** Categorize each comment:
- **MUST ADDRESS** — critical issues, likely caused rejection
- **SHOULD ADDRESS** — important improvements
- **CONSIDER** — minor suggestions, incorporate if aligned
- **DISAGREE** — draft respectful response with reasoning

Flag any feedback that conflicts with donor profile preferences.

### Step 3: Apply Revisions

For each change:
1. Locate the relevant section in the draft
2. Apply the revision while maintaining voice consistency
3. Record what changed and why

**Voice consistency rules:**
- Short, direct sentences
- Active voice preference
- Numbers and specifics over adjectives
- Claims-first topic sentences
- No unnecessary section reorganization

Apply PROPOSAL_VOICE.md rules if the file exists.

### Step 4: Save and Report

1. **Backup** — create `.bak` copy of the original
2. **Save** — write updated draft with refreshed revision notes
3. **Report:**

```
REVISION COMPLETE
─────────────────
Round: [N]
Changes: [N] sections modified
Word count: [before] → [after]
Placeholders remaining: [N]
Backup: [path.bak]

Changes made:
- [Section]: [What changed] — [Why]
- [Section]: [What changed] — [Why]

Next steps:
- [Remaining items to address]
```

## Voice Pack

If `PROPOSAL_VOICE.md` exists at the project root or a configured path, load and apply those rules instead of the defaults. Voice pack rules take priority.

## Conflict Flagging

If reviewer feedback conflicts with donor profile values:
```
CONFLICT: Reviewer suggests [X], but [Funder] typically prefers [Y].
Recommendation: [Keep original / Apply with modification / Flag for discussion]
```
README.md

What This Does

Takes feedback in multiple formats — conversational input, structured comments files, or formal reviewer reports — and applies revisions to your proposal draft while preserving your writing voice. Creates backups, tracks changes, and reports what was modified.


Prerequisites

  • Source draft in markdown format
  • Optional: voice pack (PROPOSAL_VOICE.md), donor profiles

Quick Start

Step 1: Have Your Draft Ready

Your proposal draft should be a markdown file.

Step 2: Download the Template

Click Download above, then save to your project directory.

Step 3: Run Claude Code

claude

Then any of:

  • "Revise the proposal based on: [paste feedback]"
  • "Revise proposal with comments from comments.md"
  • "Apply reviewer feedback from reviewer-report.md"

Three Feedback Input Methods

Method Syntax Best For
Conversational Just type or dictate feedback Quick notes, verbal feedback
Comments file comments:path/to/file Collaborator written feedback
Reviewer report reviewer:path/to/file Formal reviewer comments with categorization

Formal reviewer comments are auto-categorized:

Category Priority Handling
MUST ADDRESS Critical Incorporate directly
SHOULD ADDRESS Important Incorporate where possible
CONSIDER Optional Address if aligned with strategy
DISAGREE Response needed Draft respectful rebuttal

The Revision Workflow

  1. Locate draft — from arguments, recent files, or ask user
  2. Review prior revisions — check revision notes for context
  3. Extract funder preferences — check donor profile for conflicts
  4. Collect and organize feedback — categorize by priority
  5. Apply changes — revise sections while preserving voice
  6. Backup and report — save .bak, report changes, list next steps

Voice Consistency Rules

Revisions maintain your established voice:

  • Short, direct sentences
  • Active voice preference
  • Numbers and specifics over adjectives
  • Claims-first topic sentences
  • No unnecessary section reorganization

If a PROPOSAL_VOICE.md exists, those rules override defaults.


Change Tracking

Each revision includes:

  • Revision date and round number
  • What was changed and why (bullet list)
  • Remaining [PLACEHOLDER] count
  • Word count change (before → after)
  • The .bak backup file path

Tips

  • Automatic backups — .bak file created before every save
  • Donor profile conflicts — if feedback conflicts with funder values, Claude flags it
  • Preserves structure — doesn't reorganize sections unless feedback requires it
  • Round tracking — maintains revision history across multiple passes
  • Pairs with Grant Proposal Writer — write first draft, then iterate with this

Troubleshooting

Revisions changed my voice Create a PROPOSAL_VOICE.md with your specific style rules

Feedback conflicts flagged Review the conflicts — some reviewer suggestions may not align with funder priorities

Draft file not found Specify the path explicitly: "Revise the proposal at ~/proposals/draft.md"

Too many changes at once Apply feedback in stages — address MUST items first, then SHOULD, then CONSIDER

$Related Playbooks

Academic Research

Grant Proposal Writer

Generate first-draft funding proposals from structured inputs, project data, and donor intelligence with voice-consistent academic writing.

20 minutes
Advanced
Academic Research

Git Commit Workflow

Structured approach to git commits with quality checks, meaningful messages, and proper staging. Never commit broken code.

5 minutes
Beginner
Academic Research

Idea Catalyst

Find cross-domain research inspiration by decomposing problems, searching other fields, and synthesizing transferable insights.

15 minutes
Intermediate
Academic Research

Iterative Build & Fix Loop

Run builds in a loop that automatically detects errors, fixes them, and re-runs until the build succeeds. Works with any build system: npm, cargo, go, make, gradle, and more.

10 minutes
Intermediate
Academic Research

Interactive Research Interview

Use Claude as an interviewer to formalize vague ideas into concrete specifications. Transform 'I have this intuition...' into a clear research plan.

5 minutes
Beginner
Academic Research

Knowledge Base Builder

Build a structured knowledge base for your domain with notation registries, application databases, design principles, and anti-patterns.

20 minutes
Intermediate
Academic Research

Literature Review Synthesis

Systematically search, analyze, and synthesize research literature. Extract key findings, identify gaps, and produce structured literature reviews.

10 minutes
Intermediate
Academic Research

Manuscript Referee Review

Get a thorough pre-submission review with referee-style objections. Identify weaknesses before reviewers do, and strengthen your paper proactively.

10 minutes
Intermediate
Academic Research

Paper Figures to PowerPoint

Extract all figures, tables, and equations from a research paper PDF and generate a polished PowerPoint deck automatically.

10 minutes
Intermediate
Academic Research

Multi-Agent Parallel Review

Run multiple specialized review agents in parallel — proofreader, code reviewer, security auditor, etc. Each agent focuses on one dimension with full attention.

15 minutes
Intermediate
Academic Research

Orchestrator Contractor Mode

Let Claude autonomously coordinate multi-step tasks like a contractor — planning, implementing, reviewing, fixing, and verifying without constant supervision.

10 minutes
Intermediate
Academic Research

Parallel Task Agents

Spawn multiple Claude agents simultaneously to handle independent subtasks. Review 3 papers at once, analyze multiple files in parallel, or run concurrent simulations.

5 minutes
Intermediate

Browse all Academic Research playbooks →