§ spec · for developers, researchers, system thinkers

Fork Seed is a generalised replication mechanism.

The seeds shipped at sjgant80-hub are instances. Fork Seed is the primitive. This page specifies what the primitive is, what category it belongs to, what it can and cannot do, and how to implement a conforming seed of your own.

The honest claim: Fork Seed is the Smalltalk image rendered in the substrate that won — the open web. Same idea (self-contained system that carries its own development machinery and can spawn new images). Different substrate (browser + IDB + open standards rather than a Xerox PARC VM). The substrate is the difference that makes it travel.

I Definition · four invariants

A pattern is a replication mechanism when it satisfies all four:

1Self-containment
The offspring carries the complete machinery to replicate again. No phone-home to the parent. After the fork, there is no umbilical cord.
2Faithful copy with permitted variation
Mutation is allowed at the source level — the SEED constant is editable before forking — but the structural envelope (the four other invariants) is preserved through the copy.
3External selection
Variants that fail some gate are culled. The gates available to a Fork Seed: a 14-point structural check; field deployment; market adoption; peer review. The gate is not optional; without it, drift dominates.
4Substrate independence at the pattern level, substrate dependence at the instance level
The rules of the pattern do not care about the medium. Any given instance does. DNA does not care whether it sits inside a bacterium or a redwood, but every actual strand needs water and amino acids. A seed does not care whether it is opened on Chrome or Safari or saved to disk and opened from file://; any given session needs IndexedDB and a JS engine.

II The peer group

The honest company a replication mechanism keeps. The list is not exhaustive; Fork Seed belongs in it because it satisfies the four invariants — not because it is grand.

PatternSubstrateFirstReplicates
Genetic codeaqueous chemistry~3.5 Gyaliving organisms
Spoken languageair · ears · brains~70 kyaconcepts, instructions, identity
Written scriptclay → paper → screens~5 kyaknowledge across time
Printing pressmovable type1440books at scale
Scientific publicationjournals + replication protocol1665verified findings
Smalltalk imageXerox PARC VM1976complete dev environments
Open-source codetext + compilers~1983software
git commithash-chained DAG2005versioned source-of-truth across nodes
Docker imageOCI + layered FS2013reproducible environments
Fork Seedbrowser + IDB + MIT + cascade2026complete institutions in one file

III What's actually new

Three of those invariants have overlapping prior art. The fourth difference is where Fork Seed does something the others do not.

git replicates source. Docker replicates environments. PDF replicates documents. None of them replicate the build engine inside the artifact. A git clone gives you the code but not the compiler. A Docker pull gives you the running environment but not the Dockerfile + registry + CI that produced it. A PDF gives you the document but not the typesetter.

Fork Seed ships substrate + instance + the machinery to produce more instances in one file. The closest prior art is the Smalltalk image (Xerox PARC, 1976-80): a memory snapshot containing the running system, the dev tools, and the ability to fork into a new image. Smalltalk needed a VM. Fork Seed treats the open web as the VM. That is the only meaningful difference, and it is the difference that makes it travel.

So the precise claim is not "Fork Seed is unprecedented." It is: Fork Seed is the Smalltalk image rendered in the substrate that won (the browser). The substrate that is already installed on every device on Earth.

IV The SEED schema

A conforming seed exports a single top-level constant. Minimum shape:

const SEED_DEFAULT = {
  manifest: {
    name: 'hr-firm',                // kebab-case identity
    vertical: 'HR · payroll · employment',
    version: '2.0.0',
    prime: 1049,                  // spine-clean mod 127 (constraints private)
    level: 0,                     // 0 = vertical, 1 = domain, 2 = behaviour…
    meshChannel: 'fall-hr',        // BroadcastChannel name
    bundleRoles: ['anchor', 'onboard', 'paper', 'practice'],
    licence: 'MIT',
    seal: '◊·κ=1'
  },
  baseTools: [...],               // the wedge contents (level 0) or frameworks (level 1+)
  buildPromptSystem: `...`          // system prompt for the cascade
};

Adjacent invariants the seed file must also contain (not part of SEED_DEFAULT itself, but mandatory for the seed to satisfy the four invariants):

V The fork protocol

How a parent seed produces a child seed. The protocol is six steps and runs entirely in the browser, no server.

