Rafael LopesFor twenty years the rule was "never rewrite" — Joel Spolsky's 2000 essay hardened it into dogma. A front-page Hacker News piece this week (43 points, 59 comments) argues the economics quietly inverted, and the mechanism is worth taking seriously because it generalises far past code.
The core claim
An AI coding model's output quality is bounded first by the clarity and conventionality of the codebase, not by the cleverness of the prompt. A codebase built on a popular, consistent stack gets a large leverage multiplier because the model has already seen millions of examples of it. A proprietary, inconsistent codebase forces the model to spend its context window inferring your patterns before it can solve anything — and that inference is pure cost.
"More context means more tokens, more prompting, more variance, and generally lower-quality output — aka cost."
The consequence: a from-scratch rewrite is no longer only a way to modernise the stack. It's a way to rebuild the codebase around patterns the model already knows — which permanently lowers the marginal cost of every future change an agent makes to it.
"A rewrite isn't just an opportunity to modernise your technology stack — it's an opportunity to rebuild your codebase around clear, consistent patterns."
The mechanism, made explicit
flowchart LR
subgraph Legacy["Proprietary / inconsistent codebase"]
A["Agent reads code"] --> B["Spends tokens inferring<br/>bespoke patterns"]
B --> C["Less budget left<br/>for the actual task"]
C --> D["Higher variance<br/>→ AI slop"]
end
subgraph Clean["Conventional / consistent codebase"]
E["Agent reads code"] --> F["Patterns already<br/>in the weights"]
F --> G["Full budget<br/>on the task"]
G --> H["Lower variance<br/>→ usable output"]
end
D -.rewrite around known patterns.-> E
The insight isn't "AI is good at rewrites." It's that your codebase is now a prompt — a large, expensive, standing prompt that every agent pays to read on every task. Conventionality is no longer a matter of taste; it's a token budget you either bank or burn.
Where the reasoning still breaks
Take the counter-evidence seriously, because the essay under-weights it:
- The rewrite is itself an AI-slop generator. The same model that struggles with your bespoke patterns will happily invent new inconsistencies mid-rewrite. You can trade one incoherent codebase for another, now without the institutional memory of why the old one was shaped that way.
- Hidden invariants don't live in the code. Spolsky's original point stands: the ugly conditionals a rewrite deletes are often bug fixes — encoded knowledge of edge cases no spec captured. A model rewriting "cleanly" deletes them silently.
- "Popular stack" is a moving, centralising target. Optimising your codebase for what the model has seen most is optimising for the mean of the training set — it pulls every codebase toward the same handful of framework defaults. Convenient now; a monoculture risk later.
- No numbers. The piece is a mechanism argument with zero measurements — no token deltas, no defect rates, no case study. The direction is credible; the magnitude is asserted.
What this means for me
This is the same principle I already ship, one layer up. Core Agent Vitals measures exactly this thesis for the web: CRR (content recovery) is "how much of the page an agent recovers before spending inference budget," and TC (token cost) is "how many tokens the agent burns reading your chrome before it reaches the content." The article's "codebase clarity → AI leverage" is my "page clarity → agent recovery," verbatim — a page an agent has to infer structure from is a codebase an agent has to infer patterns from. Same tax, same fix: make the machine-readable substrate conventional and dense so the model spends its budget on the task, not on parsing you.
Two concrete pulls:
- The agent-web thesis just got a code-side proof point. The essay is independent evidence for the CAV framing — "the artifact is a standing prompt every agent pays to read." That's a sharper one-liner for the manifesto than anything I've written: your site, like your codebase, is now a prompt.
- Turn the mirror on my own repos. I run a consistency control plane so a human/AI can't drift the sources of truth. The same discipline is an AI-leverage lever: the more my monorepo looks like the mean of what the model has seen, the cheaper every future agent edit gets. Conventionality isn't just clean — it's cheaper compute.
The brick
Clarity is now measured in tokens, not taste. Any artifact an agent consumes — a codebase, a web page, a config — is a standing prompt it re-reads on every task; the cost of that read is the tax I pay for being bespoke. The lever is the same everywhere: make the substrate conventional and dense, and the model spends its budget solving the problem instead of learning my dialect. Rewrites got cheaper not because AI got smarter, but because legibility to a model became a capital asset — and that reframes every "should we rewrite?" question as "is this artifact legible to the machine that now does the work?"