agents.md

AGENTS.md

@@ -11,6 +11,21 @@ toolset, so geometry built here converts cleanly to a shippable `.hak`.
 
 ---
 
+## What it is / part it serves
+
+Shadows Over Westgate (SoW) is a Neverwinter Nights: Enhanced Edition
+persistent-world project split into single-purpose repos. This repo holds the
+**tileset sources** for the SoW module: the Blender generators and NWN files
+(`.set`, `.mdl`, `.wok`, `.itp`) that become a tileset `.hak` (a HAK is an NWN
+resource archive). The packed `.hak` is shipped through sow-assets-manifest
+(https://git.westgate.pw/ShadowsOverWestgate/sow-assets-manifest), which owns
+HAK publishing and CDN sync; the module in sow-module
+(https://git.westgate.pw/ShadowsOverWestgate/sow-module) pins that HAK list.
+Nothing here builds the module or the asset pipeline — this repo only makes
+tilesets. Repo layout is in §0, the build pipeline in §6.
+
+---
+
 ## 0. Repo layout
 
 Each tileset lives in its own directory. One tileset = one 5-char prefix = one
@@ -19,14 +34,22 @@ Each tileset lives in its own directory. One tileset = one 5-char prefix = one
 ```
 sow-module-tilesets/
 ├── AGENTS.md                 ← you are here (applies to all tilesets)
-├── wgt01/                    ← Westgate Urban Foundation MVP (streets, canals, ramps)
+├── twu01/                    ← Westgate Urban Foundation MVP (prefix TWU01)
 │   ├── KICKOFF.md            ← design brief / tile list for this tileset (the spec)
-│   ├── concept-art-1.png
+│   ├── STATUS.md             ← current state / known issues
 │   ├── flake.nix             ← Blender 4.0.2 + generator entry points
-│   └── generator/            ← bpy scripts that build the .blend source
-└── <future-tileset>/         ← same shape
+│   ├── generator/            ← bpy scripts that build the .blend source
+│   └── build/                ← tileset build output
+├── wgt01/                    ← art/design side: DESIGN.md, VIBE.md, textures, .blend
+├── build/                    ← top-level build output (mdl/, twu01.set, .blend)
+├── docs/                     ← plans/specs archive (do not touch)
+└── <future-tileset>/         ← same shape as twu01
 ```
 
+> Note: older sections below still say `wgt01/generator`, `wgt01/flake.nix`,
+> `wgt01/STATUS.md`. Those files now live under `twu01/` (the NWN prefix dir);
+> `wgt01/` keeps the art/design side. Read `wgt01/…` in the text as `twu01/…`.
+
 - **wgt01** is the *urban foundation* set: ground grammar only (streets,
   sidewalks, plazas, ramps, terraces, canals, bridges). Buildings/props are
   placeables layered on top later — **not** part of any tileset here.