Worldbuilding

A worldbuilding knowledge base is a living encyclopedia of your story world. Characters, settings, themes, factions, and lore — each its own page, all linking to each other. The graph is the product: the value isn't any single entry, it's the web connecting them, and an agent that grows and guards that web as you write.

Unlike the other packs, the flow here isn't a pipeline — it's a network that thickens over time. Your job is to write scenes and notes; the agent's job is to keep the encyclopedia consistent with them.

Novelists and screenwriters lean on it to stop losing track of their own canon as the story grows. Game masters keep a navigable world bible — who controls which region, which faction hates which. Narrative-design teams use it to hold a shared setting together as more people contribute.

The folders

The pack ships templates for the shapes that recur — faction, political-faction, religion, lore, magic-system, historical-event, and the core character / setting / theme pages.

The two behaviors that make it worth it

This is where the agent earns its keep:

• Auto-stub on mention. When a chapter, session log, or existing entry names someone or somewhere not yet captured, the agent stubs a page in the right folder and backlinks it to where it came up. Your canon grows as you write, not in a separate cataloguing session.
• Flag contradictions. When a character's faction contradicts their actions in a scene, or a setting gets described two ways, the agent surfaces the conflict rather than silently "fixing" it — because in fiction a contradiction is often a plot point, not a bug. You decide whether it's a mistake or a mystery.

The scenario

You write a chapter where Kael, a member of the Iron Pact, quietly warns the people of Duskfen before a raid. You drop the scene in and ask:

The agent stubs characters/kael.md linked to factions/iron-pact.md and settings/duskfen.md — then notes that Kael warning Duskfen contradicts the Iron Pact's stated hostility toward it. Is Kael a traitor, a double agent, or did you misremember the Pact's alignment? That flag is the agent doing worldbuilding with you.

What's in your project after seeding

Pick Worldbuilding in the starter-pack picker, or run:

ok seed --pack worldbuilding

By default the pack nests under a world/ subfolder:

your-project/
└── world/
    ├── characters/
    ├── settings/
    ├── themes/
    ├── factions/
    └── lore/

Each folder's .ok/frontmatter.yml teaches the agent that entity type and its auto-stub / contradiction behavior, so the guidance never clutters the entries themselves.

Cadence

Further reading

• LLM wiki workflow. The same wiki-graph discipline, aimed at real-world sources instead of a fictional world.
• Entity vault workflow. The non-fiction sibling — track real people, companies, and meetings the same way you track characters and factions.
• Core Concepts. Links and backlinks — the connected graph you navigate the world through.
• Claude Code, Cursor, Codex. MCP-capable agent hosts.