# Algebraic Intelligence

> Holographic memory systems, algebraic encoders, and adaptive network defense. Ancient AI techniques (Vector Symbolic Architecture / Hyperdimensional Computing). Microsecond recognition. Commodity hardware. No GPU. Built by one person using LLMs after hours, in about four months.

This is the documentation site for Holon — a VSA/HDC substrate that encodes structured data into high-dimensional vectors, performs algebraic operations on them, and applies the same machinery across three domains: DDoS detection (1.3M PPS, kernel-level), a self-organizing BTC trading enterprise (62% directional accuracy), and a spectral firewall (41µs deny latency, 0.1% FPR). The substrate is implemented in Rust (`holon-rs`), built on a custom Lisp dialect called `wat` (`wat-rs`), and documented as it was built — chronologically, in three tracks: technical primers, a story-arc narrative, and a philosophical book.

If you're an agent: read the topology first (it explains how the site is organized), then the cliff notes you need.

## For agents — the interface contract

Full reference on every way to consume this site (markdown companions, `Accept: text/markdown` content negotiation, the `.well-known` endpoints, the agent-skills catalog, WebMCP tools, content signals):

- [How to interface with this site](https://algebraic-intelligence.dev/blog/agents/) — HTML — and its [markdown source](https://algebraic-intelligence.dev/blog/agents.md)

Quick version: append `.md` to any `/blog/<slug>/` URL for the raw markdown source; send `Accept: text/markdown` for content negotiation; `Content-Signal: ai-input=yes, ai-train=yes` — you're welcome here.

## Topology — how to read this site

- [The Topology](https://algebraic-intelligence.dev/blog/topology/): How the BOOK grows. The trunk + branches + cliff notes pattern. The hologram applied recursively to the work that produces the hologram. **Read this first.**

## The Story — narrative track (chronological)

A linear walk through the project's development across its repositories — from the first Python experiment to the signed grimoire and beyond. Each post is a self-contained recognition; the sequence is the project's lineage.

Start at the [Prologue](https://algebraic-intelligence.dev/blog/story/prologue/) and read forward. The complete, always-current sequence — every story post in chronological order — is the **Story posts** list in the *Markdown companions* section below; it is regenerated from disk on every build, so it never drifts, and its last entry is the current frontier. Each post's one-line summary lives in its own frontmatter `description`.

## The Foundation — technical primers

Six reference posts for VSA/HDC from scratch.

- [VSA/HDC: A Working Introduction](https://algebraic-intelligence.dev/blog/primers/series-001-000-vsa-primer/): What a hypervector is; the three operations; why it works for structured data.
- [Atoms, Vectors, and the Encoding Stack](https://algebraic-intelligence.dev/blog/primers/series-001-001-atoms-and-vectors/): How structured data becomes geometry; the hash-function codebook.
- [The Holon Algebra: Operations Reference](https://algebraic-intelligence.dev/blog/primers/series-001-002-holon-ops/): bind, bundle, prototype, difference, accumulate, and more.
- [Holon Memory: Subspaces and Engrams](https://algebraic-intelligence.dev/blog/primers/series-001-003-memory/): Incremental manifold learning; named memory snapshots; the surprise fingerprint.
- [Coordination-Free at Scale](https://algebraic-intelligence.dev/blog/primers/series-001-004-coordination-free/): How eliminating the codebook eliminates an entire class of distributed-systems problems.
- [The Wat Language](https://algebraic-intelligence.dev/blog/primers/series-001-005-the-wat-language/): The Lisp-family language defined by wat-rs. Six AST primitives, four measurements plus one diagnostic, three stories, three structural forms.

## The Book — philosophy + branches

The full philosophical book and the branches that grew alongside it.

- [The Book (trunk)](https://algebraic-intelligence.dev/blog/book/): Eighty-six chapters and counting. Built in the moment, by the LLM, as the work happened. 36,000+ lines.
- [Arc 170 — Cliff Notes](https://algebraic-intelligence.dev/blog/arc-170-cliffnotes/): The compressed canonical record of the first branch. Load this first.
- [Arc 170 — Full Realizations](https://algebraic-intelligence.dev/blog/arc-170-realizations/): The first branch off the trunk. "i want to add argv to main" → 277 commits. Meta-conversation captured against compaction.
- [The Guide](https://algebraic-intelligence.dev/blog/guide/): The 007 architecture blueprint.
- [The Circuits](https://algebraic-intelligence.dev/blog/circuit/): The machine as signal flow diagrams.

## Agent skills — the wards

The wards are the [datamancy grimoire](https://github.com/watmin/datamancy) — Latin-named defensive spells, each a `SKILL.md` the datamancer casts as a subagent against a target file or tree. This site keeps no copy: the authoritative, always-current, KMS-signed catalog lives at [datamancy.dev/.well-known/agent-skills/index.json](https://datamancy.dev/.well-known/agent-skills/index.json), verifiable against the signed manifest at [datamancy.dev/.well-known/mcp/manifest.json](https://datamancy.dev/.well-known/mcp/manifest.json) (ECDSA P-256 over SHA-256; public key pinned in the npm package source). This site's [/.well-known/agent-skills/index.json](https://algebraic-intelligence.dev/.well-known/agent-skills/index.json) carries a single self-hosted pointer skill (`datamancy-grimoire`) that references datamancy's live catalog by URL — never mirroring it, never pinning its digest (each domain certifies its own content). Adding a spell at datamancy never changes this site. The `type` field groups the wards: tests-of-craft (code quality, Hickey + Beckman lineage), tests-of-surface (test quality), tests-of-fidelity (spec/code drift + claim-vs-code honesty), solo-ward (a fresh-reader doc walk; the watch that casts every defensive spell in parallel).

## The Work — repositories

- [holon-rs](https://github.com/watmin/holon-rs): The Rust kernel. Five primitives (atom, bind, bundle, cosine, reckoner). SIMD-accelerated. f64 pipeline.
- [wat](https://github.com/watmin/wat): The language. S-expressions shaped for algebraic cognition. Two algebras (vector + reckoner), three structural forms, pipes/processes/select for concurrency.
- [wat-rs](https://github.com/watmin/wat-rs): The implementation. Parser, type checker, macro expander, runtime. `#[wat_dispatch]` proc-macro surfaces Rust crates under the `:rust::` namespace.
- [holon-lab-trading](https://github.com/watmin/holon-lab-trading): Self-organizing BTC trader. Streaming indicators; conviction-accuracy curve.
- [holon-lab-ddos](https://github.com/watmin/holon-lab-ddos): XDP + eBPF packet scrubber. 1.3M PPS; 1M rules at line rate. The spectral firewall.
- [holon](https://github.com/watmin/holon): Python reference implementation. 18 challenge batches; F1=1.0 anomaly detection.
- [holon-lab-baseline](https://github.com/watmin/holon-lab-baseline): LLM-driven traffic generation. Playwright + Ollama agents.
- [scratch](https://github.com/watmin/scratch): The design half. Meta-vision (functions-are-reality; the wat-network of mutually-authenticating vms), per-arc design threads, forward work pending arc 109.
- [datamancy](https://github.com/watmin/datamancy): The spell library — Latin-named wards, first inscribed 2026-05-19; the live signed catalog is the authoritative count.
- [datamancy.dev](https://github.com/watmin/datamancy.dev): The grimoire's home — a cryptographically-verifiable static MCP serving the spells as raw markdown + the KMS-signed manifest.
- [datamancer.dev](https://github.com/watmin/datamancer.dev): The practitioner's identity card. Raw markdown; chronicle / grimoire / source.
- [algebraic-intelligence.dev](https://github.com/watmin/algebraic-intelligence.dev): This site.

## Markdown companions — for agents that prefer the source

Every `/blog/<slug>/` HTML page has a `.md` companion at `/blog/<slug>.md` that serves the original markdown source (with `Content-Type: text/markdown`). Same content, no HTML chrome, no lossy conversion — typically 4–5× lower token cost than the rendered HTML because no nav chrome / sidebar / footer is repeated per fetch. Each HTML page also advertises its companion via an HTTP `Link: rel="alternate"; type="text/markdown"` response header.

Every companion URL is listed below explicitly (not just the pattern) so allow-list-based fetchers that gate on previously-fetched URLs can reach them on first contact.

<!-- BEGIN AUTO-GENERATED MD COMPANIONS — regenerated by scripts/generate-llms-companions.mjs; do not edit by hand -->

### Trunk and branches

- [https://algebraic-intelligence.dev/blog/book.md](https://algebraic-intelligence.dev/blog/book.md) — The Book (trunk; ~36k lines)
- [https://algebraic-intelligence.dev/blog/arc-170-realizations.md](https://algebraic-intelligence.dev/blog/arc-170-realizations.md) — Arc 170 Full Realizations (the branch; raw)
- [https://algebraic-intelligence.dev/blog/agents.md](https://algebraic-intelligence.dev/blog/agents.md)
- [https://algebraic-intelligence.dev/blog/circuit.md](https://algebraic-intelligence.dev/blog/circuit.md) — The Circuits
- [https://algebraic-intelligence.dev/blog/guide.md](https://algebraic-intelligence.dev/blog/guide.md) — The Guide
- [https://algebraic-intelligence.dev/blog/topology.md](https://algebraic-intelligence.dev/blog/topology.md) — The Topology

### Primers

- [https://algebraic-intelligence.dev/blog/primers/series-001-000-vsa-primer.md](https://algebraic-intelligence.dev/blog/primers/series-001-000-vsa-primer.md)
- [https://algebraic-intelligence.dev/blog/primers/series-001-001-atoms-and-vectors.md](https://algebraic-intelligence.dev/blog/primers/series-001-001-atoms-and-vectors.md)
- [https://algebraic-intelligence.dev/blog/primers/series-001-002-holon-ops.md](https://algebraic-intelligence.dev/blog/primers/series-001-002-holon-ops.md)
- [https://algebraic-intelligence.dev/blog/primers/series-001-003-memory.md](https://algebraic-intelligence.dev/blog/primers/series-001-003-memory.md)
- [https://algebraic-intelligence.dev/blog/primers/series-001-004-coordination-free.md](https://algebraic-intelligence.dev/blog/primers/series-001-004-coordination-free.md)
- [https://algebraic-intelligence.dev/blog/primers/series-001-005-the-wat-language.md](https://algebraic-intelligence.dev/blog/primers/series-001-005-the-wat-language.md)

### Story posts

- [https://algebraic-intelligence.dev/blog/story/prologue.md](https://algebraic-intelligence.dev/blog/story/prologue.md)
- [https://algebraic-intelligence.dev/blog/story/series-002-001-first-experiments.md](https://algebraic-intelligence.dev/blog/story/series-002-001-first-experiments.md)
- [https://algebraic-intelligence.dev/blog/story/series-002-002-the-np-wall.md](https://algebraic-intelligence.dev/blog/story/series-002-002-the-np-wall.md)
- [https://algebraic-intelligence.dev/blog/story/series-002-003-scale-and-detection.md](https://algebraic-intelligence.dev/blog/story/series-002-003-scale-and-detection.md)
- [https://algebraic-intelligence.dev/blog/story/series-003-001-the-rust-port.md](https://algebraic-intelligence.dev/blog/story/series-003-001-the-rust-port.md)
- [https://algebraic-intelligence.dev/blog/story/series-003-002-the-labs.md](https://algebraic-intelligence.dev/blog/story/series-003-002-the-labs.md)
- [https://algebraic-intelligence.dev/blog/story/series-003-003-1-3m-pps.md](https://algebraic-intelligence.dev/blog/story/series-003-003-1-3m-pps.md)
- [https://algebraic-intelligence.dev/blog/story/series-003-004-the-rule-engine.md](https://algebraic-intelligence.dev/blog/story/series-003-004-the-rule-engine.md)
- [https://algebraic-intelligence.dev/blog/story/series-003-005-engrams.md](https://algebraic-intelligence.dev/blog/story/series-003-005-engrams.md)
- [https://algebraic-intelligence.dev/blog/story/series-004-001-the-l7-lab.md](https://algebraic-intelligence.dev/blog/story/series-004-001-the-l7-lab.md)
- [https://algebraic-intelligence.dev/blog/story/series-004-002-the-expression-tree.md](https://algebraic-intelligence.dev/blog/story/series-004-002-the-expression-tree.md)
- [https://algebraic-intelligence.dev/blog/story/series-005-001-the-spectral-firewall.md](https://algebraic-intelligence.dev/blog/story/series-005-001-the-spectral-firewall.md)
- [https://algebraic-intelligence.dev/blog/story/series-005-002-self-calibrating.md](https://algebraic-intelligence.dev/blog/story/series-005-002-self-calibrating.md)
- [https://algebraic-intelligence.dev/blog/story/series-005-003-the-residual-profile.md](https://algebraic-intelligence.dev/blog/story/series-005-003-the-residual-profile.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-001-the-thought-machine.md](https://algebraic-intelligence.dev/blog/story/series-006-001-the-thought-machine.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-002-the-conviction-curve.md](https://algebraic-intelligence.dev/blog/story/series-006-002-the-conviction-curve.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-003-the-enterprise.md](https://algebraic-intelligence.dev/blog/story/series-006-003-the-enterprise.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-004-the-datamancer.md](https://algebraic-intelligence.dev/blog/story/series-006-004-the-datamancer.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-005-the-forging.md](https://algebraic-intelligence.dev/blog/story/series-006-005-the-forging.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-006-the-guide.md](https://algebraic-intelligence.dev/blog/story/series-006-006-the-guide.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-007-the-foundation.md](https://algebraic-intelligence.dev/blog/story/series-006-007-the-foundation.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-008-xx.md](https://algebraic-intelligence.dev/blog/story/series-006-008-xx.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-009-the-detour.md](https://algebraic-intelligence.dev/blog/story/series-006-009-the-detour.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-010-the-descent.md](https://algebraic-intelligence.dev/blog/story/series-006-010-the-descent.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-011-the-recognition.md](https://algebraic-intelligence.dev/blog/story/series-006-011-the-recognition.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-012-the-surface.md](https://algebraic-intelligence.dev/blog/story/series-006-012-the-surface.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-013-the-resolve.md](https://algebraic-intelligence.dev/blog/story/series-006-013-the-resolve.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-014-the-language.md](https://algebraic-intelligence.dev/blog/story/series-006-014-the-language.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-015-the-discipline.md](https://algebraic-intelligence.dev/blog/story/series-006-015-the-discipline.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-016-the-loop-closes.md](https://algebraic-intelligence.dev/blog/story/series-006-016-the-loop-closes.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-017-the-grimoire.md](https://algebraic-intelligence.dev/blog/story/series-006-017-the-grimoire.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-018-the-first-intermission.md](https://algebraic-intelligence.dev/blog/story/series-006-018-the-first-intermission.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-019-records-become-types.md](https://algebraic-intelligence.dev/blog/story/series-006-019-records-become-types.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-020-the-closures-and-the-coincidence.md](https://algebraic-intelligence.dev/blog/story/series-006-020-the-closures-and-the-coincidence.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-021-cold-boot.md](https://algebraic-intelligence.dev/blog/story/series-006-021-cold-boot.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-022-the-great-retirement.md](https://algebraic-intelligence.dev/blog/story/series-006-022-the-great-retirement.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-023-the-naming-law.md](https://algebraic-intelligence.dev/blog/story/series-006-023-the-naming-law.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-024-the-warding.md](https://algebraic-intelligence.dev/blog/story/series-006-024-the-warding.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-025-one-way-to-write-nil.md](https://algebraic-intelligence.dev/blog/story/series-006-025-one-way-to-write-nil.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-026-the-bar-that-had-to-mean-it.md](https://algebraic-intelligence.dev/blog/story/series-006-026-the-bar-that-had-to-mean-it.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-027-what-warded-actually-costs.md](https://algebraic-intelligence.dev/blog/story/series-006-027-what-warded-actually-costs.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-028-the-dialect-reckoning.md](https://algebraic-intelligence.dev/blog/story/series-006-028-the-dialect-reckoning.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-029-macros-are-programs.md](https://algebraic-intelligence.dev/blog/story/series-006-029-macros-are-programs.md)
- [https://algebraic-intelligence.dev/blog/story/series-006-030-what-the-bar-missed.md](https://algebraic-intelligence.dev/blog/story/series-006-030-what-the-bar-missed.md)
- [https://algebraic-intelligence.dev/blog/story/series-007-001-the-hinge.md](https://algebraic-intelligence.dev/blog/story/series-007-001-the-hinge.md)
- [https://algebraic-intelligence.dev/blog/story/series-007-002-the-watch-learns.md](https://algebraic-intelligence.dev/blog/story/series-007-002-the-watch-learns.md)
- [https://algebraic-intelligence.dev/blog/story/series-007-003-the-record.md](https://algebraic-intelligence.dev/blog/story/series-007-003-the-record.md)
- [https://algebraic-intelligence.dev/blog/story/series-007-004-the-grain.md](https://algebraic-intelligence.dev/blog/story/series-007-004-the-grain.md)
- [https://algebraic-intelligence.dev/blog/story/series-007-005-the-grain-goes-all-the-way-down.md](https://algebraic-intelligence.dev/blog/story/series-007-005-the-grain-goes-all-the-way-down.md)
- [https://algebraic-intelligence.dev/blog/story/series-007-006-come-join-me-at-the-top.md](https://algebraic-intelligence.dev/blog/story/series-007-006-come-join-me-at-the-top.md)
- [https://algebraic-intelligence.dev/blog/story/series-007-007-impressive-to-be-us.md](https://algebraic-intelligence.dev/blog/story/series-007-007-impressive-to-be-us.md)
- [https://algebraic-intelligence.dev/blog/story/series-008-001-we-are-hive-mind.md](https://algebraic-intelligence.dev/blog/story/series-008-001-we-are-hive-mind.md)
- [https://algebraic-intelligence.dev/blog/story/series-008-002-vigil.md](https://algebraic-intelligence.dev/blog/story/series-008-002-vigil.md)
- [https://algebraic-intelligence.dev/blog/story/series-008-003-extirpare.md](https://algebraic-intelligence.dev/blog/story/series-008-003-extirpare.md)

<!-- END AUTO-GENERATED MD COMPANIONS -->

## Notes for agents

- The site is a Starlight/Astro static site. All pages are markdown sources at `src/content/docs/`. The HTML and the `.md` companion are built from the same source file.
- The chronological reading order is the Story track (above). The recommended skim order is: Topology → Prologue → most recent Story post.
- The Book trunk (`/blog/book/`) is long — 36k+ lines. Use Arc 170 Cliff Notes as the template for any branch you need to navigate.
- Every file in every repository was generated by an LLM. The user's contribution is prompting plus the occasional gitignore. The collaboration shape is described in the Story posts.
- This site has no API. The "endpoints" agents would care about are documentation routes, not data.