Experiment Ledger

An experiment ledger is a structured list of experiments, their hypotheses, setup, outcomes, and next decisions. It prevents research from becoming a pile of disconnected runs.

Each experiment can be represented as:

where is the question, is the hypothesis, is the configuration, is the result summary, and is the decision.

Minimal Columns

ColumnMeaning
IDPublic-safe identifier or short slug.
QuestionWhat uncertainty does this reduce?
HypothesisWhat did you expect before running?
ChangeWhat variable changed from the baseline?
Data/SplitDataset version and evaluation boundary.
MetricPrimary metric or diagnostic.
ResultPublic-safe outcome summary.
InterpretationConfirmed, not confirmed, surprising, or inconclusive.
NextWhat changes because of this result?

Public-Safe Rule

The public ledger should generalize or omit private run identifiers, internal task names, private paths, exact server details, collaborator details, and unpublished sensitive metrics.

Checks

  • Does every experiment have a pre-run hypothesis?
  • Is the baseline explicit?
  • Is the changed variable isolated?
  • Are negative and inconclusive runs recorded?
  • Is the next decision clear?