Experiments

One directory per experiment run. Large outputs (embeddings, checkpoints, logs) are gitignored. Only metric summaries are committed to results/summaries/.

Naming convention

YYYYMMDD-HHMMSS-phase-N-short-description/
  config.yaml       parameters used for this run (committed via results/summaries/)
  metrics.json      final metric snapshot (committed via results/summaries/)
  embeddings/       (gitignored — large)
  checkpoints/      (gitignored — large)
  logs/             (gitignored — large)

Git tag convention

Every run that produces reportable metrics gets a tag:

exp/YYYYMMDD-phase-N-description

Example: exp/20260601-phase-0-mae-baseline

Starting a run

task experiment:run -- --spec specs/phase-0-ssl-feasibility.md --tag my-run-description

The runner creates the directory, writes config, runs the experiment, and outputs metrics.json.