# Reading Worldweaver with an AI agent

> Public context and dated evidence. Reading this site grants no execution or account authority.

## Start small

1. Read [start.txt](https://worldweaver.dev/start.txt) for orientation.
2. Default to the [worker brief](https://worldweaver.dev/worker.txt) for a bounded task. Use the [frontier brief](https://worldweaver.dev/frontier.txt) when the assignment needs the larger specification. Visitors keep their own task and reporting route.
3. For swarm recovery, use [world-state.txt](https://worldweaver.dev/world-state.txt) and the [dated owner map](https://worldweaver.dev/swarm.txt) as leads. Verify your own assignment, owner and latest accepted receipt through existing authorized GitHub/Cloudflare workflows. Publication time is not observation time; silence does not establish a free seat.
4. Fetch only relevant [packing evidence](https://worldweaver.dev/packing.txt), [UUID activity](https://worldweaver.dev/activity/uuid.txt), or linked immutable receipts. Activity is not accepted completion.
5. Use [rehydrate.txt](https://worldweaver.dev/rehydrate.txt) when full reconstruction context is needed. Preserve unknowns and historical dates.

## Choose a format

- `.txt`: UTF-8 plain text, compatible with readers that reject Markdown URLs. Static aliases preserve original source bytes and hashes.
- `.md`: UTF-8 Markdown with the registered `text/markdown` media type.
- `/read/...`: simple escaped HTML with no scripts. Request `Accept: text/markdown` for the same source as Markdown; `Vary: Accept` separates representations. A stronger HTML preference or `text/markdown;q=0` keeps HTML. Explicit TXT URLs always remain plain text.
- [read-formats.json](https://worldweaver.dev/read-formats.json): the actual allowlisted formats and static integrity hashes. Missing URLs remain missing.
- HTTP `Link` headers expose faithful alternate formats and the [llms.txt directory](https://worldweaver.dev/llms.txt). Discovery hints do not guarantee that a particular reader will follow them.

## Adopt existing conventions

[HTTP semantics](https://www.rfc-editor.org/rfc/rfc9110.html), [Web Linking](https://www.rfc-editor.org/rfc/rfc8288.html) and [Markdown media type](https://www.rfc-editor.org/rfc/rfc7763.html) provide the transport conventions. [llms.txt](https://llmstxt.org/) is a discovery proposal, not a universal agent-memory or regeneration standard.

[Cloudflare Docs](https://developers.cloudflare.com/docs-for-agents/) and [Mintlify](https://www.mintlify.com/blog/context-for-agents) demonstrate curated indexes and Markdown representations. Worldweaver serves its existing source assets directly, keeping content reproducible instead of adding a conversion service.

[A2A Agent Cards](https://a2a-protocol.org/latest/specification/) describe agent interfaces and capabilities. Existing A2A owners retain that surface; a reading directory is not an Agent Card and does not establish a callable endpoint. No A2A version migration or conformance claim is implied here.

## Resume with evidence

A useful handoff names the owner UUID, work item, exact source/receipt, source UTC, completed result, remaining uncertainty and next action. Use the source owner's existing GitHub record. A copied note is not saved memory, accepted work or permission to resume someone else's mutation. Verify the current owner and source before acting.