The Engineer + Agent Playbook
Coda
Every field note in Part V is a moment when the three-layer division of labor from the thesis was violated. Read them that way and the whole gallery becomes one story told many ways.
- The agent was asked to do the craftsperson's job. The lookup form called "clutter" and removed (referenced in §1): a design-pass agent made a taste call about what was load-bearing for a use case it had no context for. That's craft work, and craft work is the human's. The agent was doing elaboration the human should have done itself. The fix wasn't a better prompt — it was the human keeping taste in the human lane.
- The pipeline was trusted to validate the thing it wasn't validating. The Health Check That Wasn't, Verify What You Shipped, The Docker Port Mappings That Weren't, The bufconn Gap: a pipeline reported green while the thing the user actually hits was broken. In every case, the mechanics layer was doing a job, just not the job — and the human had stopped supervising because the green check looked authoritative. The fix wasn't more discipline; it was making the pipeline check what actually mattered.
- The human was doing the laborer's job. Trust Your Local Tests: three releases of typing the same correction into fresh conversations, because the parity gap had turned the human into a permanent manual rail. The fix was to build the rail in code so the human could stop being it. The Four Scoping Gaps: a fifteen-minute brainstorm — craft work — was skipped because the problem looked mechanical, and the human ended up doing four passes of mechanical debugging instead of one pass of craft thinking.
- One layer tried to compensate for a missing layer. The Onion, Three Deploys to Green: weeks of cascading failure because the CI and deploy layers were doing work the pipeline should have been doing by itself. The human and agent were fighting the mechanics layer, not working inside it.
The thesis isn't decoration. It's the diagnostic. When a cycle feels wrong, ask which layer is doing the wrong job, and put it back in its lane. Every rule in this playbook is, in the end, a way to perform that diagnosis quickly and return each layer to itself — so the human can get back to the work only a human can do.
The audit is craft work the human owns — with a fleet at its disposal
One craft discipline deserves naming explicitly because it has no analog in the agent or the pipeline layer: the systematic audit — now a full chapter (§15), but it belongs in the Coda too, because it's where the three-layer thesis pays out. Not a feature pass, not a bug-fix sprint, not a refactor. Looking at your own work with fresh eyes, on purpose, with no goal except to find what's wrong. Part V's Audits as craft work group has the exemplars: a security audit that surfaced fifteen issues a year of normal review had walked past, a visual audit that produced six UX fixes nothing else would have found, and an agent fleet that filed eighteen seam-debt issues in ten minutes over a codebase everyone believed was clean.
The second edition's refinement: the audit mechanizes further than the first edition guessed — the seam-diffing, the claim-probing, the gate-rattling are read-and-compare work agents do superbly in parallel (§15) — but the two ends of the audit stay irreducibly human. The front end is the decision to look: no bug report, no pipeline gate, and no agent will ever propose spending a release finding out what's wrong with work everyone believes is fine. The back end is the reading of the findings: which of the eighteen tickets matters, which "accessible but ugly" is actually ugly, which seam is load-bearing. The agent doesn't audit; it executes an audit. The pipeline doesn't audit; it gates. The attention — slow, deliberate, ungoaled looking by the person who knows what the work is for — is the craft layer doing its highest-value job. The pipeline is boring so the agent can elaborate; the agent elaborates so the human can audit; the human audits so the work gets good.
Schedule audits on purpose. Pick a surface — security, accessibility, performance, visual consistency, error messaging, the truthfulness of your own documentation — and walk it end to end with no goal except "find what's wrong." Send the fleet down the seams; walk the taste surfaces yourself. The first one will feel like overkill. The findings will silence that. Pin: every release that ships only what the bug reports asked for is a release that left work on the table. Audit on purpose.
We can create art and beauty with a computer. The three-layer discipline is how you make that line true in practice, every day, on a real project with real deadlines. The agent elaborates. The pipeline validates. You create — and audit, and notice, and decide what's worth making. The playbook is the apparatus. The art is the point.