| name | experiment-journal |
| description | Write a structured experiment journal article after completing an experiment iteration. Use this skill whenever the user finishes running an experiment, wants to document results, says 'write journal', 'document this experiment', 'save experiment results', 'write up the iteration', or after any experiment run completes. Also trigger when the user asks to compare experiment iterations, summarize findings, or create a report from autotest results. |
Experiment Journal Writer
Generate a comprehensive, publication-quality experiment journal entry after each iteration of hypothesis testing. The journal captures everything needed to reproduce, understand, and build upon the experiment.
When to Write a Journal
Write a journal entry after:
- An experiment run completes (autotest results available)
- The user asks to document or summarize an experiment
- Comparing multiple experiment iterations
- Concluding a hypothesis testing session
Data Discovery
Before writing, gather all available data. Check these locations in order:
1. Experiment Directory (experiments/<name>/)
experiments/<name>/
├── CLAUDE.md # The variant being tested
├── results-summary.json # Autotest results (per-case pass/fail)
├── run-config.json # Test configuration (cases, parallel, model)
├── last-run.log # Full run output
2. Baseline Directory (experiments/baseline/)
Same structure — the control group. Always compare against this.
3. Architecture Session (ai-docs/sessions/dev-arch-*/)
ai-docs/sessions/dev-arch-*/
├── consensus.md # Multi-model vote synthesis
├── hypothesis-prompt.md # Original hypothesis definitions
├── implementation-plan.md # Planned changes
├── vote-*.md # Individual model votes
4. Previous Journals ()
