Drift Checking
Engineering Practices
Generated artefacts are regenerated and byte-diffed in CI, so a hand edit fails loudly.
Regenerating a derived artefact in CI and comparing it byte for byte with the committed copy, so a generated file cannot be edited by hand without the build noticing.
How we use it
Applied to every generated artefact here: clients, schemas, documentation. A generated file that someone edited is a file that has quietly stopped being generated.
10
systems
Articles about this
One Contract, Many Clients
A hand-written API client passes review because it works today. It has no link to the route it mirrors, so the next schema change leaves it quietly wrong.
OpenAPI Code GenerationRTK QueryDrift Checking
September 5, 2026 · 3 minRead more
Documentation as JSON
Markdown is a fine thing to read and a poor thing to maintain once there is structure worth keeping consistent. So we stopped writing it by hand.
ForkTex KnowledgeDrift CheckingPydantic
September 5, 2026 · 4 minRead more