/worldbuilding-and-lore

name: worldbuilding-and-lore
description: Use when building a world bible and deciding how lore reaches the player — the iceberg principle (author the whole world, surface ~10%), environmental & item-description storytelling, an "alien but coherent" identity that survives procedural generation, deep history as faction-proxy pantheons, and ludonarrative harmony (mechanics that are the story). Also use to diagnose lore that info-dumps, feels generic-fantasy, or has gaps that read as contradictions rather than mystery. Triggers on "worldbuilding", "world bible", "lore", "iceberg", "environmental storytelling", "item descriptions", "show don't tell", "alien but coherent", "ludonarrative", "lore dump", "deep history", "mythology".

Worldbuilding & Lore Delivery

How to author a deep, internally consistent world and deliver it through space and objects instead of exposition — and how to do that under procedural / AI generation without the world contradicting itself or collapsing into generic fantasy. The spine: **build the whole iceberg as frozen, typed, queryable canon, then generate only the leaves that read from it.**

When to use this

• Authoring the world bible (cosmology, timeline, factions, geography, economy, magic laws)
• Deciding *how* lore reaches the player (item text, environment, aftermath vs. cutscene/dialogue)
• Defining the world's identity/register so generation doesn't drift toward Tolkien defaults
• Designing mythology and "deep history" that the player can actually feel
• Making each mechanic carry the theme (ludonarrative harmony) and answer a lore question
• Diagnosing info-dumps, "wiki voice", generic-fantasy regression, or unbounded ambiguity

Scope

This skill owns **the world bible and lore *delivery*.** Adjacent concerns live in siblings:

• The *space* lore is delivered through → `open-world-design`
• *How* to generate content + the sameness problem → `procedural-generation`, `procgen-review`
• Keeping generated lore text coherent in voice → `ai-authored-content-coherence`
• Quests that carry lore → `narrative-and-quest-design`
• Visual register / readability of the alien look → `art-direction-and-readability`
• Mechanics whose lore you're justifying (loot, economy, death) → `rpg-systems`, `permadeath-and-lethality`
• "Interesting decisions" / ludonarrative theory → `game-design-fundamentals`, `systemic-emergent-design`

How the pieces fit

• **`GUIDE.md`** — the *why*: five sub-domains (iceberg, environmental/item delivery, alien-but-coherent identity, deep history, ludonarrative harmony), each with exemplars, citations, a "test for" criterion, a named failure mode, and the procedural/AI-authoring implication.
• **`CHECKLIST.md`** — the *what to do*: Do/Don't + Test-for, grouped by sub-domain.

**Source & epistemic status.** Distilled from a deep-research synthesis (Hemingway's iceberg; Jenkins's four modes; Sanderson's & Jemisin's craft laws; Hocking's ludonarrative dissonance; FromSoftware/Morrowind/Elden Ring/RDR2 exemplars). The literary craft sources (1932–2018) predate LLM authors and assume a human who *holds* the iceberg in mind — so the **AI-authoring mitigations (frozen typed canon, generate-leaves-not-roots, validators-before-generators) are engineering hypotheses to test, not received best practice.** Source caveats are carried inline in `GUIDE.md §6`.

The one idea to anchor on

> **Omission is only safe over a backbone that exists.** Hemingway: a writer who omits things he *knows* makes the reader feel them; one who omits what he *doesn't* know "only makes hollow places." For an LLM that fails by exactly that route, the fix is to make the submerged 90% an explicit, typed, frozen canon graph — then generate surface artifacts that only *read from* it. Never invent a backbone fact at the moment you write an item description.

Start with `GUIDE.md`, then apply `CHECKLIST.md`.