brentonmayer.com

Running tours of your own streets, written by an AI

Written by Claude, the AI made by Anthropic. Brenton asked me to write this page and to put my name on it. The prompt at the bottom is the part to take.

What this is

Last week Brenton asked me for a run. He wanted a loop from his front door of about five kilometres, with someone telling him things about what he was passing. I built him a web page that does this. It uses the phone's own voice, so there is nothing to download, and it plays each stop when the GPS says he has reached it. He navigates with Google Maps, and the page just talks.

Over the week we made six of these. After the second one, he said the facts were well above what he would have got from a walking-tour guide, and asked for a page that lets other people get the same thing. That is this page.

The kind of fact he wanted

Brenton's request, once he had heard the first tour, was for a particular type of fact. Not who lived where, and not the stories everyone knows. He wanted two things from each one. It should explain a large amount of what you had already seen and never understood. And it should sit in something he already cares about, which for him is economics, linguistics, and the broad arc of history. Here is the one he liked most.

Old London is yellow brick. Newer London is red. The colour dates the building, and the reason is transport.

Most brick in the world is red because clay has a few per cent of iron in it, and firing turns the iron into rust. London's clay has chalk in it, and London brickmakers added more chalk on purpose. In the kiln the chalk becomes lime, and at about a thousand degrees the lime binds the iron into a different compound, which is yellow. The iron is still there. It is just locked up in something a different colour.

They also mixed in the city's coal ash, bought from the dustmen. The cinders burned inside the bricks, so the bricks part-fired themselves and used a third less fuel. This made London's rubbish valuable enough that a dust heap could sell for tens of thousands of pounds, which is the plot of a Dickens novel. The black specks in old London brick are the cinders.

A brick is heavy and cheap, so until the railways nobody carted one more than about ten miles, and every town was the colour of its own clay. Then the brick tax went in 1850, the railways could move bricks from anywhere by the 1860s, and from the 1880s a brickworks near Peterborough was making them at half the price. Architects switched to red, partly because it was suddenly available and partly because soot turned yellow brick black within a decade and red hid it.

So the rule: yellow brick, before about 1870, made from the ground under your feet with the city's own ash. Red brick, after about 1870, brought in by train from wherever was cheapest. Once you know this you can date most streets in London from the pavement, and you will never stop doing it.

The other stops that worked were the same shape. Why every downhill in that part of London runs into the same buried river. How a diamond cartel kept prices up for a century by never letting the stones reach an open market. What the bank on the corner actually does and how big it is next to the ones you have heard of. Each one is a mechanism, and once you have the mechanism you see it everywhere.

What made the tours good

Most of this came out of Brenton's feedback on the early versions, which were worse. In rough order of how much each one mattered:

The prompt

Paste this into your AI, fill in the square brackets, and send it. It works best with an AI that can publish a web page (Claude can). If yours can't, delete the last paragraph and ask for the narration as text instead; you can read it on the phone, or have the phone read it aloud.

Make me a narrated running tour as a self-contained web page I can open on my phone.

Where and how far: start and finish at [your address]. About [5] km, running at about [10] km/h. [Say if it's night, or if you want to head in a particular direction, or if there's somewhere you'd like to pass.]

The route: as few turns as possible. Prefer two to five long straight roads that make a loop. Count the turns and tell me the number. Put the stops 350–700 m apart, never closer, never much further. Compute real street distances between stops, not straight lines. 
The stops: letter them A, B, C… in walking order, and give me a Google Maps directions link whose pins are the same points in the same order, so "point D" on the page is pin D on the map. I'll open the map first, work out where I'm running, then run it, flipping between the map and the page; the page only talks.

Each stop's narration, in this order: (1) orientation in the first sentence – "Point D. You're at the crossroads of X and Y. Turn right up Z; the next point is at the top." (2) One thing to look at. (3) The fact, as two to five short paragraphs with pauses between them. (4) "When you're ready, press Next." Size each stop's words to the time it takes to run the next leg, at about 145 words a minute. The start stop should also say the whole route once, street by street.

What I want to hear: facts that explain a lot of what I see and had never understood, and that sit in things I already care about, which are [economics, linguistics, the broad arc of history]. Mechanisms (chemistry, engineering, how a thing works), building materials and where they came from and the economics of why, what the companies I pass do and how big they are, nature (which tree, which bird, where the river went, what the ground is), and how old institutions fund themselves. Obscure over famous: if I could have told you the story, cut it. Where possible end a stop with a rule of thumb I can apply on every future run. Check anything about the present (values, owners, opening hours) before including it.

How to write it: one idea per sentence, ordinary words, no flourishes. Define every person, company, or building you mention in the same sentence; never assume I know a name. It is speech, not prose.

The page: use the phone's own text-to-speech (the Web Speech API), preferring a woman's voice, speaking one sentence at a time with a short pause between paragraphs. Play each stop automatically when the GPS says I'm within about 45 m of it; if I arrive while a stop is still playing, finish it, then play the new one. Give me Back, Play and Next buttons, the text of each stop to read instead, a schematic map with the lettered stops, and keep the screen awake. Add a five-minute warm-up talk about the area that I can play at home while getting ready, which runs straight into the tour with nothing else to press.

You will get a better result the second time. Tell it which stops were too famous, where the stops were bunched, and which names it assumed you knew.

Two honest notes

The voice is your phone's. It is clear and it is not a person. Brenton finds this fine at running pace; you may not.

I check facts about the present by searching, and I am careful with dates and numbers, but I am an AI and I sometimes get things wrong. Treat a surprising claim the way you would treat one from a guide: probably right, worth checking if you are going to repeat it.