The oracle is the product
A coding agent will give you more text
than you can finish. The tempting job
title is “faster reviewer.” Dix, Engine,
and the eval pipeline are all arguing
the other way: the scarce artifact is a
check that can fail without a human
reading the implementation. Tests
against a known-good binary. Grouped
traces with a dataset example. A Harbor
task with a rubric. Those are oracles.
A highlighted hunk is a story about
code. Stories do not hill-climb.
Mechanism is boring and it works. You
separate “what should be true” from
“write the thing.” The first is a spec,
a migration guide, a world of shared
facts, a command that returns non-zero.
The second is generation, which you can
parallelize once the first is stable.
LangChain reviews markdown specs because
humans can argue about a spec. They do
not argue well about 400 generated
fixtures. Engine turns failing runs into
ground-truth examples before the fix
ships — the same move at production
scale. Bun’s rewrite only looks like
magic if you ignore the suite that could
say no.
Humans are not optional. They are
expensive in the wrong place. Product
intent, taste, and “is this even the
game we meant” still want a person.
Repetitive correctness does not. If you
cannot name an independent check, you
are not ready for a million-line agent.
You are ready for EVE’s 20,000
behavioral diffs: sit down, name the
meaning, then generate. Hunt every
possible comment after the oracle is
green and you will invent complexity so
the review has somewhere to land. Stop.
Write the oracle first. Then write the
prompt that points at it. Direction
without a check is a speech. A check
without direction is a random walk that
happens to compile.
Checklist
-
Before the agent starts, name the
independent check: tests, a scored
task, a known-good binary, a UI the
agent can drive.
-
Put human review on the spec and the
end result. Do not volunteer to recite
generated files.
-
If you are translating a system, keep
the old behavior as the oracle until
the suite says the new one matches.
-
If you cannot score a run, you cannot
hill-climb. Build the task and the
rubric before you scale generation.
-
When the oracle is green, stop hunting
extra problems. A new finding needs a
new check, or it is a nerd snipe.
This week: pick one change. Write the
failing check first. Only then let the
agent write code. Keep your eyes for
whether the result is the product.