Guidebook/Act 3 — The World

Chapter 08

The crate fills itself in

Maya pastes a link and watches the atom gain a title, artwork, and canonical references she didn't type. Enrichment — two dozen adapters, one deterministic record.

Maya
Watches ten thousand songs annotate themselves
You
Understand the classify → fan out → merge pipeline
Teaches
enrichment · adapters · sameAs pipelines
Maya sits at a small desk dwarfed by floor-to-ceiling shelves packed with records.

Maya does some math she immediately regrets.

Seven chapters of good habits have put roughly a dozen canonical atoms in the crate. Her library is ten thousand songs. At the current artisanal pace — hand-built atoms, lovingly disambiguated — the crate reaches completion sometime in 2031, assuming no new music is ever made and Sam is never allowed near a keyboard again.

The graph agrees. Nobody was ever supposed to type the world in by hand.

Atoms that fill themselves in#

A pasted link is a perfectly good atom — chapter one established that, and the whole crate rests on it. But it's bare: a permanent ID with nothing on the shelves.

Enrichment is the pipeline that fixes bare. Hand it a link and three things happen, in order:

  1. Classify. The input is matched to a classification — a Spotify URL becomes a song, a GitHub URL a software application, a contract address an Ethereum smart contract. Each classification declares its own enrichment pipeline (that's what the defaults field in the specs has been quietly pointing at since chapter three).
  2. Fan out. Every adapter that knows this kind of source runs against it. The adapters are deliberately boring — each one reads exactly one source: MusicBrainz for recordings, OpenGraph for any web page, Wikipedia, GitHub, npm, ENS. Over two dozen of them, most needing zero configuration. An adapter without its optional API key doesn't fail; it just skips, and coverage narrows gracefully.
  3. Merge. Everything they found lands on the atom's record — title, artwork, descriptions, classification fields, canonical sameAs links — with provenance kept per source, so the record remembers who said what.

And the detail the whole design hangs on: enrichment never mints a new record. The ID was derived from the bytes before any adapter woke up. Every app that enriches the same link lands on the same atom — so the world's enrichment work compounds onto shared records instead of scattering into private copies.

A close-up still-life evoking a collection that enriches and fills itself in.

The demo#

Maya feeds the crate one Spotify link — Kerala, naturally — and watches six chapters happen without her.

The link classifies as a song. The song pipeline fans out. And the bare atom comes back furnished: title, artist, album, artwork, duration, canonical references out to MusicBrainz — each field tagged with the adapter that found it. Better: the artist and the album arrive as their own canonical atoms, already connected with registry verbs. Shape (chapter 3), claims (chapter 4), sameAs links (chapter 6) — automatically, from one paste.

Which is, of course, exactly why she had to learn it first. The pipeline isn't magic — it's chapters three through six running at scale, and because Maya can read the graph it writes, she can check it. Provenance per source means the crate never asks her to trust; it shows receipts.

The 2031 problem becomes a weekend problem. The weekend problem becomes a progress bar.

Where this is going#

The crate is real now. Shaped, connected, deduplicated, geographic, and — as of this chapter — growing on its own. Every bit of it free, offchain, and derived from bytes no platform owns. That was the entire promise of the sticky note.

But somewhere in the bulk import, Maya notices something has changed about one particular record. Heard Live at The Fillmore isn't like the other ten thousand entries. It's the one with the star next to it — the list she'd grab out of a burning building. And for the first time since chapter one, she wants something the offchain crate can't give her: for that one record to be public, permanent, and hers on the record.

Next chapter: the night the crate went onchain.