Skip to content

Verification checklist

Use this for results you will rely on. For the first exercise, start with the expected answer and a rerun. Add checks as the analysis grows.

Copy this into your project as VERIFICATION.md. Link to evidence beside each relevant item: test output, a diagnostic figure or a run record. Mark an item "not applicable" with a reason when needed. See page 7.

Scientific specification

  • The question, unit of analysis, units and missing-data policy are documented.
  • Model equations and conventions are specified where applicable.
  • The implementation matches the intended method.
  • Exploratory changes are distinguished from preregistered analyses.

Calculation checks

  • A small example agrees with a calculation made independently.
  • A deliberately introduced plausible error is detected.
  • Tests cover relevant invalid inputs, duplicates and missing values.
  • Expected test values were reviewed and not changed merely to pass.
  • Diagnostic plots have been inspected and unexpected patterns investigated.

Model fitting, if applicable

  • Recovery is assessed over relevant parameters, sample sizes and several seeds.
  • Tolerances are justified and weakly identifiable parameters are discussed.
  • Convergence and boundary estimates are checked.
  • Reported uncertainty is evaluated, including interval coverage where appropriate.

Review and history

  • I can explain the key calculation and the limits of its checks.
  • Code and new files have been reviewed.
  • Any fresh-session review findings have been checked and addressed.
  • Small, descriptive commits record the changes and relevant check outcomes.

Reproduction

  • A documented command reproduces the result from saved inputs and settings.
  • The environment is recorded and the lockfile committed where used.
  • Random seeds are recorded where applicable.
  • The run record identifies code version, uncommitted changes, inputs and settings.
  • A clean rerun produces the expected result.
  • Fictional observations are labelled and cannot be mistaken for collected data.
  • The AI-assistance disclosure accurately describes what was done.

Cluster runs, if applicable

  • Expected outputs are present and contain the required results.
  • Missing, failed and timed-out jobs are accounted for.
  • Computation ran on allocated compute nodes.

Outstanding questions

Record remaining uncertainties and who will help resolve them. Completion is a judgement about relevant evidence, not a score based on the number of ticked boxes.