Write Background Section
Draft or update the background/introduction section based on literature in .research/literature/
When to Use
- •After completing
/deep_researchon core concepts - •When literature files exist but background.md is empty
- •To update background after additional literature review
Prerequisites
- •At least one literature summary in
.research/literature/ - •Project aims defined in
.research/project_telos.md
Execution Steps
1. Gather Context
Read these files:
- •
.research/project_telos.md- Project aims and mission - •
.research/literature/*.md- All literature summaries - •
.research/literature/*.bib- All citations - •
manuscript/background.md- Existing draft (if any)
2. Identify Structure
A well-structured background follows the funnel model:
code
┌─────────────────────────────────────────┐ │ BROAD: Field context and │ ← Why does this field matter? │ importance │ ├─────────────────────────────────────────┤ │ NARROWER: Current approaches and │ ← What's been done? │ what's known │ ├─────────────────────────────────────────┤ │ SPECIFIC: Gaps, limitations, │ ← What's missing? │ open questions │ ├─────────────────────────────────────────┤ │ YOUR STUDY: How you address the gap │ ← What are you doing? └─────────────────────────────────────────┘
3. Background Section Template
markdown
# Background ## [Field Context - 1-2 paragraphs] <!-- Start broad: Why does this area matter? What's the big picture? --> <!-- Include 2-4 citations to establish context --> [Field] is critical for [reason]. Recent advances in [area] have enabled [capabilities] (Citation1, Year; Citation2, Year). However, significant challenges remain in [challenge area]. ## [Current Approaches - 2-3 paragraphs] <!-- What methods/approaches exist? What have others done? --> <!-- Synthesize literature thematically, don't just list papers --> Current approaches to [problem] fall into [N] categories. First, [approach 1] has been widely used because [reason] (Citations). However, this approach [limitation]. Second, [approach 2] addresses [specific aspect] by [method] (Citations). While effective for [use case], this method [limitation or gap]. ## [Gaps and Limitations - 1-2 paragraphs] <!-- What's missing? What hasn't been adequately addressed? --> <!-- This sets up your research question --> Despite these advances, [gap 1] remains poorly understood. Additionally, [gap 2] has received limited attention, particularly in the context of [specific application]. ## [Your Contribution - 1 paragraph] <!-- How does your work address these gaps? --> <!-- State aims clearly without overpromising --> In this study, we address [gap] by [approach]. Specifically, we [aim 1], [aim 2], and [aim 3]. Our approach differs from prior work by [key distinction].
Types of Gaps
Identify which type of gap your study addresses:
- •Knowledge gap: "It is unknown whether..."
- •Methodological gap: "Previous studies have not used..."
- •Population gap: "No studies have examined this in..."
- •Theoretical gap: "No framework exists to explain..."
- •Practical gap: "Current approaches fail to address..."
Gap Statement Templates
markdown
- "Despite [what's known], [what's unknown]." - "While previous work has [X], no studies have [Y]." - "The relationship between [A] and [B] remains unclear." - "Limited evidence exists regarding..." - "A critical gap in our understanding is..."
4. Writing Guidelines
DO:
- •Synthesize across sources (don't just summarize individual papers)
- •Use present tense for established knowledge ("X is known to...")
- •Use past tense for specific study findings ("Smith et al. found...")
- •Connect ideas with transitions
- •Build toward your research question logically
- •Include 20-40 citations for a typical paper background
DON'T:
- •List papers without connecting them ("Paper A did X. Paper B did Y.")
- •Include citations without explanation
- •Fabricate citations not in your .bib files
- •Make claims without support
- •Use jargon without defining it
- •Front-load with history that doesn't connect to your work
5. Citation Density Guidelines
| Section | Citation Density |
|---|---|
| Field context | High (establish foundation) |
| Current approaches | Very high (show you know the field) |
| Gaps and limitations | Medium (may include your reasoning) |
| Your contribution | Low to none (this is you, not literature) |
6. Generate Draft
Create or update manuscript/background.md:
markdown
# Background <!-- Draft generated by Research Assistant on [DATE] Based on literature in: .research/literature/ Related aims: [list aims from project_telos.md] ⚠️ REVIEW CAREFULLY: - Verify all citations against your .bib files - Add context specific to your project - Adjust for target journal style --> [Generated content following template above] --- ## References Used [List of .bib files consulted] ## Potential Gaps to Address [Any areas where more literature may be needed]
7. Post-Draft Checks
Present these checks to the user:
code
Background draft created. Please review: ✓ Citations verified against .research/literature/*.bib ? Check: Does the funnel flow logically to your aims? ? Check: Are there areas needing additional literature? ? Check: Does this match your target journal's style? Suggested next steps: A) Review and edit manuscript/background.md B) Run /deep_research on [suggested missing topic] C) Proceed to /write_methods if pipeline is ready
Common Introduction Mistakes
- •
Too broad opening
- •❌ "Since the beginning of time, humans have wondered about..."
- •✅ "[Specific topic] affects [specific population/process]..."
- •
Literature review too detailed
- •Introduction ≠ full literature review
- •Include only what's needed to establish the gap
- •
Gap not clearly stated
- •Make it explicit, not implied
- •Should appear before study aims
- •
Objectives mismatch methods
- •Every stated objective must be addressed in Methods/Results
- •
Excessive length
- •Typical length: 500-1000 words (3-5 paragraphs)
- •Follow journal guidelines
Related Skills
- •
deep-research- If more literature is needed - •
write-methods- Next manuscript section - •
next- Get suggestions for next steps