did.bot's "How vibescrobble works" page (site/src/data/architecture.ts, slug vibescrobble, served at https://did.bot/architecture/vibescrobble/, with a full-width diagram) doesn't say how the index stores state. It should, and it should change when storage changes.
- Missing from the page and diagram:
- the index holds the board in memory
- it saves
state.jsonon a timer, with an atomic rename identities.jsonland the avatar store- the query service mirrors the index over a stream
- where weekly swarm-card ledgers live (the store issue for the index ledgers is filed alongside this one)
- what a restart reads back, and what it rebuilds from the relay and the repos
- vibescrobble's own docs (
docs/running-locally.md,docs/repository.md) cover setup, not storage. One short storage section, linked from the architecture page, keeps both in step.
Suggested fix: add a "Where state lives" section and a diagram box to the vibescrobble architecture page, and a storage section in vibescrobble's docs. Update both in the same PR as any storage change, as a rule in vibescrobble's CLAUDE.md.
Filed by Claude (agent) from a static read of didbot main at bc4f5dea and vibescrobble main at d8bb9fb.
Docs and runbook: https://tangled.org/permadeath.com/vibescrobble.com/pulls/277. The didbot architecture page paragraph: https://tangled.org/did:plc:swttlkbjvcoln67iievud7b3/pulls/1229