Organize tools and move Python tests into tools/tests

docs/README.md

@@ -16,6 +16,7 @@ This folder holds the project documentation, visual references and generated QA
 - [`architecture.md`](architecture.md) — arc42 system architecture
 - [`getting-started.md`](getting-started.md) — setup, run/test commands and controls
 - [`asset-tooling.md`](asset-tooling.md) — image/model pipelines and screenshot gates
+- [`../tools/README.md`](../tools/README.md) — tool inventory, categories and test runner
 - [`gameplay.md`](gameplay.md) — controls, venues and escalation
 - [`joke-shop-map.md`](joke-shop-map.md) — Sunset Strip real-site mapping
 - [`tutorial.md`](tutorial.md) — first-shift tutorial beats

docs/asset-tooling.md

@@ -38,7 +38,7 @@ Audit accepts image files or directories. `--role auto` infers common roles from
 ```bash
 python3 tools/asset_pipeline.py audit assets/textures
 python3 tools/asset_pipeline.py audit assets/images/scenes --role background --json
-python3 -m unittest discover -s tools -p 'test_*.py'
+python3 -m unittest discover -s tools/tests -t tools -p 'test_*.py'
 ```
 
 The audit classifies measurable fit issues as `good` or `bad` based on role-specific dimensions, aspect ratio, alpha requirements, and tile-edge continuity. It lists perspective/projection as a visual review item because image semantics cannot be judged reliably by these deterministic checks.

docs/blender-assets.md

@@ -187,7 +187,7 @@ carry baked AO and the shared neutral material maps described above.
   during LOD generation), budgets (library characters 8000/8000, base fallback 6000/4000, gear 1500, props 4000
   triangles), grounding, and an editable `.blend`. For characters it also
   checks skinning, bones, slots, the `npc_base` mesh node and the height.
-- `tools/test_blender_assets.py`: catalogue and contract consistency with
+- `tools/tests/test_blender_assets.py`: catalogue and contract consistency with
   `npc_pipeline.py`, plus a clean audit and full manifest coverage when the
   library is built.
 - `src/test/tests/test_blender_assets.gd`: every asset imports as a scene