offspine-experiment-discipline
Use when running research prototypes beside a requirement-traced process (experiments that inform decisions but must not corrupt traceability) — deterministic pinned-input scripts that print their own
Files1
View on GitHubSKILL.mdproject-trajectory/skills/offspine-experiment-discipline/SKILL.md
GitHubWhen to use. Any prototype/research work in a gated repo. Why: the experiments lane's value is that any session — or any successor — can re-run and extend it; an unrecorded conclusion or an unreproducible number is the failure mode.
Procedure.
- Keep experiments off the requirement spine by contract (no registry rows; conclusions to the design doc, scripts as evidence, promotable cores named for later placement).
- Pin inputs and seed randomness (
cv2.setRNGSeedetc.); separate camera/hardware-dependent steps from headless ones and pin the regeneration commands for the former. - Scripts end with an explicit verdict line + matching exit code, including designed reds
(
INSUFFICIENT OVERLAP, "met, but saturated") — honest nonzero exits are recorded facts. - Record findings with numbers, negative results first-class; flag interpreted defaults as veto-able; when metrics change, keep the old number as a reference column.
- Maintain the resume surface every session: where it stands, exact resume commands, the human's bench errands as copy-pasteable blocks with consequences stated.
- Done when: a fresh clone can run the headless set and reproduce the cited numbers, and a cold session can resume from the surface without re-surveying the repo.
Knowledge: FIELD-KNOWLEDGE-GILBERT.md §G1 + §G4.