diff --git a/src/resources/worlds/khazad_prime/dev-notes.md b/src/resources/worlds/khazad_prime/dev-notes.md
new file mode 100644
index 00000000..a6b05f96
--- /dev/null
+++ b/src/resources/worlds/khazad_prime/dev-notes.md
@@ -0,0 +1,24 @@
+# Khazad Prime — Developer Notes
+
+## Overview
+High-elevation, cold, low-moisture world built on the `earth` archetype. Designed to feel
+geologically ancient — compressed, dense, mineral-rich. The biosphere is sparse but tough.
+
+## Climate Tuning
+- `temp_bias: cold` — global temperature shifted cold; alpine/tundra biomes dominate
+- `moisture_bias: low` — sparse precipitation; subterranean water sources are primary
+- `elevation_bias: high` — map generation favors mountain and hill tiles
+
+## Biome Distribution
+Dominant: `mountains`, `alpine_tundra`, `subterranean`, `alpine_meadow`
+The `subterranean` biome is key — it represents deep-carved Dwarven halls and must support
+production buildings that wouldn't appear on surface tiles.
+
+## Planetary Bonuses
+Production +2 and fortification_rate +15 only apply when the active map archetype matches
+this world (`map_archetype == world_archetype`). This rewards Dwarves for playing on their
+home turf without unbalancing other scenarios.
+
+## Known Issues / TODO
+- `subterranean` biome tags not yet defined in src/resources/biomes/
+- Subterranean ecology (fungi, cave fauna) needs its own succession model in mc-climate
diff --git a/src/resources/worlds/khazad_prime/gameplay-notes.md b/src/resources/worlds/khazad_prime/gameplay-notes.md
new file mode 100644
index 00000000..4606f29e
--- /dev/null
+++ b/src/resources/worlds/khazad_prime/gameplay-notes.md
@@ -0,0 +1,15 @@
+# Khazad Prime — Gameplay Notes
+
+Khazad Prime is the ancestral homeworld of the Dwarves.
+
+A world of towering iron peaks, frozen ridgelines, and vast underground kingdoms carved from
+living rock over millennia. The surface is harsh and unforgiving — thin air, brutal winters,
+and sparse rainfall. But beneath the stone lies warmth, water, and the richest ore veins in
+the known worlds.
+
+Dwarves who begin on Khazad Prime receive production and fortification bonuses when the game
+map matches their homeworld archetype, reflecting their mastery of terrain that would break
+any other civilization.
+
+**Playing on Khazad Prime favors:** Mining, fortification, underground expansion
+**Challenges:** Low food yield, slow population growth, limited arable land