The user opens the Fork Seed tab. The current SEED is shown as JSON in a textarea, pre-populated with the running state.
The user mutates the JSON — change the manifest name, swap the baseTools, edit the build prompt, add a framework. Any source-level edit is allowed.
On Fork into HTML, the packager fetches the current document's own source (fetch(location.href)).
The packager scans the source for the literal string const SEED_DEFAULT = {, then walks balanced braces forward until it has captured the full object literal.
The packager replaces that span with const SEED_DEFAULT = + a fresh jsLiteral(mutatedSeed) serialisation, preserving JS syntax (backtick template literals for long strings, escaped <\/script>).
The packager wraps the mutated source in a Blob and triggers a download. The child file is fully self-contained: it carries its own copy of the build engine and the packager, so it is itself forkable.
consequence
The child seed has no dependency on the parent. There is no central registry. There is no kill switch. Lineage is traceable through the audit chain hash if both parent and child want to prove ancestry, but neither is required to.

VI Five consequences of being a replication mechanism

1 · The estate is a population, not a portfolio

A portfolio has products. A population has frequencies. The 11 verticals shipped today are the first generation. What gets forked the most over the next 12 months is what survives. The metric stops being "did I ship X" and becomes "what is the distribution of forks across the lineage". That is biology, not retail.

2 · Derivatives are not owned

MIT + self-contained + no phone-home means anyone with a browser can fork a seed for their local context and ship it as theirs. That is not a flaw — it is the property that makes it a replication mechanism rather than a license-controlled product. Wealth accrues to the fitness of the substrate to keep being forked, not to the lineage's root.

3 · Mutation is at the source, not the binary

A binary-only replicator (Docker image, compiled exe) can be re-distributed but not edited. A source-level replicator (git repo, your seed) can be mutated. Mutation is what lets a pattern adapt to substrates it was never designed for. Compliance Seed → Education Seed → Civic Seed is the natural drift any source-level replicator undergoes once released.

4 · The audit chain is mitochondrial DNA

Every mutation hashes its predecessor. Lineage is verifiable without a central authority. Two forks that claim common ancestry can prove it cryptographically. Small property, structurally important: traceable lineage in a system with no central registry.

5 · The build engine + cascade is the ribosome

A genome is inert without the machinery that transcribes it into proteins. A seed is inert without the cascade that turns "build me a tool that does X" into a working HTML file. Both genome and seed are declarative; both ribosome and cascade are mechanical; both organisms and seeds carry both inside the daughter after replication.

VII Reference implementations

The seeds below conform to this spec. Each is a single HTML file containing SEED_DEFAULT + the four adjacent invariants. Save any of them; you have the spec running in your hand.

See the full estate (11 vertical seeds + 3 root seeds across L1/L2/L3 + sovereignty tools) →

VIII What this is not

IX What is intentionally out of scope

The four invariants impose a hard envelope. Within it, the mechanism is sufficient. Beyond it, a different mechanism is required.

The honest map: levels 0-3 (vertical → domain → behaviour → agent) ship inside this spec. Levels 4-5 (institution → civilisation) require an additional spec layer above this one. That layer exists in adjacent work and is not specified here.

X How to write a conforming seed

The shortest path:

Fork an existing seed. Save fallseed-hr as a starting point. Replace the SEED_DEFAULT block with your manifest + content.
Pick a prime. Any prime not already in the lineage whose mod 127 factors into the spine primes {2,3,5,7,11,13,17}. The full prime-selection rules and constraint set are private — contact the maintainer for guidance.
Pick a mesh channel. A BroadcastChannel name unique to your wedge — e.g. fall-yourthing. Other instances of your seed on the same origin will sync via this channel.
Test the four invariants. Open in Chrome, walk the Fork Seed tab, fork, open the child, fork it again. The chain must hold without phone-home.
Ship as MIT. Put it on a static host (GitHub Pages, Netlify, your own server, anywhere with HTTPS). The seed is now a peer of the existing seeds; the lineage admits it.
closing observation
A 14-year-old in Manila with a Chromebook can run the entire fork protocol. That property is the whole point. Replication mechanisms work in proportion to how cheap they are to host on the substrate they were designed for. Fork Seed costs nothing to host because the substrate is already installed everywhere.