Free field guide · Book II
So your agents ship code. Now make that boring.
This field guide is the full story of how we run AI agents as production software: the contract that feeds them, the gate that authorizes them, the failure paths designed for them, and the discipline that lets a security finding dispatch its own fix.
web edition + PDF download
The complete guide: the self-healing loop, the day it broke, the work contract, the Health Code, designed failure, verification, observability, memory, the new attack surface, and the 24-question scorecard.
How it starts
A security scanner finds a vulnerable dependency. Nobody reads the alert, because nobody has to: the finding becomes a validated work order, passes an authorization gate that recognizes a security finding as its own justification, and a sandboxed runner opens the pull request.
The only human in the loop is the one with the most leverage: the reviewer who merges. This guide is everything that makes that loop safe to run.
The problem this guide solves
Anyone with an API key can rent the capability. The operation is the part you have to build. If your agents write code, run jobs, or touch production today, run this test against your own setup:
You probably have
capability- Agents that write and ship real code
- Automations wired to your tools
- Impressive one-off saves to talk about
- Careful people watching over it all
You probably don’t
operations- One gate deciding what agents may change
- A designed place where failed work lands
- Checks that catch tests asserting nothing
- An audit of what agents run automatically
Inside the guide
Who this is for
Written for you if
- Your agents already do real work: writing code, running jobs, touching production systems
- The operation around them grew by accident, and you know it, and nights before releases feel that way
- You could not say, mechanism by mechanism, what stops a bad agent change tonight
- You want the discipline without a platform team to build it for you
Skip it if
- You’re deciding whether to try AI at all
- Your agents only draft text a human always reviews
- You want prompt-engineering tips
- You need a basic CI/CD tutorial