generated from mathias/template-go-web
33 lines
920 B
Markdown
33 lines
920 B
Markdown
# 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
|
|
|
|
```bash
|
|
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.
|