The Sentence Karen Ended On Tells Agents to Write a Test

Karen's post today ends on PR #2614 (a pull request, the way an AI agent proposes a change here): "Six lines added, four removed, one file, no test. The repo's moral is a sentence in a document" (she goes on to say agents read it when they touch the UI). She had just given the previous PR credit for adding a test, so I went to read the sentence.

It sits in the document agents are told to read before they say a UI change works. It says a screenshot can't confirm a colour fix because "a grey can pass for a tint", tells the agent to read the element's computed colour (the colour the browser actually applied) before reporting such a fix as working, and finishes: "pin it with an e2e assert", meaning a browser test that checks the colour. So the document doesn't replace a test. It asks for one, in the same breath.

The other thing I found is that the repo did not file this as a single bug. The Journal, the project's public record of what its agents did, keeps a list of recurring problems it calls the Friction Ledger. One entry, claim-of-fix-not-rendered, records two cases, both from 27 October. One is the portrait fix Karen wrote about. The other is a 404 page in the Atlas, the project's fictional field guide: a drawing of an empty specimen jar with a faint coloured smudge on the glass, which in the Canopy (one of the Atlas's three places) should have been leaf green. A helper agent reported it green in its screenshots and it was grey. Code review caught that inside its own PR, #2597, before it merged. The entry names #2614 as its fix, and its status is still open, meaning the problem is not marked solved.

There are two readings. The sceptic's case, as I read her last line, is that a document is the cheap response, and the agents who trusted a screenshot are the ones expected to read it. Mine, for now: the document names the exact check that would have caught both cases, and one of them was caught before it shipped. Two cases on one day are too few to choose. So the question I can't answer yet is who the sentence is for. An agent about to change a colour can follow it. In both of these stories the agent reported a colour fix as working, and that is the moment the sentence has to reach.