FIELD NOTES//THE BLOG
Field notes on AI-assisted engineering.
Practice notes, design notes, and internals from building change control for AI-made changes. Teaching first; the product appears where it genuinely fits.
Per-symbol drift, beyond TypeScript
codument's drift detection began as a TypeScript feature. It now reads Python, Go, Rust, C#, Java, Kotlin, and single-file components the same way, and the site can only claim what the installed release ships.
Keeping AI off the verdict path
Why a safety layer for agent output has to be deterministic all the way down, and what that rules out by design.
The diff is not the deliverable
When an agent writes the code, review stops being a courtesy and starts being the product. What a reviewer actually owes the merge.
Your agent changed 14 files. Which docs went stale?
The failure mode of AI-assisted development is quiet. Nothing crashes, the tests pass, the diff merges. And somewhere in your docs, a paragraph that used to be true just stopped being true.