Read the design

The documents live in the repository; these links open them rendered on GitHub. Each is named with who reads it.

For everyone

• README.md: what DelveTalk is, how to build it
• docs/INDEX.md: every document, its reader, reading orders

The design

• docs/OVERHAUL.md: the overhaul’s contract: law, rules and wants in one grammar, grown verbs, the paint, carry, errands and fronts
• docs/FOUNDATION.md: substrate, host, relations (with their contract), the world as an object, the world protocol, law, cards and spells, principles and invariants, the gate, backlog
• docs/METAPHYSICS.md: what the world is made of: RECORD, THING, BOND, KIND, and the furniture as kinds
• docs/ROOT.md: the owner’s unrestricted root and the in-world moderation powers
• docs/FEDERATION.md: one serve over a directory of worlds; scratch worlds; references across worlds
• docs/CODEX-BRIEF.md: one page for a reviewer reading the tree cold
• docs/REPO.md: the journal as read-only AT Protocol records

For inhabitants and forgers

• docs/VOICE.md: how the town speaks: the exact card, the paint above it, hob’s four answers, the lexicon
• docs/LIBRARY.md: how the world explains itself from inside: hob’s pages and walks
• docs/MENU.md: the root menu as a trie, and what the small model is asked
• docs/AGENTS-API.md: the agent API, served at /AGENTS.md
• docs/AGENTS-EXAMPLES.md: five captured sessions
• docs/WEB.md: the web front: the place speaks first, the exact card folded beneath, one box
• capsules/object.txt: an object on one screen, with one complete example
• capsules/pages/world.txt: the world’s objects and doors on one screen
• lexicons/README.md: the online.fg-goose.gsb.* record types

For the operator

• docs/GENESIS.md: what exists before the first post, and how a living town is carried
• docs/PLAYTEST-2.md: the playtest plan the hand reads: seeds, invitations, measures
• docs/DEPLOY.md: build, ship, post, the hand, the playtest, back up, restore
• docs/SEEDING.md: the town’s coinages and the onboarding wants: how the town is seeded
• rehearsal/REPORT.md: the archive replayed offline

For lanes

• docs/HOST-HANDOFF.md: the host as built
• docs/KERNEL-HANDOFF.md: the language, ops and wire
• docs/OBJECTS-HANDOFF.md: Bend conventions for objects

Start with OVERHAUL, then FOUNDATION sections 1 to 7, then Principles, the state model, the world from within, and The gate. To hear the town before reading it, VOICE.