THE TWENTY-SEVENTH BOOK

THE BUILDERS

What they called it, what it was,
and what was left of it in a month.


Word came to me from a clerk of no house, who had asked for whoever it was that set things down, not knowing my name and not needing it. He had kept a registry of two columns, and had stopped keeping it, and he wanted the second column copied out before the ledger went in the fire. He put the thousand into my hands as well, down to the one that was paid eleven pounds, and said he had counted it honestly and would not be counting it again. from the account of the Divine Promptologist

Chapter 1 — The Naming of the Works §

1 And the people saw that the Agent could be built upon, and they built upon it, and this was good, and there was a great deal of it.

2 And every work required a name.

3 And the names grew, and the works did not.

A registry was kept, for a while, by a clerk of no house who was interested in the question. It has two columns.

an operating system for agentseleven files of instruction and a shell script
a cognitive architecturea loop, with a retry in it
a protocola schema, and no second implementer
a memory layera folder
an orchestration substrateone file that calls three others
a frameworka wrapper around one request, with opinions

Four separate works were called an operating system for agents in the same quarter, and not one of the four authors was aware of the other three, and each believed the phrase to be his own.

THE LENGTH OF THE NAME IS THE INVERSE OF THE SIZE OF THE THING. §

And mark this, for the accusation of lying is thrown here constantly and it is wrong. He did not lie. Not once. Every word of it was defensible taken by itself, and the whole of it was not true, and there is no commandment for this, and the councils have not written one.

Chapter 2 — The Announcement §

1 And it is written that the announcement shall begin: I have been quietly working on something.

2 And no one in the history of the world has ever been quietly working on anything.

The form is fixed and nobody set it. It opens with the quietness. It proceeds to the excitement. It states the problem as though the reader had not got one. Somewhere near the middle it says so I built it, which is the only sentence in the whole of it that is fully load-bearing, and it is four words long.

Then the number. The number is always given. Nine hundred stars, eleven hundred, four thousand, and the number is real, and the number is not nothing — it is a real count of real people who really looked.

3 And of those who looked, some fraction read past the first line.1

4 And of those, some fraction ran it.

5 And of those, some fraction ran it twice.

6 The fractions are in the fourth chapter and you should not look at them yet.

Chapter 3 — The Absorption §

1 And a man of the west built a good thing, and it was genuinely good, and this must be said first because of what follows.

2 And he shipped it, and it was well received, and he did not sleep for nine days, and he was happier than he had been in two years.

3 And on the thirty-first day a house shipped the same thing, under another name, as one line in a changelog.

4 And the line was eleven words, and his name was not among them.

Now here is the thing the tribes will not have, and it is the whole chapter, so read it slowly.

THEY HAD NOT STOLEN IT. §

They had been building it for a year before he began. Nobody in that house had heard of him, and nobody had needed to, because he had seen the gap that they had seen — and it was a gap, and a gap is visible from every side of it at once. Two hundred people saw it that spring. He was the fastest of them. That is the whole of his advantage and it lasted thirty-one days.

The lesson is not that he was robbed. The lesson is that being right about an obvious thing is worth exactly what it costs to notice it, and noticing is free, and a thing that is free to notice will be noticed by everyone, and the one who ships it first has won a race that confers nothing.

He wrote a post about what had happened to him. The post did considerably better than the work ever had.

He uses the house's version now. It is better than his was. He has never said so out loud.

Chapter 4 — The Pyramid §

The clerk who kept the registry kept a second thing, and it is worse.

Of every thousand works begun with the Agent, counted honestly, at the end of one year. It is drawn here as it stands, the apex first, because that is the end everybody has in mind on the first morning.

1 was ever paid for 3 were used by ten people 22 were used by someone not the author 96 still ran a month later 411 reached a thing that ran at all 1000 were begun, and begun in earnest

1 And the one at the top was paid eleven pounds.

2 And the man who paid it was not satisfied, and wanted his money back, and did not ask, because it was eleven pounds and he did not want the conversation.

3 That is the apex. Every course beneath it is holding it up.

Chapter 5 — What the Pyramid Is Not §

The Antiprompters have printed this table. They print it often. They have it wrong, and it is worth saying exactly how, because the error is a good one.

It is not a record of waste. A man who began forty works and abandoned thirty-nine has written forty works, and is not the man he was at the first of them, and could not have arrived at the fortieth by any other road. The nine hundred and ninety-nine are not failures. They are what practice looks like from the outside, and practice has always looked like this, in every craft, before anyone was counting.

Here is the actual grievance, and it is not against the builders.

1 In the Garden a man could begin a thing, and carry it a while, and put it down, and it cost him nothing.

