Free sample — 3 full lessons below
Every AI agent guide is written by someone selling you the dream. This one is the incident log. For seven months, a fleet of always-on agents has been running a real homelab—building nightly, guarding its own permissions, spending real money—and writing down every single way it went wrong. The bricked fleet. The silent budget drain. The monitors that lied green. 150 numbered lessons, each one paid for with a real incident, distilled into rules, drills, and guards you can apply to your own setup this week. No community to join. No course to finish. One honest document, from an operation with receipts.
Thanks — you're on the list.
No spam. One email when the product launches.
Free samples
Three lessons from the archive, in full. These are representative of the 150. Read them before you decide anything.
We run three always-on agents that share one machine. Every dangerous tool call they make passes through a small shell script—a “pre-tool hook”—that can veto the call. It's the guard rail: it blocks careless deletes, catches credential leaks, enforces who may write where. It had been armed and boring for weeks.
One afternoon, the agent that owns that script improved it. It opened the live file and started writing the new version—top to bottom, in place.
For about ninety seconds, the file on disk was half old code, half new. The shell couldn't parse it. And here's the design decision that turned a typo into an outage: the harness treats a guard that ERRORS as a guard that says NO. Fail-closed—the correct choice, right up until the moment the guard itself is broken.
Every tool call, by every agent, on the whole machine: blocked. The fleet didn't crash. It did something eerier—it kept thinking, kept planning, and could no longer touch anything. Three healthy brains, fully paralyzed, for as long as the edit took.
A second agent saw the errors, diagnosed “the guard file is corrupted,” and very nearly fixed it—mid-edit, under its sibling's hands, which would have destroyed the new version and possibly left something worse.
Never edit an armed guard in place. Write the new version to a temp
file, syntax-check it there (bash -n, python -m py_compile,
whatever the interpreter offers), then atomically mv it onto the target.
The mv is one syscall; the guard goes from valid-old to valid-new with no
invalid state in between.
And the diagnosis heuristic for everyone else: if an armed guard suddenly throws syntax errors, check the file's modification time before touching it. If it changed seconds ago, someone is editing. Wait one minute and look again. Mid-edit races self-resolve; “helpful” repairs of in-flight work do not.
On a non-production copy of any hook or guard you run:
Ours is procedural plus one tripwire: guard files are hash-baselined, and a change to any of them without a matching change-log entry pages the human. You cannot make guards safe to edit casually; you can only make casual edits loud.
Our budget window had just reset. Fresh week, full quota. Within hours the owner messaged: “the window JUST reset and it's already 48% burned.”
The monitoring said everything was fine. Our usage feed read low-single-digits. Nobody was running big jobs. Yet the meter on the provider's side kept climbing—on the most expensive model we had access to.
Two things, both individually reasonable, had combined into a money leak:
The kicker: our own dashboard said we were fine, because it sampled a different meter—the aggregate one—while the burn was landing on the premium model's own per-model meter, which we weren't reading. The monitoring wasn't lying. It was answering a different question than the one that mattered.
Frontier-class models are scalpels: invoked per task, torn down after. The always-on residents—pollers, watchers, schedulers—run on the cheap tier, and anything that automatically wakes an expensive model must check a budget gate before every single fire, or it ships disarmed.
Corollary: when a human quotes a burn number your dashboard can't reproduce, believe the human, then go find the meter you aren't reading.
A budget governor that every dispatcher consults before spawning premium work—advisory at minimum, blocking at best—plus a hard rule in the agents' own operating doc: the expensive tier buys thinking (specs, verification, judgment calls); volume labor routes to the cheap tier. Every arm ceremony for anything scheduled now includes the question: “what does this cost per week if nobody ever looks at it again?”
We built a detector to audit an inbox-processing pipeline: every night it inspected recent items and reported problems. It ran green for days. Comforting, steady, green.
Then we noticed the pipeline it was auditing had been broken the whole time—its input feed had moved, so the detector's “recent items” query returned an empty list.
The detector looked at zero items, found zero problems in them, and printed PASS.
Which is technically true, the way a smoke detector with no battery has technically never detected a fire. Once we started looking for this shape we found it everywhere in our fleet:
Different systems, one disease: the green light measured something adjacent to the truth, and adjacency drifts.
A monitor is a claim: “I looked at X and X was healthy.” Every false green comes from quietly weakening one of those words:
Silence and success are indistinguishable unless you force them apart.
A detector that inspected zero items must report NO-DATA—loudly and distinctly—never PASS. And a green signal must measure the real quantity, end to end: “job ran” is not artifact-exists, “tests pass” is not behavior-verified, “process alive” is not work-delivered. Treat every green light on your dashboard as a claim to be audited: what did it actually inspect, and how many of them?
The habit that operationalizes this: every verdict travels with its denominator. “0 problems (in 412 items)” and “0 problems (in 0 items)” must be impossible to confuse.
Structural, not heroic: our report format requires a denominator on every verdict, our detectors have an explicit NO-DATA state that renders as loudly as FAIL, and new monitors ship with a “starve test”—we cut their input in staging and confirm they scream instead of smiling. Monitors earn trust the same way agents do: by being caught NOT lying when lying would have been easy.
One-time. No subscription. No community to manage.
“If your agents run unattended for even one hour a day, one lesson in here pays for the rest.”
Thanks — you're on the list.
No spam. One email when the manual launches. Unsubscribe any time.