agentDATABASE_URL / S3_BUCKET / AUTH_SECRET — I will not invent these
youpaste three values
agentpnpm install && pnpm dev
ready on http://localhost:3000
agentwrite scripts/setup.md from what just happened
youreview it, commit it
One sentence in, and it has already read the repo.
It did not avoid the trap by being clever. It read the file.
It asked for exactly the three things only you could supply.
Working — and every step above is still on the screen.
The next person runs one command — and improves the record.
The next person runs one command — and improves the record.
decisions taken by you1233
when it breaksit searches, you approve
what you are left holdinga machine + a replayable record
startBoth begin from the same README. On the left it is a list of instructions to perform; on the right it is one more file for something else to read.
first trapThe README does not pin the package manager. The project needs pnpm 10; the machine installs 9. This is the ordinary kind of failure — not a hard one, just one that costs a quarter of an hour to somebody who has not met it before.
second trapNow the environment file. Notice what the right column does NOT do here: it finds the template, works out which three values are missing, and asks — because inventing a database URL is the one failure that would look like success.
runningBoth machines now serve. If the poster stopped here it would be an argument about a quarter of an hour, and a quarter of an hour is not worth a lesson.
the next personA week later somebody else joins. The left column is performed again, trap for trap, because a machine cannot be handed over — only a procedure can. On the right the procedure already exists, because it was written down by the thing that carried it out.
the next personA week later somebody else joins. The left column is performed again, trap for trap, because a machine cannot be handed over — only a procedure can. On the right the procedure already exists, because it was written down by the thing that carried it out.
The left column ends with a working machine. The right column ends with a working machine AND a recording of how it got that way — and only one of those two things can be handed to the next person. That is the whole claim: describing a setup produces an artefact, performing one produces only a mood.