research_paper.md
306 lines · skills/markdown-mermaid-writing/templates/research_paper.md at 5f2bc03
<!-- Source: https://github.com/SuperiorByteWorks-LLC/agent-project | License: Apache-2.0 | Author: Clayton Young / Superior Byte Works, LLC (Boreal Bytes) -->
Research Paper / Technical Analysis Template
Back to Markdown Style Guide — Read the style guide first for formatting, citation, and emoji rules.
Use this template for: Research papers, technical analyses, literature reviews, data-driven reports, competitive analyses, market research, or any document built around evidence and methodology. Designed for heavy citation, structured argumentation, and reproducible findings.
Key features: Abstract for quick assessment, methodology section for credibility, findings with supporting data/diagrams, rigorous footnote citations throughout, and a complete references section.
Philosophy: A great research document lets the reader evaluate your conclusions independently. Show your work. Cite your sources. Present counter-arguments. The reader should trust your findings because the evidence is right there — not because you said so.
Raw lines 1 to 14
How to Use
- Copy this file to your project
- Replace all
[bracketed placeholders]with your content - Adjust sections — not every paper needs every section, but the core flow (Abstract → Introduction → Methodology → Findings → Conclusion) should stay intact
- Cite aggressively — every claim, every statistic, every external methodology reference gets a
[^N]footnote - Add Mermaid diagrams for any process, architecture, data flow, or comparison
Raw lines 15 to 24
Template Structure
1. Abstract — What you did, what you found, why it matters (150-300 words)
2. 📋 Introduction — Problem statement, context, scope, research questions
3. 📚 Background — Prior work, literature review, industry context
4. 🔬 Methodology — How you did the research, data sources, approach
5. 📊 Findings — What you discovered, with evidence and diagrams
6. 💡 Analysis — What the findings mean, implications, limitations
7. 🎯 Conclusions — Summary, recommendations, future work
8. 🔗 References — All cited sources with full URLsRaw lines 25 to 39
The Template
Everything below the line is the template. Copy from here; commands, API routes, versions, thresholds, and numerical values are illustrative placeholders. Verify them against the actual project before publishing. Follow its existing tracker and PR conventions.
[Paper Title: Descriptive and Specific]
[Author(s) or Team] · [Organization] · [Date]
Raw lines 40 to 53
Abstract
[150–300 word summary structured as: Context (1–2 sentences on the problem space), Objective (what this paper investigates), Method (how the research was conducted), Key findings (the most important results), Significance (why this matters and who should care).]
Keywords: [keyword 1], [keyword 2], [keyword 3], [keyword 4], [keyword 5]
Raw lines 54 to 61
📋 Introduction
Raw lines 62 to 63Problem statement
[What problem exists? Why does it matter? Who is affected? Be specific — include metrics where available.]
[The scope of the problem, with citation][^1].
Raw lines 64 to 69Research questions
This paper investigates:
- [RQ1] — [Specific, answerable question]
- [RQ2] — [Specific, answerable question]
- [RQ3] — [Specific, answerable question]
Scope and boundaries
- In scope: [What this paper covers]
- Out of scope: [What this paper deliberately excludes and why]
- Target audience: [Who will benefit from these findings]
<details> <summary><strong>💬 Context Notes</strong></summary>
- Why this research was initiated
- Organizational context or business driver
- Relationship to prior internal work
- Known constraints that shaped the scope
</details>
Raw lines 78 to 95
📚 Background
Raw lines 96 to 97Industry context
[Current state of the field. What's known. What the established approaches are. Cite existing work.]
[Key finding from prior research][^2]. [Another relevant study found][^3].
Raw lines 98 to 103Prior work
| Study / Source | Key Finding | Relevance to Our Work |
|---|---|---|
| [Author (Year)][^4] | [What they found] | [How it connects] |
| [Author (Year)][^5] | [What they found] | [How it connects] |
| [Author (Year)][^6] | [What they found] | [How it connects] |
Gap in current knowledge
[What's missing from existing research? What question remains unanswered? This is the gap your paper fills.]
<details> <summary><strong>📋 Extended Literature Review</strong></summary>
[Deeper discussion of related work, historical context, evolution of approaches, and detailed comparison of methodologies used by prior researchers. This depth supports the paper's credibility without cluttering the main flow.]
</details>
Raw lines 112 to 124
🔬 Methodology
Raw lines 125 to 126Approach
[Describe your research methodology — qualitative, quantitative, mixed methods, experimental, observational, case study, etc.]
flowchart LR
accTitle: Research Methodology Flow
accDescr: Four-phase research process from data collection through analysis to validation and reporting
collect[📥 Data collection] --> clean[⚙️ Data cleaning]
clean --> analyze[🔍 Analysis]
analyze --> validate[🧪 Validation]
validate --> report[📤 Report findings]
classDef process fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#1e3a5f
class collect,clean,analyze,validate,report processRaw lines 127 to 144Data sources
| Source | Type | Size / Scope | Collection Period |
|---|---|---|---|
| [Source 1] | [Survey / API / Database / etc.] | [N records / respondents] | [Date range] |
| [Source 2] | [Type] | [Size] | [Date range] |
Tools and technologies
- [Tool 1] — [Purpose and version]
- [Tool 2] — [Purpose and version]
- [Analysis framework] — [Why this was chosen]
Limitations of methodology
⚠️ Known limitations: [Be upfront about what could affect the validity of your results — sample size, selection bias, time constraints, data quality issues. This builds credibility, not weakness.]
<details> <summary><strong>🔧 Detailed Methodology</strong></summary>
Raw lines 158 to 164Cleaning and preprocessing
[What transformations were applied, what was excluded and why]
Raw lines 169 to 172Reproducibility
[How someone else could replicate this research — data availability, code repositories, environment setup]
</details>
Raw lines 177 to 184
📊 Findings
Raw lines 185 to 186Finding 1: [Descriptive title]
[Present the finding clearly. Lead with the conclusion, then show the evidence.]
[Data supporting this finding][^7]:
| Metric | Before | After | Change |
|---|---|---|---|
| [Metric 1] | [Value] | [Value] | [+/- %] |
| [Metric 2] | [Value] | [Value] | [+/- %] |
📌 Key insight: [One-sentence takeaway from this finding]Raw lines 187 to 199
Finding 2: [Descriptive title]
[Present the finding. Include a diagram if the finding involves relationships, processes, or comparisons.]
xychart-beta
title "[Chart title]"
x-axis ["Category A", "Category B", "Category C", "Category D"]
y-axis "Measurement" 0 --> 100
bar [45, 72, 63, 89][Explanation of what the data shows and why it matters.]
Raw lines 200 to 213Finding 3: [Descriptive title]
[Present the finding with supporting evidence.]
<details> <summary><strong>📊 Supporting Data Tables</strong></summary>
[Detailed data tables, raw numbers, statistical breakdowns that support the findings but would interrupt the reading flow if placed inline. Readers who want to verify can expand.]
</details>
Raw lines 214 to 226
💡 Analysis
Raw lines 227 to 228Interpretation
[What do the findings mean? Connect back to your research questions. Explain the "so what?"]
- RQ1: [How Finding 1 answers Research Question 1]
- RQ2: [How Finding 2 answers Research Question 2]
- RQ3: [How Finding 3 answers Research Question 3]
Implications
For [audience 1]:
- [What this means for them and what action they should consider]
For [audience 2]:
- [What this means for them and what action they should consider]
Comparison with prior work
[How do your findings compare with the studies referenced in the Background section? Do they confirm, contradict, or extend prior work?]
Raw lines 247 to 250Limitations
[What caveats should the reader keep in mind? What factors might affect generalizability? Be honest — this is where credibility is built.]
<details> <summary><strong>💬 Discussion Notes</strong></summary>
- Alternative interpretations of the data
- Edge cases or outliers observed
- Areas where more data would strengthen conclusions
- Potential confounding variables
</details>
Raw lines 251 to 266
🎯 Conclusions
Raw lines 267 to 268Summary
[3–5 sentences. Restate the problem, summarize the key findings, and state the primary recommendation. A reader who skips to this section should understand the entire paper's value.]
Raw lines 269 to 272Recommendations
- [Recommendation 1] — [Specific, actionable. What to do, who should do it, expected impact]
- [Recommendation 2] — [Specific, actionable]
- [Recommendation 3] — [Specific, actionable]
Future work
- [Research direction 1] — [What it would investigate and why it matters]
- [Research direction 2] — [What it would investigate and why it matters]
Raw lines 279 to 285
🔗 References
All sources cited in this paper:
[^1]: [Author/Org]. ([Year]). "[Title]." [Publication]. <https://example.com>
[^2]: [Author/Org]. ([Year]). "[Title]." [Publication]. <https://example.com>
[^3]: [Author/Org]. ([Year]). "[Title]." [Publication]. <https://example.com>
[^4]: [Author/Org]. ([Year]). "[Title]." [Publication]. <https://example.com>
[^5]: [Author/Org]. ([Year]). "[Title]." [Publication]. <https://example.com>
[^6]: [Author/Org]. ([Year]). "[Title]." [Publication]. <https://example.com>
[^7]: [Author/Org]. ([Year]). "[Title]." [Publication]. <https://example.com>
Last updated: [Date]
Raw lines 286 to 306