Notes/002
Agents need rails, not vibes
2026-05-03
A coding agent with no committed decisions will redesign your site on every run.
I like working with agents. I do not like watching them invent a new folder structure because the last one wasn't in the prompt this time.
The useful move is not a longer prompt. It is a repository that has already decided. AGENTS.md that names the invariants. A schema that is a system, not a suggestion. Fetchers that are typed and tested. A browser the agent can actually open to check its work.
Vibes are cheap. Rails are expensive to lay and cheap to run on. I will take the second every time, especially on client work where the cost of drift is a weekend you will not get back.
If you are hiring me, you are hiring the rails. The pixels come after the document has a spine.