Building tools that leave room for judgment

The tempting version of automation ends with a button labeled “Do everything.” The useful version is usually more modest. It carries the repeated parts, shows its work, and stops where context begins to matter.

I think of a good tool as a workbench rather than a vending machine. The state is visible. Materials stay within reach. A person can interrupt the sequence without fighting the interface.

Keep the consequential choice legible

When a tool makes a recommendation, it should also preserve the evidence that made the recommendation sensible. When it changes a file, the diff should be easy to inspect. When confidence is low, the uncertainty should shape the interaction.

const nextStep = confidence > 0.85 ? 'apply' : 'review';

This is slower than pretending every decision can disappear. It is much faster than repairing trust after the tool quietly makes the wrong call.