--- name: jedpsych-workflow description: Use when starting or navigating any Journal of Educational Psychology manuscript and you are unsure which sub-skill applies. Use when choosing among manuscript types (primary empirical study, multi-study package, exceptionally important meta-analysis) or returning with a decision letter. Routes by lifecycle stage and flags the journal's masked review, 12,000-word format, APA 7th style, and Transparency and Openness requirements. It dispatches; it does not draft content. --- # Journal of Educational Psychology Workflow Router (jedpsych-workflow) The orchestrator for a Journal of Educational Psychology (JEP) submission. JEP is the APA's flagship outlet for **original, primary psychological research on learning and instruction across all ages**. Its defining features are **masked review**, an **educational-relevance bar** (the result must matter for real learners in real settings), and a credibility regime built on **APA 7th**, **JARS reporting standards**, and a required **Transparency and Openness** subsection — the router makes sure each is handled from the start, then sends you to the matching skill. ## When to trigger - Starting a new JEP paper and unsure where to begin - Mid-project and unsure which skill applies next - Choosing among manuscript types (single study, multi-study, meta-analysis) - Returning with a decision letter (route to `jedpsych-rebuttal`) ## First question: manuscript type | Situation | Type | Route note | |-----------|------|-----------| | Completed experiment / field trial / longitudinal study | **Primary empirical article** | main pipeline below | | Several studies building one cumulative claim | **Multi-study article** | each study must add inference, not repeat | | Cluster-randomized / classroom intervention, not yet run | **Prospective field trial** | pull `jedpsych-study-design` + `jedpsych-review-process` forward; consider preregistration | | Exceptionally important synthesis | **Meta-analysis** | follow APA MARS; `jedpsych-data-analysis` (meta route) | | Reliability/validity of one test | **Usually out of scope** | JEP does not typically publish single-instrument validation | ## Routing map (stage → skill) ```text Fits JEP's learning/education scope? → jedpsych-topic-selection Theory + hypotheses stated up front? → jedpsych-theory-and-hypotheses Where does it sit in the field? → jedpsych-literature-positioning Design / nesting / power / measures? → jedpsych-study-design Multilevel/SEM sound + effect sizes? → jedpsych-data-analysis Exhibits (APA 7th, models, growth)? → jedpsych-tables-figures Fits 12,000 words, masked, APA? → jedpsych-writing-style Data/materials/code + TOP statement? → jedpsych-open-science-and-transparency How will it be judged? → jedpsych-review-process Ready to submit (Editorial Manager)? → jedpsych-submission Got an R&R / decision? → jedpsych-rebuttal ``` ## Default order `topic-selection → theory-and-hypotheses → literature-positioning → study-design → data-analysis → tables-figures → writing-style → open-science-and-transparency → review-process → submission → rebuttal` For a **prospective cluster-randomized trial**, pull `study-design` and `review-process` forward — power for nesting and a registration/analysis plan should be settled *before* schools are recruited. ## Worked micro-example — routing a live project (illustrative) A team has a cluster-randomized reading-comprehension intervention (48 classrooms, ~1,100 students), pretest covariate, and a reviewer worried about power and clustering. The router walks them: ``` Type: Primary empirical article (field trial, results in hand). Entry: not idea-stage → skip topic-selection; they are at design/analysis. Route: study-design (nesting, ICC, cluster-level power, baseline equivalence) → data-analysis (multilevel model, cluster-robust inference, effect size) → tables-figures (model table + growth/forest exhibit) → writing-style (fit 12,000 words, APA 7th, masked) → open-science-and-transparency (TOP subsection, deposit + IDs) → submission (Editorial Manager preflight) ; on R&R → rebuttal. Flag: power and the effect size must be at the CLUSTER level; a student-level power claim is the classic JEP design error. ``` ## Stage-triage table (symptom → skill) | What the author says | Stage | Route to | |----------------------|-------|----------| | "Is this educational enough for JEP?" | fit | `jedpsych-topic-selection` | | "My intro reads like a textbook chapter" | positioning | `jedpsych-literature-positioning` | | "Reviewer says I ignored clustering" | design/analysis | `jedpsych-study-design` + `jedpsych-data-analysis` | | "What goes in the Transparency statement?" | transparency | `jedpsych-open-science-and-transparency` | | "My paper is 14,500 words" | format | `jedpsych-writing-style` | | "I have an R&R" | revision | `jedpsych-rebuttal` | ## Routing pitfalls specific to this venue - Sending a classroom-intervention project straight to `jedpsych-data-analysis` before `jedpsych-study-design` has fixed the nesting and cluster-level power — at JEP the multilevel structure must be designed in, not patched in analysis. - Treating the result as interesting psychology with no argument for why it matters for **learning, teaching, or educational practice** — JEP's scope screen is educational relevance, not psychology alone. - Deferring `jedpsych-open-science-and-transparency` to the end; the Transparency and Openness subsection is built from live deposits and persistent identifiers, not promised at acceptance. ## Anti-patterns - Powering and reporting at the student level when randomization was at the classroom/school level - A finding with no clear implication for education (better fits a general psychology outlet) - Forgetting the Transparency and Openness subsection (data, materials, analysis code availability) - Submitting a single-instrument reliability/validity study (typically out of scope for JEP) ## Output format ``` 【Stage】fit / theory / positioning / design / analysis / exhibits / writing / transparency / review / submit / rebut 【Type】Primary empirical / Multi-study / Prospective trial / Meta-analysis 【Route to】jedpsych- 【Why】one line 【Then】the next skill after that ``` ## Supplementary resources - [`../../resources/external_tools.md`](../../resources/external_tools.md) — power for nested designs, multilevel/SEM software, preregistration, repositories - [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — official APA Journal of Educational Psychology URLs behind every fact in this pack