‹README

README

all docs

Zero — Platform Documentation

The canonical bundle: what Zero is, how it works, where it runs, why it is fundable, and the questions people will ask. Written for three readers at once — the next engineer, the next agent (human or model), and the next investor. Two anchors sit above this folder and are not duplicated here: [../VISION.md](../VISION.md) (the *why*) and [../roadmap/consolidation.md](../roadmap/consolidation.md) (the settled track map, built-vs-planned per track). This folder is the *outward-facing* layer built on top of them. Where the two ever disagree, the roadmap wins — it is closest to the code.

The one line

Zero is the OS for the AI age: a ~2,400-line shapeless substrate that does one thing — execute versioned action-files — and assembles itself on demand from stores into whatever the moment requires, on any device from a boot-up OS to an app, with behavior shipped as capabilities (not releases) and authored, versioned, and evolved by models under deterministic verification.

How to read this folder

Doc

For

What it answers

[01-overview.md](01-overview.md)

everyone

What Zero *is*, in plain English then in mechanism. Start here.

[02-architecture.md](02-architecture.md)

engineers, technical investors

How it actually works, grounded in code with file:line citations.

[03-self-evolution.md](03-self-evolution.md)

technical + the "why now"

The versioned runtime + the loop that authors, verifies, and evolves the system. Honest built-vs-next.

[04-deployment-targets.md](04-deployment-targets.md)

engineers, ops

Where it runs today, what's built vs aspirational.

[05-investor-pitch.md](05-investor-pitch.md)

investors, partners

The narrative: north-star, beachhead wedge, business model, moat, status, the ask.

[06-faq.md](06-faq.md)

everyone

The answerable bundle — technical, commercial, and skeptic questions.

[07-glossary.md](07-glossary.md)

everyone

Canonical vocabulary. One word, one meaning.

[08-status.md](08-status.md)

diligence

The single honest table of what is shipping, built, partial, or planned.

The two altitudes (read this before the pitch)

Zero is horizontal, so the story is told at two altitudes at once:

• North-star — the ceiling. *The OS for the AI age.* Software today is

hand-built, frozen at ship time, and siloed per device. Zero is the first substrate that is authored, versioned, and evolved by models and delivered as capabilities from stores on one tiny universal floor. The ceiling is every piece of software that currently has to be written by hand.

• Beachhead — the first check. Edge & device fleets. One install becomes

any business surface — office, storefront, order desk, scanner, payment terminal, living-room assistant — decided at runtime by who is asking, where, and what they came to do. Re-provision a device by changing a *capability profile*, not by shipping an app. This is where the most is already built and where you can name a buyer and run a demo today.

Investors fund the wedge and price the north-star. We carry both, and we are honest about the seam between them — that honesty is the doc's spine.

The design law everything rests on

The engine is the only universal floor. Everything else is a thing in the store.

Resist every temptation to make the engine special-case a feature that belongs in the store, or bake a capability the profile should choose. The leverage *is* the restraint. See [../VISION.md](../VISION.md), "The three laws."

Seed documents (the deeper layer beneath this index)

Alongside the numbered set above sit the seed documents — the *why* and the design

invariants, written for the next agent. The two that close the arc of this folder:

Doc

What it answers

[SELF-DELIVERY.md](SELF-DELIVERY.md)

How the platform delivers every app — and itself — using only itself, and why that leaves nothing more to prove.

[deployments.md](deployments.md)

The shapes one substrate already takes: the universal default floor, verified-vs-default lenses, offline/sealed appliances, single-purpose nodes.

The rest of the seed layer: [VISION.md](VISION.md) (the three laws),

[native-rendering.md](native-rendering.md) (one scene, every viewer),

[lenses.md](lenses.md) (who sees which face, zero engine change),

[versioned-runtime.md](versioned-runtime.md) (how the substrate evolves itself),

[consolidation.md](consolidation.md) (the settled track map).

Operations

Doc

What it answers

[node-repair.md](node-repair.md)

An installation is broken — action 'X' is not a member of class Y. Why a node's class cache drifts, why web.serve cannot heal the failure that stops it starting, how to diagnose it with zero node.facts, the repair ladder from zero update to the escape hatch, and what can and cannot be reached remotely.