Skill Tracer
Skills › Scientific Agent Skills › hypothesis-generation › preregistration_and_open_science.md

preregistration_and_open_science.md

210 lines · skills/hypothesis-generation/references/preregistration_and_open_science.md at 5f2bc03

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1# Preregistration, Registered Reports, and Open Science
2

Preregistration, Registered Reports, and Open Science

Raw lines 1 to 2
3## Purpose
4
5Preregistration records a time-stamped plan before the relevant data are collected or analyzed. Its main value is making planned and data-dependent work distinguishable.
6
7Preregistration does not:
8
9- guarantee a valid design or analysis;
10- prevent all researcher degrees of freedom;
11- make a hypothesis true;
12- forbid exploration or justified adaptation;
13- replace ethics, safety, data, or regulatory review;
14- require public release of restricted information.

Purpose

Preregistration records a time-stamped plan before the relevant data are collected or analyzed. Its main value is making planned and data-dependent work distinguishable.

Preregistration does not:

  • guarantee a valid design or analysis;
  • prevent all researcher degrees of freedom;
  • make a hypothesis true;
  • forbid exploration or justified adaptation;
  • replace ethics, safety, data, or regulatory review;
  • require public release of restricted information.
Raw lines 3 to 15
16## What to preregister

What to preregister

Raw lines 16 to 17
18### Administrative
20- title and project ID;
21- accountable owner and roles;
22- registration date and repository;
23- study status and prior access to relevant data;
24- conflicts, funding, and sponsor roles.

Administrative

  • title and project ID;
  • accountable owner and roles;
  • registration date and repository;
  • study status and prior access to relevant data;
  • conflicts, funding, and sponsor roles.
Raw lines 18 to 25
26### Question and candidates
28- observation and provenance;
29- research question and claim type;
30- candidate hypotheses and mechanisms;
31- rivals and alternative explanations;
32- causal estimands where applicable;
33- boundary conditions and uncertainty.

Question and candidates

  • observation and provenance;
  • research question and claim type;
  • candidate hypotheses and mechanisms;
  • rivals and alternative explanations;
  • causal estimands where applicable;
  • boundary conditions and uncertainty.
Raw lines 26 to 34
35### Predictions and controls
37- prediction IDs and parent candidates;
38- conditions, measurements, expected patterns, and timing;
39- falsifiers and indeterminate outcomes;
40- discriminating expectations for rivals;
41- null hypotheses;
42- positive, procedural, and negative controls.

Predictions and controls

  • prediction IDs and parent candidates;
  • conditions, measurements, expected patterns, and timing;
  • falsifiers and indeterminate outcomes;
  • discriminating expectations for rivals;
  • null hypotheses;
  • positive, procedural, and negative controls.
Raw lines 35 to 43
44### Design
46- population/system and sampling;
47- experimental and analysis units;
48- allocation, randomization, concealment, and masking;
49- interventions/exposures and comparators;
50- inclusion, exclusion, attrition, and stopping;
51- sample-size or precision rationale;
52- outcomes and measurement timing;
53- ethics, safety, data, and regulatory status.

Design

  • population/system and sampling;
  • experimental and analysis units;
  • allocation, randomization, concealment, and masking;
  • interventions/exposures and comparators;
  • inclusion, exclusion, attrition, and stopping;
  • sample-size or precision rationale;
  • outcomes and measurement timing;
  • ethics, safety, data, and regulatory status.
Raw lines 44 to 54
55### Analysis
57- analysis populations;
58- transformations and data exclusions;
59- models, contrasts, estimators, and effect/summary measures;
60- uncertainty intervals or other inferential summaries;
61- missing-data and intercurrent-event handling;
62- multiplicity;
63- assumptions and diagnostics;
64- sensitivity and robustness analyses;
65- rules for interpreting support, challenge, and indeterminacy.

Analysis

  • analysis populations;
  • transformations and data exclusions;
  • models, contrasts, estimators, and effect/summary measures;
  • uncertainty intervals or other inferential summaries;
  • missing-data and intercurrent-event handling;
  • multiplicity;
  • assumptions and diagnostics;
  • sensitivity and robustness analyses;
  • rules for interpreting support, challenge, and indeterminacy.
Raw lines 55 to 66
67### Transparency
69- data, code, materials, and metadata plans;
70- restrictions and controlled-access process;
71- software/environment versions;
72- AI/tool use;
73- deviation log and reporting plan.

Transparency

  • data, code, materials, and metadata plans;
  • restrictions and controlled-access process;
  • software/environment versions;
  • AI/tool use;
  • deviation log and reporting plan.
