Gas Town
TL;DR
Read the Gas Town blog post and do the spaced repetition prompts as you go. Maybe look at the Glossary, too.
Welcome!
Gas Town is a highly complex, and very compelling, agent orchestration framework by Steve Yegge.
He revealed it to the world in his blog post: Welcome to Gas Town in January 2026.
This site is a deconstruction of that blog post. It consists of densely linked terms and concepts and spaced repetition prompts that help the ideas stick.
How to Use this Site
I recommend you read the original blog post section-by-section, pausing after each substantive section to refer to the spaced repetition prompts for the section (and to cross-check terms and concepts in the Glossary, as needed).
After you've read for a little while, just put it down until tomorrow. When you pick it back up, complete the spaced repetition prompts that are due, then keep reading.
Using this incremental reading approach, consisting of short sessions spread out over several days, there are several benefits. First, you won't need to read a highly complex 25-page blog post in one sitting! Second, you will actually understand the concepts at a much deeper level and be able to retain them far longer, despite the cumulative study time being only slightly longer. Ultimately, using these techniques, you will find it far easier to keep Steve's complex universe properly sorted in your head.
Just think of the spaced repetition system as Boot the Dog... who only bugs The Deacon at the optimal time so that he can otherwise be maximally effective. You'll soon understand what that means!
Alternatively, just read the whole blog post in one sitting and then test your understanding with the spaced repetition prompts. I'm not here to be a prescriptive bossy-pants. You do you!
Additional Resources
Another way to approach this is to look at the Annotated version of 'Welcome to Gas Town' where I attempt to annotate a subset of the paragraphs with context, and to derive the motivating problem areas to help make the why of Gas Town more clear.
Make This Your Own!
If you want to do your own thing, you can simply download these Markdown files (see the link at the top?) and use them as a "starter pack" for your own set of connected notes that you change to suit your preferences. The notes should work well in various markdown editors, but the spaced repetition prompts are written in the format that works in the obsidian spaced repetition plugin. That said, it is pretty easy to mold the pages to your exact preferences at scale these days using agents and agent skills to manage your markdown notes!