Literature Review
Conduct a structured literature search and synthesis on the given topic.
Input: $ARGUMENTS — a topic, paper title, research question, or phenomenon to investigate.
Steps
Parse the topic from $ARGUMENTS. If a specific paper is named, use it as the anchor.
Search for related work using available tools:
- Check
master_supporting_docs/supporting_papers/ for uploaded papers
- Use
WebSearch to find recent publications (if available)
- Use
WebFetch to access working paper repositories (if available)
- Read any existing
.bib file for papers already in the project
Organize findings into these categories:
- Theoretical contributions — models, frameworks, mechanisms
- Empirical findings — key results, effect sizes, data sources
- Methodological innovations — new estimators, identification strategies, inference methods
- Open debates — unresolved disagreements in the literature
Identify gaps and opportunities:
- What questions remain unanswered?
- What data or methods could address them?
- Where do findings conflict?
Extract citations in BibTeX format for all papers discussed.
Save the report to quality_reports/lit_review_[sanitized_topic].md
Output Format
# Literature Review: [Topic]
**Date:** [YYYY-MM-DD]
**Query:** [Original query from user]
## Summary
[2-3 paragraph overview of the state of the literature]
## Key Papers
### [Author (Year)] — [Short Title]
- **Main contribution:** [1-2 sentences]
- **Method:** [Identification strategy / data]
- **Key finding:** [Result with effect size if available]
- **Relevance:** [Why it matters for our research]
[Repeat for 5-15 papers, ordered by relevance]
## Thematic Organization
### Theoretical Contributions
[Grouped discussion]
### Empirical Findings
[Grouped discussion with comparison across studies]
### Methodological Innovations
[Methods relevant to the topic]
## Gaps and Opportunities
1. [Gap 1 — what's missing and why it matters]
2. [Gap 2]
3. [Gap 3]
## Suggested Next Steps
- [Concrete actions: papers to read, data to obtain, methods to consider]
## BibTeX Entries
```bibtex
@article{...}
---
## Important
- **Be honest about uncertainty.** If you cannot verify a citation, say so.
- **Prioritize recent work** (last 5-10 years) unless seminal papers are older.
- **Note working papers vs published papers** — working papers may change.
- **Do NOT fabricate citations.** If you're unsure about a paper's details, flag it for the user to verify.
1---
2name: lit-review-4
3description: Structured literature search and synthesis with citation extraction and gap identification
4argument-hint: "[topic, paper title, or research question]"
5allowed-tools: ["Read", "Grep", "Glob", "Write", "WebSearch", "WebFetch"]
6---
7
8# Literature Review
9
10Conduct a structured literature search and synthesis on the given topic.
11
12**Input:** `$ARGUMENTS` — a topic, paper title, research question, or phenomenon to investigate.
13
14---
15
16## Steps
17
181. **Parse the topic** from `$ARGUMENTS`. If a specific paper is named, use it as the anchor.
19
202. **Search for related work** using available tools:
21 - Check `master_supporting_docs/supporting_papers/` for uploaded papers
22 - Use `WebSearch` to find recent publications (if available)
23 - Use `WebFetch` to access working paper repositories (if available)
24 - Read any existing `.bib` file for papers already in the project
25
263. **Organize findings** into these categories:
27 - **Theoretical contributions** — models, frameworks, mechanisms
28 - **Empirical findings** — key results, effect sizes, data sources
29 - **Methodological innovations** — new estimators, identification strategies, inference methods
30 - **Open debates** — unresolved disagreements in the literature
31
324. **Identify gaps and opportunities:**
33 - What questions remain unanswered?
34 - What data or methods could address them?
35 - Where do findings conflict?
36
375. **Extract citations** in BibTeX format for all papers discussed.
38
396. **Save the report** to `quality_reports/lit_review_[sanitized_topic].md`
40
41---
42
43## Output Format
44
45```markdown
46# Literature Review: [Topic]
47
48**Date:** [YYYY-MM-DD]
49**Query:** [Original query from user]
50
51## Summary
52
53[2-3 paragraph overview of the state of the literature]
54
55## Key Papers
56
57### [Author (Year)] — [Short Title]
58- **Main contribution:** [1-2 sentences]
59- **Method:** [Identification strategy / data]
60- **Key finding:** [Result with effect size if available]
61- **Relevance:** [Why it matters for our research]
62
63[Repeat for 5-15 papers, ordered by relevance]
64
65## Thematic Organization
66
67### Theoretical Contributions
68[Grouped discussion]
69
70### Empirical Findings
71[Grouped discussion with comparison across studies]
72
73### Methodological Innovations
74[Methods relevant to the topic]
75
76## Gaps and Opportunities
77
781. [Gap 1 — what's missing and why it matters]
792. [Gap 2]
803. [Gap 3]
81
82## Suggested Next Steps
83
84- [Concrete actions: papers to read, data to obtain, methods to consider]
85
86## BibTeX Entries
87
88```bibtex
89@article{...}
90```
91```
92
93---
94
95## Important
96
97- **Be honest about uncertainty.** If you cannot verify a citation, say so.
98- **Prioritize recent work** (last 5-10 years) unless seminal papers are older.
99- **Note working papers vs published papers** — working papers may change.
100- **Do NOT fabricate citations.** If you're unsure about a paper's details, flag it for the user to verify.