Raw lines 67 to 74
75## Timing and prior access
77State what had already occurred:
79- no data collected;
80- data collected but target outcomes unseen;
81- data available but analyst blinded;
82- summary statistics viewed;
83- exploratory analysis already performed;
84- existing dataset reused.
86When data have already informed the plan, label the work transparently and use independent data, a held-out set, or a new replication for confirmatory testing where feasible.

Timing and prior access

State what had already occurred:

  • no data collected;
  • data collected but target outcomes unseen;
  • data available but analyst blinded;
  • summary statistics viewed;
  • exploratory analysis already performed;
  • existing dataset reused.

When data have already informed the plan, label the work transparently and use independent data, a held-out set, or a new replication for confirmatory testing where feasible.

Raw lines 75 to 87
88## Confirmatory versus exploratory

Confirmatory versus exploratory

Raw lines 88 to 89
90### Confirmatory
92- planned before checking the target result;
93- tied to specified outcomes and analyses;
94- reported whether favorable, unfavorable, or null.

Confirmatory

  • planned before checking the target result;
  • tied to specified outcomes and analyses;
  • reported whether favorable, unfavorable, or null.
Raw lines 90 to 95
96### Exploratory
98- generated after or while viewing data;
99- useful for discovery;
100- labeled as data-dependent;
101- treated as a source of future predictions.
103Do not call exploratory work “post hoc confirmation.”

Exploratory

  • generated after or while viewing data;
  • useful for discovery;
  • labeled as data-dependent;
  • treated as a source of future predictions.

Do not call exploratory work “post hoc confirmation.”

Raw lines 96 to 104
105## HARKing
107Kerr defined HARKing as presenting a post hoc hypothesis as if it were a priori. Prevent it by:
109- preserving dated versions;
110- separating planned and unplanned analyses;
111- reporting all prespecified outcomes and tests;
112- documenting when each candidate was generated;
113- not rewriting unexpected results as predictions;
114- seeking independent replication.

HARKing

Kerr defined HARKing as presenting a post hoc hypothesis as if it were a priori. Prevent it by:

  • preserving dated versions;
  • separating planned and unplanned analyses;
  • reporting all prespecified outcomes and tests;
  • documenting when each candidate was generated;
  • not rewriting unexpected results as predictions;
  • seeking independent replication.
