What problem does it solve?
Experiment-audit prevents overconfident or incorrect research claims by checking whether reported results are grounded, correctly computed, and actually supported by the underlying files.
Core Features & Use Cases
- Ground-truth provenance verification: Confirms evaluation targets are sourced from datasets rather than being derived from model outputs without explicit proxy labeling.
- Score normalization fraud detection: Flags suspicious metric normalization that divides by model-derived maxima/minima/means.
- Result-to-claim existence and consistency checks: Verifies that paper/narrative claims reference real result files with matching metric keys and values.
- Dead code and scope assessment: Warns when metric functions are never called or when evaluation coverage is too small for the strength of claims.
- Cross-model integrity review: Separates collection (executor) from judgment (reviewer) to reduce bias and improve audit reliability.
Quick Start
Run experiment-audit on your completed experiment directory by providing the path to the experiment results so it generates EXPERIMENT_AUDIT.md and EXPERIMENT_AUDIT.json.