Study Design (psci-study-design)
Psychological Science expects studies that are adequately powered, transparently planned, and
robust to researcher degrees of freedom. Authors must justify sample size (a formal power
analysis where appropriate). This skill hardens the design before data collection.
When to trigger
- Planning a study or a multi-study package
- Writing a preregistration / pre-analysis plan or a Registered Report Stage 1
- A reviewer questioned power, design, confounds, or analytic flexibility
- Justifying sample size and stopping rules
Design standards
- Sample-size justification. Provide an explicit basis for N — a power analysis for the
smallest effect of interest, a precision/AIPE rationale, or (for sequential/Bayesian designs) the
decision rule. State the assumed effect size and where it came from.
- Preregister the confirmatory core. Specify hypotheses, design, conditions, measures, exclusion
rules, and the analysis plan in advance (OSF/AsPredicted, or a Registered Report Stage 1). This is
what converts a claim from exploratory to confirmatory.
- Control researcher degrees of freedom. Decide in advance: conditions, the full set of measures,
exclusion criteria, covariates, and how stopping is determined. Undisclosed flexibility inflates
false positives.
- Confounds and validity. Address random assignment, manipulation/attention checks, order
effects, demand characteristics; argue construct and external validity for the population claimed.
- Multi-study logic. If using several studies, say what each adds (generalization, mechanism,
boundary condition) — not just repetition.
Registered Reports (strongest design path)
- Stage 1 reviews the theory + design + analysis plan before data; in-principle acceptance commits
the journal regardless of outcome if you execute the plan. Ideal for confirmatory and replication
work, and it neutralizes publication bias. For prior-collected data, use RR with Existing Data
and declare provenance.
Sample-size justification — worked example (illustrative)
For the two-study attention package, justify N before collecting, tied to the smallest effect of
interest (SESOI), not a round number per cell.
Smallest effect of interest: d = 0.30 (below this, the premise is not
practically load-bearing for downstream clinical models).
Study 1 (between-subjects, two groups):
target 80% power, two-sided alpha .05 → N ≈ 278; we collect 240
and report honestly that we have ~80% power for d = 0.36, i.e.
the design is calibrated to a slightly larger effect — stated, not hidden.
Study 2 (direct replication + moderation):
increase to N = 300 for the interaction term; precision goal is a
half-width ≤ 0.25 on the replication d.
Stopping rule: fixed-N; no optional stopping. (For sequential designs, state
the decision boundary and alpha-spending in advance.)
State the assumed effect size and its source (prior meta-analytic estimate, a pilot, or a SESOI
argument). A power analysis anchored to an inflated published effect is a known failure mode here.
Pre-data lockdown checklist
| Degree of freedom |
Lock before data? |
Where it lives |
| Hypotheses + direction |
yes |
preregistration / RR Stage 1 |
| Exact conditions and Ns |
yes |
preregistration |
| Full measure list (all DVs) |
yes |
preregistration (prevents cherry-picking) |
| Exclusion rules (attention, RT, dropout) |
yes |
preregistration, with expected attrition |
| Covariates / model form |
yes |
analysis plan |
| Stopping rule |
yes |
analysis plan |
| Exploratory analyses |
allowed, but labeled |
reported separately, post hoc |
Design-stage reviewer pushback and the venue fix
- "50 per cell, no justification" → replace with a SESOI-anchored power or precision argument.
- "Manipulation may not have worked" → preregister and report a manipulation/attention check; if it
fails, the confound objection lands hard at this venue.
- "Looks like flexible exclusions" → preregister exclusion rules and report the estimate with and
without them (handoff to
psci-data-analysis).
- "Three near-identical studies" → make each study add inference (generalization, mechanism, boundary).
Execution bridge (StatsPAI / Stata MCP)
Estimate and audit the design, don't only describe it. Full map:
execution-with-mcp. Psychological Science is short-format experimental psychology with strong open-science norms; preregister, run randomization inference, and report effect sizes with family-wise corrections.
detect_design → recommend → fit with as_handle=true → audit_result.
- Observational causal claims: staggered DiD (
callaway_santanna / sun_abraham +
bacon_decomposition + honest_did_from_result); IV (effective_f_test +
anderson_rubin_ci); RDD (rdrobust + mccrary_test).
- Experiments: randomization-based inference,
romano_wolf for many-outcome
family-wise control, and mediate for mediation (not naive controlling-away).
- Sensitivity:
oster_delta / sensemakr for observational claims.
Report the effect size in interpretable units; route the full battery to the
appendix/supplement. A run end-to-end (synthetic data, real returns) is in the
JF execution walkthrough.
Anti-patterns
- "We collected 50 per cell" with no power/precision justification
- Optional stopping or undisclosed exclusion rules
- Flexible measure/condition selection revealed only after results
- Underpowered single studies chasing a surprising effect
- A multi-study paper where studies are near-duplicates with no added inference
Output format
【Sample size】N + justification (power for smallest effect of interest / precision / decision rule)
【Preregistration】confirmatory core preregistered? where?
【Degrees of freedom】conditions, measures, exclusions, covariates fixed in advance? [Y/N]
【Validity】confounds / checks / population addressed
【Design path】Research Article vs Registered Report (S1)
【Next】psci-data-analysis
Supplementary resources
Source: brycewang-stanford/Awesome-Journal-Skills → Psychological-Science-Skills/skills/psci-study-design/SKILL.md
1---2name: psci-study-design3description: Use when designing studies for a Psychological Science manuscript so they meet the journal's standards for power, sample-size justification, preregistration, and confound control. Strengthens the design and pre-analysis plan; it does not write code.4---567# Study Design (psci-study-design)89Psychological Science expects studies that are **adequately powered**, **transparently planned**, and10**robust to researcher degrees of freedom**. Authors must **justify sample size** (a formal power11analysis where appropriate). This skill hardens the design before data collection.1213## When to trigger1415- Planning a study or a multi-study package16- Writing a preregistration / pre-analysis plan or a Registered Report Stage 117- A reviewer questioned power, design, confounds, or analytic flexibility18- Justifying sample size and stopping rules1920## Design standards21221. **Sample-size justification.** Provide an explicit basis for N — a **power analysis** for the23 smallest effect of interest, a precision/AIPE rationale, or (for sequential/Bayesian designs) the24 decision rule. State the assumed effect size and where it came from.252. **Preregister the confirmatory core.** Specify hypotheses, design, conditions, measures, exclusion26 rules, and the analysis plan in advance (OSF/AsPredicted, or a Registered Report Stage 1). This is27 what converts a claim from exploratory to confirmatory.283. **Control researcher degrees of freedom.** Decide in advance: conditions, the full set of measures,29 exclusion criteria, covariates, and how stopping is determined. Undisclosed flexibility inflates30 false positives.314. **Confounds and validity.** Address random assignment, manipulation/attention checks, order32 effects, demand characteristics; argue construct and external validity for the population claimed.335. **Multi-study logic.** If using several studies, say what each adds (generalization, mechanism,34 boundary condition) — not just repetition.3536## Registered Reports (strongest design path)3738- Stage 1 reviews the **theory + design + analysis plan before data**; in-principle acceptance commits39 the journal regardless of outcome if you execute the plan. Ideal for confirmatory and replication40 work, and it neutralizes publication bias. For prior-collected data, use **RR with Existing Data**41 and declare provenance.4243## Sample-size justification — worked example (illustrative)4445For the two-study attention package, justify N *before* collecting, tied to the smallest effect of46interest (SESOI), not a round number per cell.4748```49Smallest effect of interest: d = 0.30 (below this, the premise is not50 practically load-bearing for downstream clinical models).51Study 1 (between-subjects, two groups):52 target 80% power, two-sided alpha .05 → N ≈ 278; we collect 24053 and report honestly that we have ~80% power for d = 0.36, i.e.54 the design is calibrated to a slightly larger effect — stated, not hidden.55Study 2 (direct replication + moderation):56 increase to N = 300 for the interaction term; precision goal is a57 half-width ≤ 0.25 on the replication d.58Stopping rule: fixed-N; no optional stopping. (For sequential designs, state59 the decision boundary and alpha-spending in advance.)60```6162State the assumed effect size *and its source* (prior meta-analytic estimate, a pilot, or a SESOI63argument). A power analysis anchored to an inflated published effect is a known failure mode here.6465## Pre-data lockdown checklist6667| Degree of freedom | Lock before data? | Where it lives |68|-------------------|-------------------|----------------|69| Hypotheses + direction | yes | preregistration / RR Stage 1 |70| Exact conditions and Ns | yes | preregistration |71| Full measure list (all DVs) | yes | preregistration (prevents cherry-picking) |72| Exclusion rules (attention, RT, dropout) | yes | preregistration, with expected attrition |73| Covariates / model form | yes | analysis plan |74| Stopping rule | yes | analysis plan |75| Exploratory analyses | allowed, but labeled | reported separately, post hoc |7677## Design-stage reviewer pushback and the venue fix7879- "50 per cell, no justification" → replace with a SESOI-anchored power or precision argument.80- "Manipulation may not have worked" → preregister and report a manipulation/attention check; if it81 fails, the confound objection lands hard at this venue.82- "Looks like flexible exclusions" → preregister exclusion rules and report the estimate with and83 without them (handoff to `psci-data-analysis`).84- "Three near-identical studies" → make each study add inference (generalization, mechanism, boundary).8586## Execution bridge (StatsPAI / Stata MCP)8788Estimate and audit the design, don't only describe it. Full map:89[`execution-with-mcp`](../../../shared-resources/empirical-methods/execution-with-mcp.md). Psychological Science is short-format experimental psychology with strong open-science norms; preregister, run randomization inference, and report effect sizes with family-wise corrections.9091- `detect_design` → `recommend` → fit with `as_handle=true` → `audit_result`.92- **Observational causal claims:** staggered DiD (`callaway_santanna` / `sun_abraham` +93 `bacon_decomposition` + `honest_did_from_result`); IV (`effective_f_test` +94 `anderson_rubin_ci`); RDD (`rdrobust` + `mccrary_test`).95- **Experiments:** randomization-based inference, `romano_wolf` for many-outcome96 family-wise control, and `mediate` for mediation (not naive controlling-away).97- **Sensitivity:** `oster_delta` / `sensemakr` for observational claims.9899Report the effect size in interpretable units; route the full battery to the100appendix/supplement. A run end-to-end (synthetic data, real returns) is in the101[JF execution walkthrough](../../../Journal-of-Finance-Skills/resources/worked-examples/02-execution-walkthrough.md).102## Anti-patterns103104- "We collected 50 per cell" with no power/precision justification105- Optional stopping or undisclosed exclusion rules106- Flexible measure/condition selection revealed only after results107- Underpowered single studies chasing a surprising effect108- A multi-study paper where studies are near-duplicates with no added inference109110## Output format111112```113【Sample size】N + justification (power for smallest effect of interest / precision / decision rule)114【Preregistration】confirmatory core preregistered? where?115【Degrees of freedom】conditions, measures, exclusions, covariates fixed in advance? [Y/N]116【Validity】confounds / checks / population addressed117【Design path】Research Article vs Registered Report (S1)118【Next】psci-data-analysis119```120121## Supplementary resources122123- [`../../resources/external_tools.md`](../../resources/external_tools.md) — G*Power, `simr`, `Superpower`, preregistration templates124- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — sample-size-justification and preregistration policy125126---127128**Source:** [`brycewang-stanford/Awesome-Journal-Skills`](https://github.com/brycewang-stanford/Awesome-Journal-Skills) → `Psychological-Science-Skills/skills/psci-study-design/SKILL.md`