Raw lines 105 to 115
116## Deviations
118Preregistration is a plan, not a prison. For every material deviation record:
120- date;
121- affected section and IDs;
122- original plan;
123- change;
124- reason;
125- who made the decision;
126- whether the target result was known;
127- likely effect on bias or interpretation;
128- whether the original analysis is still reported.
130Do not silently replace the registration. Preserve the original and append amendments.
132On OSF, use the documented registration-update workflow when available and retain its change justification. Distinguish an updated registration from an editable project and inspect the version history; a later update does not make a data-informed prediction prospective. Consult the [current OSF registration guide](https://help.osf.io/article/330-welcome-to-registrations) for the selected registry's options.

Deviations

Preregistration is a plan, not a prison. For every material deviation record:

  • date;
  • affected section and IDs;
  • original plan;
  • change;
  • reason;
  • who made the decision;
  • whether the target result was known;
  • likely effect on bias or interpretation;
  • whether the original analysis is still reported.

Do not silently replace the registration. Preserve the original and append amendments.

On OSF, use the documented registration-update workflow when available and retain its change justification. Distinguish an updated registration from an editable project and inspect the version history; a later update does not make a data-informed prediction prospective. Consult the current OSF registration guide for the selected registry's options.

Raw lines 116 to 133
134## Registered Reports
136Registered Reports add journal peer review before results are known:
1381. Stage 1 protocol submission;
1392. review of question, methods, and analysis;
1403. in-principle acceptance under the journal’s conditions;
1414. study conduct;
1425. Stage 2 review focused on adherence, justified deviations, and interpretation.
144Check the current journal policy. In-principle acceptance is not ethics approval, funding, regulatory authorization, or assurance of a favorable result.

Registered Reports

Registered Reports add journal peer review before results are known:

  1. Stage 1 protocol submission;
  2. review of question, methods, and analysis;
  3. in-principle acceptance under the journal’s conditions;
  4. study conduct;
  5. Stage 2 review focused on adherence, justified deviations, and interpretation.

Check the current journal policy. In-principle acceptance is not ethics approval, funding, regulatory authorization, or assurance of a favorable result.

Raw lines 134 to 145
146## Intervention trials
148For randomized intervention hypotheses:
150- use current registration requirements for the applicable jurisdiction, funder, and venue;
151- use SPIRIT 2025 for protocol reporting;
152- align objectives, estimands, outcomes, harms, intervention details, statistical methods, and data sharing;
153- use CONSORT 2025 for completed-trial reporting;
154- report important changes, including non-prespecified outcomes or analyses.
156The preregistration scaffold in this skill is generic and is not a trial-registry submission, SPIRIT checklist, protocol, statistical analysis plan, or regulatory document.

Intervention trials

For randomized intervention hypotheses:

  • use current registration requirements for the applicable jurisdiction, funder, and venue;
  • use SPIRIT 2025 for protocol reporting;
  • align objectives, estimands, outcomes, harms, intervention details, statistical methods, and data sharing;
  • use CONSORT 2025 for completed-trial reporting;
  • report important changes, including non-prespecified outcomes or analyses.

The preregistration scaffold in this skill is generic and is not a trial-registry submission, SPIRIT checklist, protocol, statistical analysis plan, or regulatory document.

Raw lines 146 to 157
158## Reproducibility and replicability
160Use the National Academies definitions:
162- **reproducibility:** obtaining consistent computational results with the same data, code, methods, and analysis conditions;
163- **replicability:** obtaining consistent results in a new study addressing the same question with new data.
165Plan for:
167- stable identifiers and version control;
168- code and environment capture;
169- provenance and decision logs;
170- independent replication;
171- exact and conceptual replication;
172- boundary-condition and transport tests;
173- publication of null and challenging results.
175Non-replication does not automatically imply misconduct or that the original study was invalid. Differences can reveal heterogeneity, measurement limitations, context, or sampling variation.

Reproducibility and replicability

Use the National Academies definitions:

  • reproducibility: obtaining consistent computational results with the same data, code, methods, and analysis conditions;
  • replicability: obtaining consistent results in a new study addressing the same question with new data.

Plan for:

  • stable identifiers and version control;
  • code and environment capture;
  • provenance and decision logs;
  • independent replication;
  • exact and conceptual replication;
  • boundary-condition and transport tests;
  • publication of null and challenging results.

Non-replication does not automatically imply misconduct or that the original study was invalid. Differences can reveal heterogeneity, measurement limitations, context, or sampling variation.

Raw lines 158 to 176
177## Open-science limits
179Use [TOP 2025](https://www.cos.io/initiatives/top-guidelines) for current transparency planning rather than treating the original 2015 policy as the latest framework. For this hypothesis package, record separately whether the registration, protocol, analysis plan, materials, code, data, and reporting checklist are disclosed, shared and cited, or independently certified. Sharing a plan does not establish independent verification or certify its scientific validity. Apply the target journal or funder's actual policy.
181“Open” does not override:
183- participant consent and privacy;
184- Indigenous or community data governance;
185- contractual or intellectual-property restrictions;
186- export controls;
187- biosafety and dual-use review;
188- endangered-species or sensitive-location protections;
189- security-sensitive vulnerabilities.
191Share the maximum responsibly permitted, not the maximum technically possible. Use metadata, synthetic examples, controlled access, or redacted protocols when full release is unsafe.

Open-science limits

Use TOP 2025 for current transparency planning rather than treating the original 2015 policy as the latest framework. For this hypothesis package, record separately whether the registration, protocol, analysis plan, materials, code, data, and reporting checklist are disclosed, shared and cited, or independently certified. Sharing a plan does not establish independent verification or certify its scientific validity. Apply the target journal or funder's actual policy.

“Open” does not override:

  • participant consent and privacy;
  • Indigenous or community data governance;
  • contractual or intellectual-property restrictions;
  • export controls;
  • biosafety and dual-use review;
  • endangered-species or sensitive-location protections;
  • security-sensitive vulnerabilities.

Share the maximum responsibly permitted, not the maximum technically possible. Use metadata, synthetic examples, controlled access, or redacted protocols when full release is unsafe.

Raw lines 177 to 192
193## Scaffold generation
195Generate a local draft only after the hypothesis record validates:
197```bash
198python3 scripts/generate_preregistration_scaffold.py \
199 local-hypothesis-record.json \
200 -o local-preregistration.md
201```
203The result:
205- is marked as an unregistered draft;
206- labels the input record's update date without claiming a generation or registration timestamp;
207- includes every candidate without ranking;
208- carries unresolved placeholders;
209- requires human review and repository-specific completion;
210- does not submit, register, upload, or transmit anything.

Scaffold generation

Generate a local draft only after the hypothesis record validates:

python3 scripts/generate_preregistration_scaffold.py \
  local-hypothesis-record.json \
  -o local-preregistration.md

The result:

  • is marked as an unregistered draft;
  • labels the input record's update date without claiming a generation or registration timestamp;
  • includes every candidate without ranking;
  • carries unresolved placeholders;
  • requires human review and repository-specific completion;
  • does not submit, register, upload, or transmit anything.
Raw lines 193 to 210
Runs code python3 scripts/generate_preregistration_scaffold.py :198