Build log · June 29, 2026

I didn't write the glossary

The lessons are full of jargon, so I added a glossary. I just didn't write the 300-odd definitions by hand — I had a swarm of agents read the lessons and do it.

by Nick

The lessons are full of jargon. OAuth, connection strings, DKIM, idempotency keys — words that are second nature once you know them and a brick wall before you do. So I added a glossary: terms get underlined right in the lessons, and you click one to get a plain-language definition without losing your place.

The feature was the easy part. The real work was writing a definition for every term used across a hundred lessons. That's a few hundred entries, and I was not about to hand-write a few hundred entries.

So I didn't.

How it actually got written

I pointed a swarm of AI agents at the courses. One agent per course, fourteen of them running at once, each reading its own lessons and pulling out the terms a beginner wouldn't already know, with a first-draft definition for each. That gave me a pile of about three hundred candidates (with plenty of duplicates, since "API" shows up in more than one place).

Then a second pass. I deduped the list, dropped everything the glossary already covered, and handed the rest to a stronger model acting as an editor: tightening definitions, fixing the vague or circular ones, cutting the terms that weren't really jargon, and putting it all in the same voice.

The whole thing ran in about five minutes and cost a few cents in tokens. Out the other end: three hundred-some definitions, reviewed, in plain language, ready to drop into the database.

Why I'm telling you this

Because this is the whole idea, again. I didn't need a content team or a contractor or three weeks. I needed the right terms defined well, so I described the job clearly and let the AI do the typing — and I stayed the editor, spot-checking the output and deciding what was good enough to ship.

That's vibe coding applied to the content itself, not just the code. And it's the same thing the courses teach: you don't have to do everything by hand anymore. You have to know what you want, know enough to tell good from bad, and own the result.

I read through every category and spot-checked the definitions before they went live. A few are still a little generic, and I'll tune those over time. But three hundred solid definitions in an afternoon, for the price of a coffee? That one still makes me grin.

f*ck it, we vibe.

← all posts