Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

docs(announce): stop linking the ledger as if it were committed

nirholas994f110127af
diff --git a/STRUCTURE.md b/STRUCTURE.md
index 8b064d918..ee7cea83b 100644
--- a/STRUCTURE.md
+++ b/STRUCTURE.md
@@ -473,7 +473,7 @@ array. Runbook: [docs/contributing.md](docs/contributing.md#publishing-packages-
- **On-chain identity & contracts** — [contracts/](contracts), [packages/avatar-schema/](packages/avatar-schema)
- **API endpoints** — [api/](api) (serverless-style handlers, served in production by the [server/](server) Cloud Run container), [workers/](workers) (long-running workers)
- **Examples & demos** — [examples/](examples), [multiplayer/](multiplayer)
-- **Announcement pipeline**: [docs/announcements/](docs/announcements/README.md) (one pack per feature: the claim and its evidence, the postable text, the media by shot id, the Telegram variant), [data/announcements.json](data/announcements.json) (the ledger: every shipped surface, whether it was ever announced, its score and its stage), [data/announce-media.json](data/announce-media.json) (media recipes captured from the live product into `public/announce/`), [docs/announce-voice.md](docs/announce-voice.md) (the voice contract, derived from the engagement archive). `npm run announce:rank` ranks the backlog, `npm run announce:media` captures the frames, `npm run check:announce` gates a pack. Nothing here posts: publishing stays owner-gated.
+- **Announcement pipeline**: [docs/announcements/](docs/announcements/README.md) (one pack per feature: the claim and its evidence, the postable text, the media by shot id, the Telegram variant), `data/announcements.json` (the ledger `npm run announce:rank` writes: every shipped surface, whether it was ever announced, its score and its stage; generated, so it is gitignored rather than committed), [data/announce-media.json](data/announce-media.json) (media recipes captured from the live product into `public/announce/`), [docs/announce-voice.md](docs/announce-voice.md) (the voice contract, derived from the engagement archive). `npm run announce:rank` ranks the backlog, `npm run announce:media` captures the frames, `npm run check:announce` gates a pack. Nothing here posts: publishing stays owner-gated.
- **Marketing assets**: [marketing/](marketing/README.md) (produced promo videos + re-render scripts, e.g. [marketing/imessage-video/](marketing/imessage-video); source-of-truth assets, not shipped to production). The narrated product demo lives in [marketing/product-demo/](marketing/product-demo/README.md): [scripts/make-product-demo.mjs](scripts/make-product-demo.mjs) (`npm run demo:video`) films a presenter walking every feature page on the live site, chaptered, with narration from the platform's own TTS lane. Its route is the Feature Tour curriculum, so a new page is in the next recording without editing a script. Docs: [docs/product-demo.md](docs/product-demo.md)
- **Platform agents (server-side)**: [agents/](agents/README.md) (endpoint-shopper, fact-checker, tutor, unstoppable, x402-buildout: library modules imported by `api/` handlers, each with its own README)
- **Site data files**: [data/](data/README.md) (pages.json, changelog.json, skills seed, RSS items: what each file drives and which script regenerates it)
diff --git a/docs/announce-voice.md b/docs/announce-voice.md
index d58c3c5f0..7126ed886 100644
--- a/docs/announce-voice.md
+++ b/docs/announce-voice.md
@@ -142,7 +142,7 @@ pack carries:
- **The Telegram variant.** The community channel takes plain text and a different register: more
detail, no character ceiling worth worrying about, no tagging.
- **The changelog entry**, ready to paste into `data/changelog.json`.
-- **Its state**, mirrored in [`data/announcements.json`](../data/announcements.json).
+- **Its state**, mirrored in `data/announcements.json` (generated by `npm run announce:rank`, so it is gitignored; run that first if you do not have it).
## What this file does not decide
diff --git a/docs/announcements/README.md b/docs/announcements/README.md
index 6d55eda4d..443f7ee76 100644
--- a/docs/announcements/README.md
+++ b/docs/announcements/README.md
@@ -18,7 +18,8 @@ npm run check:announce # gate the pack before anyone reads it
1. **Rank.** [`scripts/announce-rank.mjs`](../../scripts/announce-rank.mjs) re-derives the
inventory from `data/pages.json`, `packages/`, `workers/` and `services/`, reads the announced
status out of the coverage audit, probes each route, scores what is left, and writes
- [`data/announcements.json`](../../data/announcements.json). The score's weights come from the
+ `data/announcements.json`. That ledger is generated, not committed, so this is the
+ command that creates it. The score's weights come from the
engagement archive, not from taste; the sources are named in
[announce-voice.md](../announce-voice.md).
2. **Capture.** Add a shot to [`data/announce-media.json`](../../data/announce-media.json) and run