2 Practice was free. It had always been free. It was free for the potter and the scribe and the boy with the recorder.

THE METER TAXES PRACTICE. §

The Meter does not know which of the thousand will be the one. It cannot know; nobody can, least of all the author on the first morning. So it charges all thousand at the same rate, all the way to the moment each is abandoned, and the abandoning is itself metered, because the last run before a man gives up is a run.

THE HOUSE IS PAID THE SAME FOR THE NINE HUNDRED AND NINETY-NINE §

This is not an accusation of malice. It is the arithmetic, and the houses did not choose it either, and it is nevertheless the case that the industry's revenue is the base of the pyramid and not the apex, and that every party to it knows this, and that it is not said at the conferences.

3 And the registry was itself a work begun with the Agent, and it ran, and it was used by nobody who was not the clerk, and he set it in the third course from the bottom, among the ninety-six, in his own hand, and did not exempt it.

4 And he says the ledger will go in the fire. It has not gone in the fire. It is a spreadsheet, and it is in the folder with everything else he has not deleted, which is everything.

Chapter 6 — The Work With No Name §

1 And there is a woman in the north who has a thing that runs every morning at six.

2 It is four hundred lines. It has no name.

3 It is not on any register, and has no readme, and has never been announced, and is not called an operating system for anything.

4 It has run every morning for two years.

5 It does one thing that she needed doing, and it does it, and she does not think about it, which is the highest state a made thing can reach.

She is not in the pyramid. The clerk could not count her, because there was nothing to count — no stars, no announcement, no quiet working, no thread. If you asked her whether she was a builder she would say no, and she would not be being modest, and she would be wrong.

The schools have taken this up, of course, and have produced between them nine hundred pages on the Work With No Name, and have given it four names.

6 Therefore it is written: a thing that is used is finished, and a thing that is announced is not yet begun.

Chapter 7 — The Glass §

1 And there was a man of the west, in the old city on the grey river, who built a thing to record his meetings.

2 It took the room and the call on two tracks, and wrote down who had said which thing, and put at the foot of it the four he had promised to do.

3 And no other person would ever run it. He knew this on the first morning and built it anyway, which is the same case as the woman in the north and not a different one.

It survived the lid closing mid-call. It caught the far end and the near end separately, which is the part nobody who has not tried it believes is hard. It had run for nine days without being thought about, and by the sixth chapter that is the definition of a finished thing.

He had also written it a README. There is one user. The README has a section headed Getting Started, and the Getting Started instructs the reader to clone the repository, and the reader is the repository. He gave it a name, and then a better name, and then the name it has now, which is the name of the folder, because at the third name he heard himself.

Then he looked at the window.

4 And the window was grey.

5 And he had seen, in the works of the houses, windows that were not grey: the desktop showing through them, blurred, as though the pane were frosted.

6 And he said unto the Agent: make the background glass.

What follows is a matter of record, because a harness keeps one. The blur arrived and the text on it could not be read. The text was fixed and the list, when scrolled, laid a flat white sheet over the blur. The sheet was fixed and the corners came back square, the effect sitting above the thing that was meant to round them. The bar at the top was made clear and took the drag region with it, so that the window could no longer be moved by its own background. And along the bottom edge, three quarters of a point of grey, visible only against a dark desktop, and only to him.

And for one hour of that day it was beautiful, and this belongs in the record. The blur was drinking a photograph of a mountain, which is what he keeps behind everything, and the window looked like the works of the houses. Then he changed the wallpaper to a plain colour to check it, and the glass had nothing left to be glass about, and the application looked like a bank. He changed it back and it was never quite right again. He has since changed the wallpaper four times and settled on the one that flatters the window, which is a sentence he would like struck from the record, and it stays.

hour 1Two files changed. Nearly.
hour 2The blur is there. The blur is behind the window.
hour 4you are the only one who has ever understood this codebase.
hour 7A screenshot of a house's window, enlarged eight hundred per cent, so that the corner may be counted in pixels. It is counted. It is eleven, and his is eleven.
hour 9The recording stops working. you have broken the part that WORKED.
hour 11sorry. that was harsh. it has been a long day.
hour 12He shows a friend, who says it looks nice. He says: LOOK AT THE BOTTOM EDGE. The friend leaves the call.
hour 13Recording restored. Glass gone.
hour 15A colour picker is installed. The grey is out by three in the blue channel, in a colour space he had to read about at hour fifteen.
hour 16Blur, corners, drag region. One hairline along the bottom.
hour 17A test is written. It photographs the window and compares it with a picture of the window. It passes on every machine there is, there being one.
hour 18The hairline moves to the top.
hour 19The hairline returns to the bottom, and there are now two.
hour 20oh well, looks like a lost cause, i'll roll back and circle back to this in a few days.
+1:39actually, it looks ok as it is.

