Append or update an experiment entry in the experiment journal
Create or update an entry in .agents/memory/experiment-journal/README.md to maintain
a living record of all experiments and their outcomes.
.agents/memory/experiment-journal/README.md exists.| Parameter | Required | Description |
|---|---|---|
name | Yes | Experiment name / identifier |
hypothesis | No | What you expected to learn |
config | Yes | Key config: model, lr, sp_size, gpus, script |
wandb_run | No | W&B run ID or URL |
duration | No | Total wall time |
metrics |
| No |
| Key metrics dict (loss, step_time, grad_norm) |
checkpoint | No | Path to checkpoint |
insight | No | What was learned |
status | Yes | running, completed, failed, abandoned |
lessons | No | Paths to related lesson files |
Search .agents/memory/experiment-journal/README.md for an entry with the same name.
If found, update it instead of creating a duplicate.
## [YYYY-MM-DD] Experiment: <name>
- **Hypothesis**: <hypothesis or "N/A">
- **Config**: model=<model>, lr=<lr>, sp_size=<sp>, gpus=<n>, script=<script>
- **W&B run**: <wandb_run or "pending">
- **Duration**: <duration or "in progress">
- **Key metrics**: loss=<loss>, step_time=<step_time>, grad_norm=<grad_norm>
- **Checkpoint**: <checkpoint or "N/A">
- **Insight**: <insight or "pending">
- **Status**: <status>
- **Related lessons**: <lessons or "none">
New entries go at the top of the file (after the header), so the most recent experiments are always visible first.
If a similar experiment name exists with status: completed, warn that this
may be a repeat. If it's status: running, assume this is an update.
.agents/memory/experiment-journal/README.md.Log a completed experiment:
name: wan-t2v-finetune-lr5e5-sp4
config: model=wan-t2v-1.3B, lr=5e-5, sp_size=4, gpus=4
wandb_run: fastvideo/training/run_abc123
duration: 2h 15m
metrics: {loss: 0.065, step_time: 2.3, grad_norm: 0.35}
checkpoint: outputs/wan_finetune/checkpoint-1000
insight: LR 5e-5 converges 30% faster than 1e-5 with no quality loss
status: completed
.agents/memory/experiment-journal/README.md — journal file.agents/workflows/experiment-lifecycle.md — when to log| Date | Change |
|---|---|
| 2026-03-02 | Initial version |