Template Overview

Peer review is the foundation of scientific integrity. Reviewers must rigorously interrogate mathematical models, statistical validity, and empirical claims while providing constructive feedback to authors and clear recommendations to editors. The Peer-Reviewed Journal Review Record organizes manuscript evaluations, major revisions, minor queries, and editorial verdicts in plain Markdown.

Markdown Template Structure

Copy the block below or click Download .md File to add this template directly to your personal vault:

---
title: "Peer Review: [Manuscript Tracking ID] — [Journal Name]"
date: [YYYY-MM-DD]
reviewer: "[[Anonymous Reviewer / Your Name]]"
journal_title: "[IEEE Transactions / ACM Computing Surveys / Nature]"
manuscript_title: "[Full Submitted Manuscript Title]"
recommendation: "Accept / Minor Revision / Major Revision / Reject"
confidence_score: "5 (Expert) / 4 / 3 / 2 / 1"
tags: [peer-review, academic-journal, scholarship, methodology, referee-report]
---

# Peer-Reviewed Journal Review — [Manuscript Tracking ID]

## 1. Summary of Manuscript & Perceived Contribution
- **Manuscript Overview:** [Concise, neutral summary of the author's primary thesis, proposed technique, and experimental scope].
- **Core Scientific Contribution:** [What novel theoretical or empirical advance does this manuscript offer to the field?].
- **Reviewer Recommendation:** **[Major Revision / Minor Revision / Reject / Accept]**.

## 2. Evaluation Against Scholarly Criteria
| Evaluation Dimension | Assessment (1-5) | Justification & Detailed Comments |
|---|---|---|
| **Novelty & Originality** | 4 / 5 | Technique introduces an innovative sparse-attention kernel for mobile chips |
| **Methodological Soundness** | 3 / 5 | Sample size is adequate, but ablation study omits negative control group |
| **Statistical Validity** | 4 / 5 | p-values reported with proper Bonferroni correction; effect sizes clear |
| **Clarity of Exposition** | 3 / 5 | Mathematical notation in Section 2 is inconsistent with Figure 4 |
| **Reproducibility** | 2 / 5 | Code repository link is empty; hyperparameter seeds not disclosed |

## 3. Major Points Requiring Revision (Substantive Scientific Critiques)
### Major Point 1: Baseline Comparison Inadequacy
- **Comment:** In Section 4.2, the authors compare their model against 2021 baselines. To demonstrate true state-of-the-art capability, comparison against 2025 published benchmarks (e.g., Reference [14]) is required.

### Major Point 2: Code & Dataset Reproducibility
- **Comment:** The manuscript claims high reproducibility but omits the training seeds and model weight initialization protocols. The authors must provide an anonymized artifact repository link with reproduction scripts.

## 4. Minor Editorial & Typographical Remarks
- **Line 104:** Typo: *"proceded"* should be *"proceeded"*.
- **Line 218:** Equation (4) defines variable $\gamma$ but refers to it as $\lambda$ in the subsequent sentence.
- **Figure 3 Caption:** Please add units of measurement (megabytes) to the Y-axis label.

## 5. Confidential Remarks to the Journal Editor
> [!IMPORTANT] Confidential Editorial Advice
> The paper presents a genuinely valuable algorithmic optimization, but the authors must address the baseline omissions and reproducibility concerns before acceptance can be justified. Recommend **Major Revision**.

## 6. Action Items
- [ ] Proofread referee report for professional, constructive tone.
- [ ] Submit report via journal editorial management portal.

Filled Real-World Example

Here is a realistic example demonstrating how this template captures actual deliberations:

---
title: "Review: MANUSCRIPT-2026-4412"
date: 2026-10-07
reviewer: "[[Dr. Katherine Chen]]"
journal_title: "IEEE Transactions on Audio Processing"
manuscript_title: "Low-Power Acoustic Feature Extraction on Edge Hardware"
recommendation: "Minor Revision"
confidence_score: "5"
tags: [peer-review, ieee, audio]
---

# Peer-Reviewed Journal Review — MANUSCRIPT-2026-4412

## 1. Executive Summary
Dr. Katherine Chen reviewed manuscript 4412 evaluating ultra-low-power feature extraction on microcontroller architectures.

## 2. Verdict
The manuscript is thoroughly researched and empirically convincing. Authors requested to provide explicit memory consumption figures for the fixed-point FFT module prior to final acceptance.

When to Use and When to Avoid

When to Use

  • Use when serving as an invited referee or reviewer for peer-reviewed academic journals or conferences.
  • Use to draft, revise, and preserve formal referee reports before uploading to editorial portals.
  • Use to maintain an intellectual archive of manuscripts you have evaluated over your academic career.

When to Avoid

  • Avoid using for public blog reviews or casual book ratings on social media.
  • Avoid sharing confidential manuscript details outside of authorized editorial channels.

On-Device AI Integration

Summarize your recording in Oyma with this local instruction:

Analyze the manuscript text and reviewer notes:
1. Synthesize the core scientific contribution and evaluate methodology and reproducibility.
2. Group critiques into Major Points (substantive revisions) and Minor Points (editorial/formatting).
3. Generate a formal referee report with recommendation and confidential editorial remarks in Markdown.

Your data remains securely on your Mac with zero cloud exposure.

Frequently Asked Questions

What is a formal peer-reviewed journal review?

An expert evaluation of an unpublished academic manuscript submitted to a scholarly journal, advising the editor on whether to accept, revise, or reject the paper.

How does this template maintain peer review ethics?

It enforces constructive, objective academic critique, evaluating methodological rigor, ethical standards, and reproducible data without ad hominem commentary.

Are manuscript details kept confidential in Markdown?

Yes. Storing peer review drafts in local Markdown protects unpublished manuscripts from accidental disclosure to cloud services.