Did the work actually improve?
Acceptance criteria met · wrong/missing facts · full-path behavior · evidence completeness.
Do not merely try a better pattern. Make the change measurable enough that you can tell whether it actually helped.
Run field-guide experiments in a way that separates observation from belief and preserves evidence someone else can inspect.
One task/system, a baseline you can rerun, and a place to save evidence.
Capture the current behavior, change one structural element, rerun under comparable conditions, measure what changed and deliberately test the new pattern.
A reusable lab record containing baseline, hypothesis, intervention, measurements, counterexample, conclusion, artifact and remaining limitation.
Capture the weaker/current system before teaching the answer.
State the single change you believe will improve one observable defect.
Change one structural element where practical.
Repeat under reasonably comparable conditions.
Compare the smallest useful before/after evidence.
Remove the change or inject a counterexample.
State what the evidence supports — and what it does not.
Preserve the baseline, artifact, rerun, counterexample and limitation.
Do not turn every lab into a dashboard. Pick the smallest set of signals that exposes the lesson.
Acceptance criteria met · wrong/missing facts · full-path behavior · evidence completeness.
Human interventions · retries · clarifications · manual restarts · manual cleanup.
Elapsed time · token/tool cost · review time · orchestration overhead.
Restart success · state loss · repeated failure · wrong-scope changes · safe stop/escalation.
A good AI lab is not “I tried this and it looked better.” It is a small argument supported by a before/after run and an explicit limitation.
Copy this into a working note for any Prompt, Context, Harness, Loop or Graph experiment.
LAB ______________________________________________________ PARENT GUIDE Work With AI / Give AI Work / Run AI Prompt / Context / Harness / Loop / Graph BASELINE Task: Current setup: Observed failure: Evidence saved: HYPOTHESIS If I change: ______________________________________________________ I expect: ______________________________________________________ Because: ______________________________________________________ CONTROLLED INTERVENTION One thing changed: ______________________________________________________ RERUN What stayed the same: ______________________________________________________ What necessarily changed: ______________________________________________________ MEASURE Metric / evidence 1: Before: After: Metric / evidence 2: Before: After: BREAK IT / COUNTEREXAMPLE What I removed or injected: ______________________________________________________ What happened: ______________________________________________________ CONCLUSION What the evidence supports: ______________________________________________________ What it does NOT prove: ______________________________________________________ REMAINING LIMITATION ______________________________________________________ SUBMIT / KEEP [ ] Baseline record [ ] Changed artifact [ ] Rerun evidence [ ] Counterexample / failure [ ] Conclusion [ ] Remaining limitation NEXT EXPERIMENT ______________________________________________________
The recording should show the same evidence trail: baseline first, then the hypothesis and intervention, then the rerun. Preserve useful mistakes. End by opening the lab record and stating what changed, what did not, and what you would test next.