diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index dee60cb..86fa4c4 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -8,6 +8,7 @@ Telnet MUD engine built on telnetlib3. Python 3.12+, managed with uv.
 - `just lint` / `just typecheck` / `just test` - individual steps
 - `just run` - start the server (`python -m mudlib`)
 - `just debug` - start with debug logging
+- `just render` - generate full world map HTML in `build/`
 
 ## Project Layout
 
@@ -16,6 +17,8 @@ Telnet MUD engine built on telnetlib3. Python 3.12+, managed with uv.
 - `worlds/` - world definition files (yaml/toml, version controlled)
 - `docs/` - project knowledge (see below)
 - `DREAMBOOK.md` - the vision, philosophy, wild ideas. not a spec
+- `scripts/` - standalone tools (map renderer, etc)
+- `build/` - generated output (gitignored)
 - `repos/` - symlinked reference repos (telnetlib3, miniboa). gitignored, not our code
 
 ## Docs
@@ -42,6 +45,7 @@ Update docs when:
 - telnetlib3 is a **dependency**, not vendored. contribute fixes upstream
 - telnetlib3 gives us: GMCP, MSDP, NAWS, async server, reader/writer streams
 - game loop is tick-based (async task alongside telnet server)
+- world is toroidal (wraps in both axes). terrain noise tiles seamlessly
 - world definitions live in data files, runtime state lives in memory
 - SQLite for persistence (player accounts, progress)
 - session mode stack filters what events reach the player (normal/combat/editor)