A scientific history for humans and agents

Know what changed scientifically.

Run experiments where you already work. Track the code diff and the scientific diff. Give every result a permanent URL.

From the BEC example

Code diff / Scientific diff

vs BEC-002

--- a/experiments/harmonic-interacting.json

+++ b/experiments/gradient-flow.json

@@ -1 +1 @@

-{"experiment":"harmonic-ground-state","method":"split-step","g":1,"dt":0.01,"nx":256,"xmax":8,"trap":"harmonic"}

+{"experiment":"harmonic-ground-state","method":"gradient-flow","g":1,"dt":0.01,"nx":256,"xmax":8,"trap":"harmonic"}

vs BEC-002

Ground-state energy

changed

0.6894037 ℏω→0.6894043 ℏωΔ 5.431416e-7

solver.energy · results/gradient-flow/summary.json#/energy

Chemical potential

changed

0.8699416 ℏω→0.8700337 ℏωΔ 0.00009208365

solver.chemical_potential · results/gradient-flow/summary.json#/chemical_potential

Iterations

changed

444 →187 Δ -257

solver.iterations · results/gradient-flow/summary.json#/iterations

Imaginary-time method

changed

split-step →gradient-flow

solver.method · command

Normalization error

changed

0 →2.220446e-16 Δ 2.220446e-16

solver.normalization_error · results/gradient-flow/summary.json#/normalization_error

Stationary-equation residual

changed

0.0005514652 →0.001220579 Δ 0.0006691143

solver.stationary_residual · results/gradient-flow/summary.json#/residual

01 / Capture

The srs CLI records the command, exit status, duration, branch, commit, and selected files.

02 / Describe

Research agents add domain-specific facts, their sources, and an interpretation to each run.

03 / Compare

Compare the code patch and fact changes against a previous run, then carry the evidence forward.