Codeuteronomy

The Book of Works

III

Durable work

If it will run twice, it lives in the repo. Scripts, configs, knowledge: tracked, not transcript.

The ninth law says durable or it didn't happen; on the builders' floor that means the repository is the only place work is real. A script that lives in a scratch folder, a command that lives in shell history, a fix that lives in the transcript: each dies with the session, and the next session, the next machine, the next person pays to rediscover it. If it will run twice, it goes in the tree, tracked, the day it works.

The same discipline covers configuration. A variable slapped onto one command line is an incantation, true exactly once; the fix belongs in the program's defaults or a committed launcher, where the documented invocation just works, for the next run, on the next machine, with nothing extra remembered. If reproducing success requires remembering something, the work is not done.

How to practice it

Deep scripture: Codeuteronomy X — What is not committed did not happen