- Home
- Checklist
Guide
Pre-submission reproducibility checklist
18 things to get right in your repository before you submit, each linked to journal policies and a RepoReady check.
Last updated
Environment
Pin every dependency to an exact version
Commit a lock file or exact version pins, and state the language version.
PoliciesJournal policiesCheckRepoReady checkEnvironment & DependenciesDocument hardware, operating system and run time
Name the CPU or GPU, memory, operating system and run time of each experiment.
PoliciesJournal policiesCheckRepoReady checkEnvironment & Dependencies
Data
Say exactly how to obtain every dataset
Source, accession or URL, version, license and access steps, ideally as a download script.
PoliciesJournal policiesCheckRepoReady checkData ProvenanceExplain restricted data and provide a stand-in
Say why the data cannot be shared, how to request access, and add a synthetic sample.
PoliciesJournal policiesCheckRepoReady checkData ProvenanceInclude the preprocessing code, not only processed data
Every step from raw data to analysis input is a script in the repository.
CheckRepoReady checkData Provenance
Code and entry points
Include the code for every reported result
Numbers, figures and tables, including simulations and the baselines you compare against.
PoliciesJournal policiesCheckRepoReady checkPaper–Code AlignmentUse relative paths only
Read file locations from a config file or a command-line argument.
PoliciesJournal policiesCheckRepoReady checkReproducibility & Entry PointsProvide one documented entry point
A Makefile, workflow or script that performs every step in order, with its command.
PoliciesJournal policiesCheckRepoReady checkReproducibility & Entry Points
Randomness and statistics
Set, record and report random seeds
Seed every random number generator, make seeds configurable, and state them in the paper.
CheckRepoReady checkDeterminism & Reproducible RandomnessReport the number of runs and the variability
Runs or seeds per result, with error bars or confidence intervals and how they were computed.
PoliciesJournal policiesCheckRepoReady checkStatistical Soundness
Outputs and figures
Map every figure and table to its script
A README table with paper item, script, input and output.
PoliciesJournal policiesCheckRepoReady checkCross-Consistency (Paper ↔ Code)Write outputs to predictable, documented locations
Save figures, tables, metrics and logs with the configuration and seed behind them.
PoliciesJournal policiesCheckRepoReady checkResearch Traceability
Documentation
Write a README from clone to results
What the code does, how to install and run it, expected outputs, a repository map.
PoliciesJournal policiesCheckRepoReady checkDocumentation QualityPoint from the code to the paper
Comment method code with the section, equation, figure or table it implements.
CheckRepoReady checkResearch Traceability
License, archive, citation
Add an open-source license
A LICENSE file in the repository root tells others how they may reuse the code.
PoliciesJournal policiesCheckRepoReady checkLicensing & CitationArchive the paper version with a DOI
Tag a release, archive it with a DOI, cite it, and add CITATION.cff. Guide
PoliciesJournal policiesCheckRepoReady checkLicensing & Citation
Manuscript alignment
Write the code availability statement
Repository URL, archive DOI, version, license and any access restrictions. Guide
PoliciesJournal policiesCheckRepoReady checkLicensing & CitationCheck that the paper matches the code
Methods, data splits, hyperparameters, seeds and reported numbers agree with code and outputs. Guide
PoliciesJournal policiesCheckRepoReady checkCross-Consistency (Paper ↔ Code)
Copy the checklist as Markdown
Paste it into an issue or your README and tick items off as you go.
# Pre-submission reproducibility checklist
Source: https://repoready.ai/checklist
## Environment
- [ ] Pin every dependency to an exact version
Commit a lock file or exact version pins, and state the language version.
- [ ] Document hardware, operating system and run time
Name the CPU or GPU, memory, operating system and run time of each experiment.
## Data
- [ ] Say exactly how to obtain every dataset
Source, accession or URL, version, license and access steps, ideally as a download script.
- [ ] Explain restricted data and provide a stand-in
Say why the data cannot be shared, how to request access, and add a synthetic sample.
- [ ] Include the preprocessing code, not only processed data
Every step from raw data to analysis input is a script in the repository.
## Code and entry points
- [ ] Include the code for every reported result
Numbers, figures and tables, including simulations and the baselines you compare against.
- [ ] Use relative paths only
Read file locations from a config file or a command-line argument.
- [ ] Provide one documented entry point
A Makefile, workflow or script that performs every step in order, with its command.
## Randomness and statistics
- [ ] Set, record and report random seeds
Seed every random number generator, make seeds configurable, and state them in the paper.
- [ ] Report the number of runs and the variability
Runs or seeds per result, with error bars or confidence intervals and how they were computed.
## Outputs and figures
- [ ] Map every figure and table to its script
A README table with paper item, script, input and output.
- [ ] Write outputs to predictable, documented locations
Save figures, tables, metrics and logs with the configuration and seed behind them.
## Documentation
- [ ] Write a README from clone to results
What the code does, how to install and run it, expected outputs, a repository map.
- [ ] Point from the code to the paper
Comment method code with the section, equation, figure or table it implements.
## License, archive, citation
- [ ] Add an open-source license
A LICENSE file in the repository root tells others how they may reuse the code.
- [ ] Archive the paper version with a DOI
Tag a release, archive it with a DOI, cite it, and add CITATION.cff.
## Manuscript alignment
- [ ] Write the code availability statement
Repository URL, archive DOI, version, license and any access restrictions.
- [ ] Check that the paper matches the code
Methods, data splits, hyperparameters, seeds and reported numbers agree with code and outputs.Journal policy sources
Policy pages checked on September 16, 2026.
- Nature Portfolio
- Reporting standardsReporting summary (PDF)
- Cell Press
- Journal policiesSTAR Methods guide
- eLife
- Author instructions
- GigaScience
- Editorial policies
- NeurIPS 2026
- Paper checklistCode submission guidelines
- AAAI-26
- Reproducibility checklist
Run the checklist on your repository
Get a 0–100 score and findings with suggested fixes before you submit.