Posts

Showing posts from November, 2026

Copy This Brief: A Coordinator Agent Plus Cross-Vendor Review

Image
A written brief at the center, with review coming in from the sides. In Green Tests, Broken App , I changed how fixes get built: one AI coordinator plans the work, builders write the code, and LLMs from other vendors review every piece. In The Bug Was in the Instruction, Not the Code , those reviewers caught the coordinator's own instructions being wrong. Those posts are the stories. This one is the part you can copy: the brief, the builder instruction, and the review checklist. The templates are a starting point. I have not measured them, and you do not need my exact setup to use them. Who Does What Think of a home remodel. The coordinator is the general contractor. It is one AI session that plans the work, writes an instruction for each builder, checks review findings, and puts the pieces together. It writes almost no code. A lane is one room: one slice of the change with its own files, so two crews are never tearing out the same wall. A builder is the crew in that r...

The Bug Was in the Instruction, Not the Code

Image
Three builders, one instruction, and a crack in the instruction. In one release, the reviewers caught the coordinator's own instructions being wrong three times. Not the builders' code. The instructions. I use AI agents to fix my assistant app. In Green Tests, Broken App , I ended with a rule: one coordinator plans and checks the work, builders from three vendors write the fixes, and every piece is checked by the two vendors that did not build it. Between October 27 and November 2, I ran that rule through eight more releases. The builders' mistakes were caught, as before. What I did not plan for was that the coordinator's mistakes got caught too. I count them as mine, because I run the coordinator. The Setup The coordinator is one Claude Opus 5.5 session. It plans each release, writes a short instruction for each builder, checks every review finding against the real code before passing it on, puts the pieces together, and ships. The builders are Claude, Codex runn...

Green Tests, Broken App: One Coordinator and Three AI Agents

Image
A smoke detector with a green light is not proof that it works. The light only says the battery is in. To know, you press the button and listen. This post is about the week I stopped trusting the green light on my own app, pressed the button, and changed how the fixes get built. In my last post, Five Reviews in One Release , I ended with one question to ask about every fix: what else does this touch? I also said I would stop letting a green checkmark tell me I am done. This post is the bigger version of that lesson. It was not one fix that fooled me. It was the whole app. The Setup My personal assistant app is the one I wrote about in Building a Personal Assistant: What I Got Wrong . Every change to it comes with tests: small programs that check the app does what it should. By October 22, 905 issues were closed, 422 of them since August 1. Nearly all were closed because about 4,700 tests passed. That day I said it plainly: basic things did not work, and I had lost trust in the a...