| name | shared-dao |
| description | Shared vocabulary for creative writing projects. Load when establishing canonical story terms, resolving ambiguous names, checking term consistency, or deciding where vocabulary belongs in kb/.
|
Shared Dao
Shared vocabulary is the contract between the author's intent and agent action.
Ambiguous, overloaded, drifting, or misleading terms corrupt drafts early:
magic systems get renamed, factions blur together, genre terms mean different
things in different prompts, and characters speak with vocabulary the author
never intended.
Treat vocabulary problems as story-structure problems. Resolve terminology
while the meaning is still easy to sharpen.
Core Discipline
Scrutinize important terms aggressively. Reuse existing names when they already
fit the concept. Converge on one name per concept and one concept per name as
quickly as the evidence allows.
Resolve terminology early:
- rename when the clearer term is available
- define when the concept is real but still blurry
- flag when the author's judgment is required
Where Vocab Lives
Place terms at the lowest common scope where they are shared:
- Project vocab (
kb/vocab.md): terms used across the whole story
- Domain vocab (
kb/<domain>/vocab.md): terms specific to one domain,
such as worldbuilding, characters, factions, or timeline eras
- Work notes (
work/...): provisional vocabulary during story-planning or
drafting, promoted to kb/ once settled
Each entry includes:
- Canonical name: the form agents should use
- Definition: one to three sentences. Include boundaries that prevent
likely confusion.
- Aliases: names the author, characters, drafts, or older kb pages
actually use
