Grants — NIH Funding Intelligence¶
Portability: Requires
bash_tool(for RePORTER POST via curl), Node.js withdocxpackage, and a Consensus MCP connection. Works in Claude Code CLI natively. In Claude.ai with Code Execution + Consensus MCP, the workflow is supported but slower.Scope: NIH-only. Non-NIH funders (PCORI, DOD CDMRP, VA, foundations) are out of scope and flagged at intake.
For a clinical researcher with a research idea, produce a strategic NIH funding overview as an editable .docx. Output covers research positioning analysis, institute mapping, targeted grant discovery, and strategic recommendations the researcher can edit, copy from, and share with their mentor.
Agent Integrity Rules (Research-Pack Convention)¶
Inherited; locked verbatim per PR #657 audit.
- Execution discipline. A step isn't complete until result is confirmed received. Consensus calls sequential with 1+ sec pause. RePORTER calls sequential.
- Data sourcing. Count only what tool calls returned this session. Never supplement with training knowledge. Training knowledge labeled
[Not from Consensus/RePORTER — reference information]and excluded from counts. - Counts & attribution. Queries sent / results shown / results cited — three separate numbers, never conflate. Every cited paper has retrievable URL from this session.
- Error handling. On failure → wait 3s → retry once → log. After 3 consecutive failures across tools: stop, alert researcher, explain what's missing. Never silently skip.
- Transparency. Audit Log section in the DOCX. Same standards in chat summary as in document.
See references/reporter_post_patterns.md for the RePORTER POST canon + plan-tier detection.
Phase 1: Grill-Me Intake (6 forcing questions, one at a time)¶
Q1 (root) — Research idea¶
Describe the research idea in 2–3 sentences. What's the question, what's new, and what's the clinical relevance? Vague answers ("AI for healthcare", "biomarkers for disease X") will be rejected — push for specificity.
Why I'm asking: Five Consensus searches (established / stakes / current approaches / adjacent methods / gaps) depend on a precise research idea. Vague ideas produce vague gap quotes and useless positioning narrative.
Refuse mush. Re-ask once with examples if user is too broad.
Q2 (depends on Q1) — Career stage¶
Career stage — pick one:
- Pre-doctoral (PhD student, T32 trainee)
- Postdoctoral fellow (F32, K99 candidate)
- Early career (K-award candidate, first R01)
- Independent investigator (multiple R01s, established lab)
- Senior PI (R35, P-series, U01 leadership)
Why I'm asking: Career stage filters mechanism recommendations. F-series for trainees, K-series for early career, R-series for independent. Picking the wrong stage produces unfundable mechanism suggestions.
Forcing choice.
Q3 (depends on Q2) — Preliminary data status¶
Preliminary data — pick one:
- None (de novo project, no pilot data yet)
- Pilot data (early findings, single-site)
- Strong preliminary (multi-experiment, ready for R01-scale)
- Validated and ready (multi-site, publication-ready)
Why I'm asking: Prelim data status drives mechanism budget. No data → R03 / R21 pilot scope. Strong prelim → R01 / U01 multi-site scale. Mismatch produces uncompetitive applications.
Q4 (depends on Q2) — Environment¶
Research environment — pick one:
- R01-eligible (research-intensive institution with NIH base funding)
- Mid-tier (regional academic medical center, modest NIH portfolio)
- Resource-constrained (smaller institution, minimal NIH base)
- Industry-collaborative (academic + industry partnership)
Why I'm asking: Environment affects scope realism (multi-site U01 requires R01-eligible) and which mechanism categories are competitive (R15 specifically targets resource-constrained).
Q5 (depends on Q1) — Submission posture¶
Submission posture — pick one:
- New application (first submission, no prior reviews)
- Resubmission (A1 with reviewer responses needed)
- Exploring (haven't decided yet whether to submit)
Why I'm asking: Resubmissions need reviewer-response guidance in the DOCX (Section 7). New applications skip that. Exploring shifts emphasis to landscape over strategy.
Q6 (depends on Q1) — Known institute targets¶
Are you already considering specific NIH institutes? List names (NCI / NHLBI / NIMH / NINDS / NIDDK / etc.) or say "no preference — find the right ones".
Why I'm asking: If you have an institute hypothesis, I'll validate it against RePORTER data. If not, I'll surface the top-3 institutes funding adjacent work from the institute-tally.
Accept "no preference" as the common case.
Stop condition: After Q6, commit and start Phase 2A. Never re-open intake after Phase 2A begins.
Phase 2A: Research Positioning (5 Consensus searches)¶
Run sequentially at 1 q/sec. Each search corresponds to one positioning facet:
- Established —
"<research idea>" established evidence— what's known - Stakes —
"<topic>" mortality OR burden OR cost OR prevalence— why it matters - Current Approaches —
"<topic>" current treatment OR standard of care OR approach— state of the art - Adjacent Methods —
"<related technique>" applied to <topic>— methodological possibilities - Gaps —
"<topic>" limitations OR unanswered OR future directions OR challenge— gap signals
Use scripts/citation_tracker.py --action record_consensus_search for each. Plan-tier detected from first response.
Synthesis: for each facet, extract 2-3 quotable findings (becomes Section 2 gap quotes). Draft Significance/Innovation language using "the field has established X (refs), but Y remains unanswered (refs)" pattern.
Phase 2B: Institute Mapping + Grant Discovery (RePORTER POST)¶
RePORTER is POST-only. Use bash_tool + curl — never web_fetch.
Dynamic fiscal year window¶
Compute at runtime via scripts/fiscal_year_calculator.py. Default: current FY + 3 prior. Federal FY starts Oct 1, so:
python ../scripts/fiscal_year_calculator.py --output json
# Returns: {"current_fy": 2026, "window": [2023, 2024, 2025, 2026]}
Narrow (AND) search — finds direct overlap¶
curl -X POST 'https://api.reporter.nih.gov/v2/projects/search' \
-H 'Content-Type: application/json' \
-d '{
"criteria": {
"fiscal_years": [2023, 2024, 2025, 2026],
"include_active_projects": true,
"advanced_text_search": {
"operator": "AND",
"search_field": "all",
"search_text": "<key term 1> <key term 2>"
}
},
"limit": 50,
"include_fields": ["project_num", "project_title", "agency_ic_admin", "study_section", "fiscal_year", "principal_investigators", "abstract_text"]
}'
Broad (OR) search — finds adjacent work¶
curl -X POST 'https://api.reporter.nih.gov/v2/projects/search' \
-H 'Content-Type: application/json' \
-d '{
"criteria": {
"fiscal_years": [2023, 2024, 2025, 2026],
"advanced_text_search": {
"operator": "OR",
"search_field": "all",
"search_text": "<term> <synonym> <related concept>"
}
},
"limit": 50
}'
Institute tally + study section ranking¶
After RePORTER responses:
- Tally agency_ic_admin (institute code: NCI, NHLBI, NIMH, etc.) → top-3 funding institutes
- Tally study_section → top-2 study sections (where applications go for review)
NOSI discovery¶
Parse RePORTER responses for NOT-* opportunity numbers. For each:
# NOSIs live at predictable URLs:
# https://grants.nih.gov/grants/guide/notice-files/NOT-<INSTITUTE>-<YEAR>-<NUMBER>.html
web_fetch <url>
If fetch fails: log [NOSI {number} — fetch failed, not included], continue.
Mechanism Matching (Scope-Aware)¶
NOT career stage alone. Career stage + project scope + prelim data drive recommendation.
Use scripts/mechanism_matcher.py:
python ../scripts/mechanism_matcher.py \
--career-stage "early_career" \
--prelim-data "pilot" \
--environment "r01_eligible" \
--scope "single_site" \
--output json
# Returns mechanism shortlist with rationale
See references/nih_mechanism_matching.md for the full matrix.
Phase 3: DOCX Generation¶
9 sections via Node.js + docx library. See references/docx_9_sections.md for full spec.
- Executive Summary — title + career stage + environment + 3-4 key findings bullets
- Research Positioning — 3-5 gap quotes (italicized, inline Consensus citations) + 2-3 paragraph positioning narrative + supporting evidence table
- Target Institutes — ranking table (institute, project count in window, % match to your idea) + 2-3 sentence interpretation
- Grant Opportunities — bold NOSI callout if any. Top-3 grants table with hyperlinked FOAs + per-grant scope/budget fit paragraph
- Funded Overlap — top-5 projects table (PI, project_num, IC, year, hyperlinked to RePORTER) + differentiation paragraph
- Study Sections — ranking table + best-match interpretation
- Strategic Recommendations & Next Steps — 3-4 numbered recs + mandatory program officer rec + submission timeline note + (if resubmission Q5=2) reviewer-response guidance + closing paragraph
- References — numbered bibliography, hyperlinked to Consensus
- Audit Log — Consensus searches table, plan-tier note, RePORTER searches table, NOSI fetches table, summary stats, tool constraints note, failed steps
Styling¶
Arial 12pt body, navy headings (#1a3a5c), light blue table headers (#e8f0f8), amber NOSI callout. ExternalHyperlink patterns:
- Paper citations: https://consensus.app/papers/...
- FOA links: https://grants.nih.gov/grants/guide/...
- RePORTER projects: https://reporter.nih.gov/project-details/<id>
Mandatory Program Officer Recommendation¶
Always include in Section 7:
Recommended next step: contact program officer at {top institute}. Find their staff page at https://www.nih.gov/institutes-nih/list-nih-institutes-centers-offices → {institute} → Program Officers. Prepare: 1-page specific aims + your CV + 3 specific questions about fit. Email subject: "Pre-application inquiry:
".
This is the single most valuable advice for any applicant. Never skip.
Submission Timeline (Embedded in DOCX Section 7)¶
| Mechanism | Standard receipt dates |
|---|---|
| R01, R21, R03 | Feb 5, Jun 5, Oct 5 |
| K awards (K01, K08, K23, K99) | Feb 12, Jun 12, Oct 12 |
| R34, R61/R33 | Feb 16, Jun 16, Oct 16 |
| F31, F32 | Apr 8, Aug 8, Dec 8 |
Phase 4: Deliver¶
- Save DOCX to
<output-dir>/grants_<topic-slug>_<YYYY-MM-DD>.docx - Chat summary: file path + audit counts + plan tier + verdict on institute targets
- Validate:
python scripts/office/validate.py <docx>
Tooling¶
| Script | Role |
|---|---|
scripts/citation_tracker.py |
Three-count audit (Consensus sent/shown/cited + RePORTER projects/cited) at ~/.grants_sessions/<session>.json |
scripts/fiscal_year_calculator.py |
Current FY + 3-prior window. Computed at runtime, never hardcoded. |
scripts/mechanism_matcher.py |
Career stage × scope × prelim → mechanism recommendation shortlist |
References¶
references/nih_mechanism_matching.md— career stage × scope × prelim → mechanism canon (7+ sources)references/reporter_post_patterns.md— RePORTER curl POST templates + plan-tier detection (7+ sources)references/docx_9_sections.md— 9-section .docx spec + technical requirements (7+ sources)
Error Handling¶
| Failure | Behavior |
|---|---|
| Consensus rate-limit hit | Wait 3s, retry once, log; if still failing, alert researcher |
| Consensus returns 0 for a facet | Surface explicitly; never fill with training knowledge |
| Consensus plan-tier cap detected | Log tier, note in audit, surface to researcher |
| RePORTER POST returns error | Retry once after 3s; if still failing, log and continue |
| RePORTER returns <5 on narrow | Document; broad OR should compensate; surface low count |
| NOSI fetch fails | Log [NOSI {n} — fetch failed], continue |
| 3 consecutive tool failures | Stop, alert researcher with what's missing |
| DOCX generation fails | Save raw data as JSON fallback so researcher doesn't lose work |
Anti-Patterns To Reject¶
- Parallelizing Consensus calls (will hit rate limit)
- Using
web_fetchfor RePORTER (POST-only —web_fetchis GET) - Hardcoded fiscal year values
- Mechanism recommendations based on career stage alone (must consider scope too)
- Silently filling thin facet results with training knowledge
- Skipping the audit log
- Skipping the program officer recommendation
- Conflating "papers found" with "papers shown" with "papers cited"
- Fabricating NOSI details when fetch fails
Version: 1.0.0
Source spec: megaprompts/08-grants-megaprompt.md
Build pattern: Path B (direct conversion). Research-pack sibling of pulse + litreview.