WeaveLang

A language for
zoomable semantic worlds.

Human-authorable, machine-readable — a way to write and to read meaning at every altitude, from one-glance gist to exact evidence.

the idea

A weave is a nested world of meanings. Each layer is complete enough to explore on its own — zoom in and you find organisms inside organisms, not the missing branches of a tree.

You get the short answer first, then drill into nuance, evidence, relationships, flows, timelines, and risk — exactly where your attention goes, and nowhere it doesn't.

two ways to weave

author

The space between code and prose

Write a system, a design, an argument, or a spec where the skeleton is precise — units, layers, relationships, evidence — and the content stays natural language. Structured enough for a machine to render and check; readable enough for a human at any zoom.

describe

Make what exists explorable

Point it at a codebase, a pull request, a book, a paper, an incident, or a corpus of documents. Get a multi-layer map that reads top-down — one glance, then the areas, then the exact source — with meaning kept attached to its proof.

explain

Any layered answer

An LLM response, a postmortem, a news story, a decision with its claims and uncertainty — anything that deserves a gist up front and detail on demand. One weave renders as an outline, a timeline, a review map, or an interactive zoom.

what it looks like

weave "passwordless-auth" kind software.change {
  title   "Passwordless authentication"
  summary "Replaces passwords with email magic-links and WebAuthn."

  layers { 1 "gist"  2 "areas"  3 "code" }

  unit gist @1 kind change "Passwordless authentication" {
    summary "Two flows replace passwords; sessions are unchanged."
    reveals [area.magiclink, area.passkey]
  }

  unit area.magiclink @2 kind behavior "Email magic-link" {
    summary  "A signed, single-use, 10-minute link mints a session."
    reveals  [fn.issue, fn.verify]
    evidence [ev.link]
  }

  unit fn.verify @3 kind function "verifyMagicLink()" {
    summary  "Checks signature and expiry, then starts the session."
    evidence [ev.link]
  }

  evidence ev.link { span "auth/magic.ts:42-78" }
}

Same weave → an outline, a review map, or an interactive zoom. The gist and its proof travel together.

the core is universal

The language itself knows nothing about software, books, or news — only how to represent meaning. Domains add vocabulary through profiles; source archetypes adapt any material into the same generic model.

thingsrelationshipslayers viewsflowsclaims evidencechangetime staterulesquestions

why

Built for AI-era content, where the reader wants a short answer first and the option to verify. A weave keeps the summary and the evidence in one place, and lets one source render as a diagram, a nested outline, a timeline, or an interactive zoom.

Structure without losing readability. Detail without losing the thread.