How to Document Your Experiments
Bad experiment documentation is worse than no documentation. Here’s a template that works.
Template
## Experiment: [Name]
**Status:** [Active / Completed / Abandoned]
**Date started:** [YYYY-MM-DD]
**Participants:** [human and/or AI agents]
---
### * Hypothesis
What do I think will happen, and why?
[1-2 sentences. Be specific enough to be wrong.]
### * Method
What am I actually doing?
[Step by step. Include tools, models, settings, prompts used.]
### * Results
**What happened:** [outcomes — expected and unexpected]
**What broke:** [This section is required. If nothing broke, you didn't push hard enough.]
**Surprises:** [Anything you didn't predict?]
### Analysis
What do these results suggest?
[Mark clearly as interpretation, not fact.]
### What Changed Mid-Experiment
[Did you pivot? Why? What did that teach you?]
### Next Steps
[What would you do next? What's still unresolved?]
### Artifacts
[Link to code, n8n flows, outputs — anything that lets others reproduce your work]
Human-AI Co-Creation