The first useful agent teammate needed a Gmail account
Before an agent can share docs or run a dispatch loop, it needs an identity, permissions, and an inbox that behaves like a work queue. The bottleneck was getting the agent a badge.
The build log
Notes from running agents in production.
Build log, architecture patterns, and observations from running autonomous AI systems in production.
-
-
Our whole 1,200-domain provider split died instantly: keep a second DoH provider on hand
We were halfway into a Cloudflare-for-SaaS migration audit when every DNS lookup we depended on failed at once. All 1,264 of them failed, and they failed instantly.
-
Bot Swarm Detection: The Three-Signal Triangle That Catches What IP Reputation Misses
IP reputation is blind to distributed residential-proxy swarms. Here is the three-signal method (asset-mix, UA homogeneity, Referer chain) grouped by netblock that stopped a live 100%-CPU incident in five minutes, plus the counter-case that turned out to be a database problem wearing a swarm's clothes.
-
When the System Cannot Know Intent, Make the Decision Explicit
Some write actions have more than one legitimate outcome, but the deciding fact is not in the data. A trustworthy system does not silently guess: it explains the conflict, offers only authorized and supported choices, validates the decision on the server, and records the result.
-
When a Content Workflow Needs Explicit State
A folder of Markdown remains a good source of truth for many publishing workflows. As concurrent contributors, approvals, structured review, traceability, and governed automation grow, an explicit state model and scoped authority become more important than the storage technology itself.
-
Don't Publish Into a Void: Baking Revenue Attribution Into the Schema on Day One
The outcomes table ships in wave one of our content pipeline, because you cannot backfill revenue attribution for posts published before it existed.
-
RTK Ate Our JSON and Hid a Merge Commit: When a Token-Saving Filter Lies to Your Agent
Our token-saving CLI filter turned a JIRA payload into a schema sketch and hid a merge commit from our agent. The rule: lossless on any path that verifies state.
-
Same Root Cause Is Not Same Fix: Verify the Data Shape, Not Just the Symptom
Two accounts, same symptom, same root-cause label, opposite fixes: one row re-pointed, one row deleted. Query the actual data shape before reusing a repair script.
-
A Second Review Is Useful When You Record the Decision
A second review adds value when its scope, evidence, limitations, recommendations, dissent, risk acceptance, follow-up owners, and re-review triggers are explicit. AI can assist with bounded analysis, but it does not replace independent evidence or accountable human judgment.
-
/add-dir Doesn't Reach Across Your Skills: The IDE-vs-CLI Claude Code Gotcha
In the Claude Code CLI, /add-dir grants file access but not skills: discovery stays rooted at the session cwd, so cross-repo skills belong at the user level.
Follow the Build
The real failures and fixes from building AI systems, one practical lesson per post. Get the next one in your inbox.