The Guidebook

Learn the graph
by building one.

Follow Maya — a collector teaching her music library to remember itself. Every chapter takes one real piece of the stack and turns it into part of her collection: songs become atoms, playlists become graphs, venues become places her taste has an address. You build alongside her, with real code, the whole way.

10 of 10 chapters published · new chapter weekly Start Chapter 01 →
Act 1

The Collection

Chapter 01 Ten thousand songs, zero structure Meet Maya. Fifteen years of playlists, three dead platforms, one rule for the app she's finally building herself — and the one-line function that makes her collection permanent. atomsdeterministic IDs@0xintuition/ids 4 min · read now →
Chapter 02 What is a song, officially? Maya's homemade strings collide with a stranger's — same song, different atoms. The fix is fifteen years of settled vocabulary she didn't have to invent, and a superset that keeps the receipts. schema.orgvocabulary@0xintuition/schema-org 4 min · read now →
Chapter 03 The fields worth filling A MusicRecording has over a hundred possible properties. Maya needs the three that matter. Classifications draw the ring — required, recommended, available — and her atoms become canonical JSON-LD. classificationscanonical shapes@0xintuition/classifications 3 min · read now →
Act 2

The Connections

Chapter 04 First claims Songs are atoms; taste is triples. Maya connects Kerala to Bonobo and to a genre using verbs from the shared registry — and discovers her claims are legible to apps that have never heard of Crate. triplespredicates@0xintuition/predicates 3 min · read now →
Chapter 05 Playlists are graphs The "Heard Live" list, reborn as triples. Lists, stacks, and rankings of your favorite things turn out to be the same three-part shape — and this time, no platform can take them away. listslistedIncuratedBy 3 min · read now →
Chapter 06 Two copies of the same song Maya's friend joins Crate and promptly duplicates half her library. The fix — canonical sameAs written at creation time — is the difference between a shared graph and a million private ones. sameAsconvergencecanonicalization 5 min · read now →
Act 3

The World

Chapter 07 The Fillmore, as data Venues, shows, and the geography of taste. Maya gives the places she's heard music real addresses in the graph and pins songs to the nights she heard them. placeseventslocation classifications 3 min · read now →
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. enrichmentadapterssameAs pipelines 4 min · read now →
Chapter 09 The night the crate went onchain One list earns real conviction. Maya publishes it — same bytes, same IDs, nothing migrates — and her record gains a market, an address, and a permanent home. onchainMultiVault@0xintuition/protocol 3 min · read now →
Chapter 10 Other people's hands in the crate Strangers start endorsing Maya's list — and one of them disagrees about the genre. Multiplayer records, staking, and counter-claims: the graph becomes a conversation. multiplayer recordsendorsecounter-triples 4 min · read now →