Automation

139 posts
Article 6: The override protocol
Automation

Article 6: The override protocol

Article six of my personal coding constitution: the rules exist for a reason, and the override is the documented escape hatch, not a habit. The mechanics that keep the override from rotting the rest of the constitution into theater.

Sid Smith Sid Smith 7 min read
Article 5: Track everything
Automation

Article 5: Track everything

Article five of my personal coding constitution: every action that mutates state must leave evidence. The trail isn't for the auditors. It's the thing that earns me the right to keep going.

Sid Smith Sid Smith 7 min read
Several identical polished wooden drafting compasses arranged in a perfect row on a dark wooden draftsman's desk
Automation

Parallel worktrees and the multi-agent illusion

The multi-agent demos make it look like running several agents in parallel multiplies your output. The git-worktree pattern shows the actual shape of what works, and exposes the trick the multi-agent framing is using.

Sid Smith Sid Smith 5 min read
Atoms and molecules as a software architecture pattern
Automation

Atoms and molecules as a software architecture pattern

The atomic-unit metaphor in software isn't decoration. It's a working design pattern: small immutable typed primitives (atoms) compose into larger functional units (molecules). What makes the metaphor useful, versioning, lineage, composition rules, and what makes it a marketing trap.

Sid Smith Sid Smith 7 min read
The five-not-eighty-nine test for any decision surface
Automation

The five-not-eighty-nine test for any decision surface

If your self-service form has eighty-nine questions on it, you haven't designed a decision surface, you've handed off a configuration job. The five-not-eighty-nine test: can the business owner read the surface in five minutes and know what they're choosing? Here's how to apply it.

Sid Smith Sid Smith 8 min read
An open vintage leather-bound logbook on a dark wooden desk with a fountain pen resting on the open pages and a small brass inkwell beside it
Automation

Why I log every tool call now

Three quarters of incident debugging time used to come from not knowing what the AI did. Logging every tool call into a queryable store changed that, small infrastructure investment, outsized return.

Sid Smith Sid Smith 4 min read
Article 3: Double check, never delete
Automation

Article 3: Double check, never delete

Destructive operations get a second look. Soft-delete by default. Backup before mutation. The bias is toward keeping the thing, and that bias gets stronger, not weaker, when an agent is the one running the command.

Sid Smith Sid Smith 6 min read
Article 4: Fail fast, three strikes
Automation

Article 4: Fail fast, three strikes

When something is broken you get three attempts to fix it before you must stop and re-plan. Why 'just one more try' is the failure mode, and why the rule matters most when an agent is the one trying.

Sid Smith Sid Smith 6 min read
Article 1: No issue, no code
Automation

Article 1: No issue, no code

The first article of my personal coding constitution: every change starts with a tracked issue, not a commit. I had to write this rule down for myself before I'd live by it. Then I had to write it down again for the agents I work with.

Sid Smith Sid Smith 6 min read
A close-up of stacked vintage paper documents on a dark wooden desk slowly accumulating a thin layer of dust under raking side light
Automation

Context drift is the new tech debt

Tech debt was the unfunded liability of an engineering team for two decades. Context drift, the slow erosion of what the AI tools think you're doing, is the equivalent for AI-augmented teams. Same shape, different substrate.

Sid Smith Sid Smith 6 min read
A vintage analog dashboard with several round meters on a polished wooden panel, some needles trending up and some down, under warm tungsten light
Automation

DORA metrics in the AI era: DevEx, but with hallucinations

Deployment frequency, lead time, change-failure rate, MTTR. The DORA framework worked for a decade because it measured the right things. AI-augmented engineering is bending those metrics in interesting ways and exposing the next thing to measure.

Sid Smith Sid Smith 5 min read
A polished wooden gavel resting next to a sleek modern computer chip on a dark wooden bench under warm overhead light
Automation

OPA + AI agent: policy-as-code for AI workloads

A month past the OPA-renaissance piece, with more shops actually shipping agent-policy stacks. Worth getting concrete about what the production deployments look like, the patterns, the policy bundle structure, and the interfaces that survive contact with reality.

Sid Smith Sid Smith 6 min read