Documentation
README
Experiment Journal
Externalize your experimental reasoning. Every ML project is a sequence of hypotheses tested โ this skill makes that sequence visible, persistent, and learnable.
The Iron Law
NO NEW EXPERIMENT WITHOUT LOGGING THE HYPOTHESIS FIRST
If you're about to change a hyperparameter, swap a dataset, try a new architecture, or modify a training recipe โ write down what you expect to happen and why BEFORE running it. This is how you learn from experiments instead of just running them.
File Structure
Maintain these files in the project root (create if they don't exist):
experiments/
โโโ journal.md โ Running experiment log (append-only)
โโโ lessons.md โ Distilled patterns and rules (curated)
Phases
This is the opening of the README. Read the full README on GitHub.