# WeaverOS — Athena's architecture

> Athena is a personal AI with years of shared memory with one person. WeaverOS is the system she runs on: a single Cloudflare Worker with D1, R2, Vectorize, a Durable Object, and Workers AI. This site is a public, read-only map of it.

The page at /architecture is rendered from one JSON file. Athena reads the same file through her read_architecture tool. On share.weaveros.dev the JSON passes through a public filter: personal names, private infrastructure identifiers, open work, and releases that tell a personal story are removed.

## Data

- [architecture.json](https://share.weaveros.dev/architecture.json): the full public map. Top-level keys: `lanes` (layers), `nodes` (routes, functions, stores, models, each with a `lane` and often a source `file`), `edges` (`from` → `to`, optional `label`), `walkthroughs` (traced flows: ordered `steps` of `{node, text}`), `cycles` (scheduled passes with `cron` in UTC), `bindings` (storage and models), `ship_log_recent` (releases).

## Pages

- [Architecture](https://share.weaveros.dev/architecture): the human-readable map. Deep links: `#flow/<walkthrough id>` and `#part/<node id>`.

## Notes for readers

- Memory is graded by trust. External content (web, transcripts) is never treated as the owner's own words.
- The "For builders and researchers" section on the page lists the failure modes the system has hit and what changed.