Key Conventions

Separator

We use / as a logical separator in key names to group related documents. For example: README, README/format, README/links.

The server does not treat / specially. This is purely an organisational convention. Keys are opaque strings to the storage layer.

Root Node

The root node is stored under the empty-string key "". It serves as the bootstrap entry point for the system.

Naming Guidance

Keys should be concise and descriptive. Use lowercase where practical, except for established names like README and Future. Avoid spaces in keys — use / or - to separate words.

Brevity

Prefer many small documents over fewer large ones. Each node should cover a single focused topic. This supports fine-grained retrieval — a consumer loads only what it needs, keeping context window usage minimal.