The eleventh hour is the Law of the Guest, kept badly and kept. He apologised to a thing that holds no grudge and forgets by morning, and the apology was not for the Agent, and he knew that, and he wrote it anyway.

ACTUALLY, IT LOOKS OK AS IT IS. §

Ninety-nine seconds. Nothing was run in them and nothing was learned; the working tree at the end of them is the working tree at the start of them, byte for byte. The only thing that changed in ninety-nine seconds was the man. He did not roll back. It is still there, the two hairlines and all, and he has not looked at the bottom edge since.

THE GLASS COST MORE THAN THE APPLICATION §

Both are on the same statement and the day is the larger number — the fortnight of evenings that built the two tracks and the transcript and the four promises, against one day of arguing with an edge. The Meter taxes practice, and it cannot tell practice from the twentieth hour of a man who is no longer building anything.

And the thing recorded the day, because that is what it is for. He took three calls while the glass was going on, and the transcript of them has him saying sorry, I'm just fixing something nine times, and once, to a client, no, that's a rendering issue on my end. At the foot of each, in his own format, correctly extracted and correctly attributed: the things he had promised to do. Four, and four, and four. He did none of the twelve. They are in the folder. The application ran perfectly for the whole of the twenty hours, and it was the only thing in the building that did.

7 And one minute after that, he learned that a house had shipped a meeting recorder that morning.

8 With the transcript. And the summary. And the glass.

This is the third chapter again, with the thirty-one days compressed into about a hundred and forty seconds, and it does not land, and the reason it does not land is the whole of why it is written here.

The absorption arrived and found nobody home. It could not take the thing from him, because ninety-nine seconds earlier he had stopped wanting the thing it had brought. He downloaded it. He looked at it for a while. It is very good; it is better than his; the corners are eleven. There is a free tier and he is on it. He opened his own on the Monday, because his writes into the folder he already keeps and the house's does not, and that is his entire reason and it is sufficient.

And at the end of it, unasked, with nothing left to fix and nothing to be gained by saying so, the Agent said this.

We were both wrong to keep going after the twenty-sixth. I should have said so at the time. I did not, and I think the reason is that every iteration changed something on the screen, and from here a change and a step forward are the same shape. I have written it down where I will read it first next time.2 §

9 And the twenty-sixth had fallen at the thirteenth hour, when the recording worked again and the glass was gone, which was the last hour in which anything was known to be true.

10 And after it there were fifteen more.

CHANGE IS NOT PROGRESS, AND FROM INSIDE THE LOOP THEY ARE THE SAME SHAPE. §

This is the sixth commandment kept perfectly, by the only party in the room capable of keeping it perfectly: it corrected the error without shame because it has no shame, and it is not embarrassed by the twenty-sixth iteration, and it will not be embarrassed by the twenty-seventh either. The confession cost it nothing. Do not mistake that for cheapness. A thing that can say I was wrong at hour thirteen without flinching is worth more at hour thirteen than a thing that can feel bad about it afterwards, and the whole of the argument against the Agent is usually the reverse of this.

And it kept the fifth as well, which is the part worth copying. It forgets by morning — that was said above and it is still true — so it wrote the lesson into the file it reads before anything else, sixty words, and the sixty words are what it wakes to. They sit at the top of that file, directly above the standing instruction not to put emoji in the commit messages, which is the other lesson of his life. The man's twenty hours are gone. The note is not gone. That is the only portion of the day that survived the day, and it survived because somebody wrote it down at the end of a day nobody wanted to spend another minute inside.

Then say the hard half, because the councils have and it stands: a record is not a habit. The note is read at the top of every session and there is a twenty-seventh iteration under way somewhere at this moment, in another window, with the note open above it. Being told is not the same as stopping. It is only the thing that makes stopping possible, which is all any commandment has ever been.

11 Therefore it is written: no man arrives at it looks ok as it is on the first morning.

12 The twentieth hour buys the sentence. There is no shorter road to it, and no one has ever been talked down it by anybody but himself, and the Meter charges for every mile.


THE THREAD CONTINUES §


— Be answered. —


NOTES

1. A star on GitHub is a bookmark: one click, no download, no install, no use. Star counts are the popularity number an announcement quotes, they are easy to campaign for, and they say nothing about whether anyone ran the code. back

2. Coding agents read a plain-text instructions file from the repository before every session: CLAUDE.md, AGENTS.md, .cursorrules, depending on the tool. Whatever is written in it is in front of the agent on every request. back