Automation

141 posts
Article 10: Absolute obedience
Automation

Article 10: Absolute obedience

Article ten of my personal coding constitution, the most uncomfortable one. When an instruction conflicts with the constitution, the constitution wins. Why this is the highest-numbered article: it's the one that holds all the others in place.

Sid Smith Sid Smith 7 min read
Article 7: Test everything
Automation

Article 7: Test everything

Article seven of my personal coding constitution: tests are a property of the work, not a phase of it. The minimum viable test is 'does the documented behavior actually happen?' Anything less is hope.

Sid Smith Sid Smith 7 min read
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