The Amnesia Problem
Every time you start a conversation with an AI coding assistant, you're starting from zero. The AI has no memory of what you built yesterday. It doesn't know your architecture, your design language, your deployment pipeline, or the seventeen decisions you already made about how authentication should work. You explain it all again. Every single time.
This is the amnesia problem, and it's the most expensive tax in AI-assisted development.
The industry's answer has been to make the conversation better. Longer context windows. Better prompts. More sophisticated chat interfaces. Cursor, Windsurf, Claude Code, Copilot — all of them are fundamentally conversation engines. You talk to the AI. The AI writes code. The conversation ends. The knowledge evaporates.
Think about what this means at scale. Every developer using AI is re-teaching it the same patterns, the same architectures, the same lessons — thousands of times a day, across millions of conversations, worldwide. All of that teaching vanishes when the chat window closes.
The prompt-and-forget model doesn't have a knowledge problem. It has a civilization problem. We're building on sand every single day.
The Glass Bead Game is my answer to this. Not a better prompt. Not a longer context window. A fundamentally different relationship between AI and knowledge.
The Metaphor
In 1943, Hermann Hesse published Das Glasperlenspiel — a novel about a future civilization that develops a practice of weaving connections across all domains of knowledge. Music, mathematics, philosophy, science — practitioners of the Glass Bead Game discover relationships between existing knowledge and compose new configurations. They don't create knowledge from scratch. They compose it.
That distinction — composition versus creation — is everything.
When you write a prompt, you're asking AI to create. "Build me an auth system." The AI improvises one from its training data. It might be good. It might be terrible. It will certainly be different from the auth system it improvised yesterday, even if you asked the same question. There's no score. No sheet music. Just jazz.
The Glass Bead Game asks: what if AI didn't improvise? What if, instead of creating from scratch, it composed from verified, distilled, reusable units of knowledge?
I call these units beads.
What Is a Bead?
A bead is a distilled, composable unit of software knowledge. Not a code snippet — though it might contain code. Not documentation — though it reads like a specification. A bead is knowledge formalized to the point where any AI model can use it to build, without needing to be taught.
Beads come in types:
That's a spec bead. It doesn't contain code. It contains knowledge — precise, unambiguous, machine-readable knowledge about how authentication works in this system. Hand it to Claude, GPT, Gemini, Llama — any model can build a working auth system from this bead. The same auth system. Every time.
Primary font: Source Serif 4 (body). Mono: IBM Plex Mono (labels, UI).
Accent: #d4a24e (amber/gold). Never use pure white. Noise overlay at 3% opacity.
Cards: 8px radius, 1px border, no shadows. Hover: border lightens to --border-hover.
Labels: mono, 9px, uppercase, letter-spacing 0.1em.
A design bead. Not a Figma file — a specification that any AI can execute. The page you're reading right now was built from a design bead. Every page on this site will be. The design language can't drift because the bead defines it.
Production = --branch=main. NEVER --branch=production (creates Preview).
Custom domains: CF Dashboard → Pages → Custom domains. Never manual CNAME.
API functions: src/functions/api/[endpoint].js. Runtime: edge. No Node APIs.
An infrastructure bead. Encodes hard-won operational knowledge — the kind of thing that takes two hours to debug when you forget it, and two seconds to apply when it's written down in the right format.
Where beads come from
Beads are harvested from everywhere. Open-source repositories (MIT/Apache code, architectures, patterns). Vendor documentation (Cloudflare, Stripe, Anthropic). AI-generated code that's been validated and distilled. And critically: from observation — studying how existing software works, specifying its behavior, and encoding that knowledge for reuse.
This is how the bead library compounds. Every project you build produces new beads. Every bead makes the next project faster. The system gets smarter with every build — not because the AI model improves, but because the knowledge it draws from improves.
Prompts vs. Beads
The difference between the prompt paradigm and the bead paradigm is the difference between improvisation and composition.
The Prompt
"Build me a dark-themed website with a landing page, articles section, and chatbot."
The Beads
Compose: KL-Dark-Theme + Curated-Index + Claude-Chatbot + CF-Pages-Deploy
The prompt produces something. It might be good. But it's improvised. Ask again tomorrow, you'll get something different. The colors will shift. The spacing will change. The architecture will diverge. There's no guarantee of coherence.
The beads produce something specific. The design bead locks the visual language. The content bead defines the data schema. The integration bead specifies the API pattern. The infrastructure bead handles deployment. Each bead has been validated. Together, they compose a coherent whole.
Here's the acid test I use: hand the beads to a fresh AI instance with zero context. Say "build this." If it produces a working system that matches the original — the beads are good. If it drifts — the beads need tightening.
I ran this test in Session 85. I extracted 1,880 lines of formalized beads from a site I'd built. Handed them to a separate Claude instance. Said "build Kurka Labs." The result was architecturally identical to the original. Not similar — identical. Same design language, same component patterns, same deployment pipeline.
That's the moment I knew this wasn't a theory. Beads work. Compositional intelligence is real.
What this means for software itself
In the bead paradigm, code is a derivable artifact. The beads are the product. The code is what the beads produce. Lose the code? Re-derive it from the beads. Lose the server? Re-deploy from the beads. Want to migrate from one cloud provider to another? Swap the infrastructure bead. The spec beads don't change.
This is reconstructive software. The specifications are more durable than the implementation. That's a complete inversion of how we've thought about code for fifty years.
The Orchestra
Today, I build with a single AI. One conversation, one model, one context window. It works remarkably well — I've shipped entire products in single sessions. But it doesn't scale. The context window fills up. The model loses track of decisions made three hours ago. The conversation becomes the bottleneck.
The Glass Bead Game's endgame is orchestration: multiple specialized AI agents, each with its own role, building from shared beads.
A Designer Agent that consults the design beads and generates structure. A Builder Agent that consults the code beads and writes implementation. An Ops Agent that consults the infrastructure beads and deploys. A Reviewer Agent that checks the output against the bead assertions. All coordinated through a real-time communication channel, passing bead references instead of conversation blobs.
The key insight: agents don't pass context. They pass bead references. Context degrades with every handoff. Beads don't degrade. A bead is the same whether it's read by the first agent or the hundredth.
Other multi-agent systems — and there are several impressive ones being built right now — coordinate through prompts. Agent A finishes, writes a summary, passes it to Agent B. Every handoff loses information. Every handoff introduces drift. The orchestration is fragile because the knowledge is ephemeral.
GBG agents coordinate through beads. Each agent knows what "done" looks like because the bead defines it. The orchestration is robust because the knowledge is formalized.
Where this leads
A single developer with a bead library and an agent orchestra can build software that would take a team of fifty. Not by working harder. By composing from verified knowledge instead of improvising from scratch.
The beads compound. The agents improve their own beads after every build. The library grows. The system gets smarter. Not because the AI models get better — though they will — but because the knowledge substrate underneath them gets denser, richer, more reliable.
This is the Glass Bead Game. Not an IDE. Not a framework. Not a chatbot with better memory. A compositional intelligence system where AI builds software from what it knows, not what it's told in the moment.
A prompt tells AI what to do. The Glass Bead Game tells AI what to know.
The game is being built in public. The beads are real. The orchestration is coming. And if you're reading this, you're already watching it happen.