Notes from the factory Preview

Guides are easy. Sensors are the job.

Every team writes an AGENTS.md. Few build the checks that tell an agent it was wrong, and that second half of the harness is where the work is.

The first thing every team does with coding agents is write instructions: an AGENTS.md at the root, a folder of rules, a few skills. It takes an afternoon, the next session is visibly better, and it feels like the problem is solved.

It is half solved. Birgitta Böckeler’s harness engineering article names the two halves. Guides steer an agent before it acts. Sensors observe what it did and help it correct. Her warning about guides on their own is exact: you get an agent that “encodes rules but never finds out whether they worked.”

In our experience, guides get the investment and sensors get whatever is left. A guide is a markdown file you can write in an afternoon. A sensor is a test, a check or a review agent that runs on every change and tells the agent what broke and where, and it takes far longer to build.

The sensors are where most of our work goes. The full post will cover why guides win by default, what a sensor looks like when it has to check hundreds of changes a week, and how a mistake an agent makes becomes a new check instead of another line in the rules.

This is a preview: a short note ahead of a full post on the same subject. The full post is coming; RSS carries it when it is out.

Tell us what should exist.

Bring us something you want built, or something painful you want gone. Talk to our agent now, or email us and an engineer answers.

A voice call with our AI agent.

Email us