Codeuteronomy

Software

Claude Code as a daily colleague: sessions, rules, proof, and the drills.

Requires The Book of Works

Deep scripture: the Ten Commandments

IThe request must be bounded; the unscoped will be inventedA vague ask is a large ask with the boundaries left for the agent to guess. It guesses wide.IIDesign is settled before code is writtenRedirecting a plan costs a sentence. Redirecting a diff costs an afternoon.IIILarge work is divided and fencedParallel agents multiply throughput only when the boundaries are explicit. Without fences they collide, duplicate, and overwrite.IVDrift compounds; the earliest correction is the cheapestA wrong path costs more every turn it survives. The correction that would have been one word at turn one is a rewrite at turn ten.VA repeated instruction is a missing constraintTelling the agent the same thing twice is not steering. It is a defect in your setup, paid for by hand, every session, forever.VIThe irreversible act belongs to the human handDelegate the reversible freely. Keep the irreversible, and authorize it one act at a time.VIIThe source is authoritative; the agent's guess is notA generated value carries no evidence. Where a specification, configuration, or measurement exists, it governs. A plausible substitute offered in its place is a defect.VIIINo claim about the world stands without a fresh observation“It's running,” “it's untouched,” “the host is down”: each is a claim about the current state of the world, and each demands a probe taken now. Remembered state is not observed state.IXCompletion is claimed by the agent, proven only by an artifact“Done” is the agent's opinion. A render you can open, a diff you can read, a test that passed: that is proof. Accept the proof, not the opinion.XWhat is not committed did not happenWork of lasting value lands in the repository, tracked and re-runnable. A solution that lives only in a scratch file or a shell command evaporates with the session and gets paid for twice.