Environmental divergence is a defect caused by differences between the environments that build, test, or execute the same software. An agent may pass locally yet fail in CI because machines, dependencies, configuration, or cached state differ. The disciplined alternative is hermetic execution: identical source and configuration produce identical results regardless of the triggering machine or agent. section 10.3.2
Reduce divergence by enforcing a controlled production-and-verification path:
- Give each agent an isolated execution environment with the same developer and CI configuration. section 10.3.2
- Pre-install dependencies, check out the relevant source revision, and configure only the tools the agent needs. section 10.3.2
- Run linters, type checks, tests, and iteration inside the sandbox instead of relying on an unverified local environment. section 10.3.2
- Separate code production from verification: expose a pull request only after the verification service reports a complete pass. section 10.3.2
- Treat infrastructure investment as a measured tradeoff; sandboxing, caching, and pre-warming cost focused engineering time but can recover iteration and waiting costs. section 10.3.6
A misleading green build
An agent can fail repeatedly in a private sandbox without blocking developers, then surface only a validated change. Without that separation, direct submissions create a review queue full of half-baked changes. Even fast feedback can become dangerous when the environment differs from the one that ultimately verifies the code: the feedback is fast, but it is lying. section 10.3.2 section 10.3.6
