Validate category pool references

docs/prompt-architecture-improvement-plan.md

@@ -181,8 +181,8 @@ Improve later:
 - introduce optional `family` and `action_type` fields on item templates so
   Python filters do less keyword guessing;
 - add `formatter_hint` fields only where needed, not globally;
-- add a JSON audit that checks every referenced expression/composition/scene pool
-  exists.
+- keep `tools/prompt_map_audit.py` passing; it now checks referenced
+  expression/composition/scene pools and item-template axes.
 
 ### Node / UI Path
 
@@ -305,7 +305,6 @@ Medium-term:
 1. Expand `tools/prompt_smoke.py` with close foreplay, POV penetration, and
    location-theme fixtures.
 2. Split Krea action/POV/clothing helpers into separate modules.
-3. Add category JSON pool reference validation to `tools/prompt_map_audit.py`.
-4. Extract scene-camera adapters from `prompt_builder.py`.
-5. Split `__init__.py` node classes by family after behavior is covered by smoke
+3. Extract scene-camera adapters from `prompt_builder.py`.
+4. Split `__init__.py` node classes by family after behavior is covered by smoke
    checks.

docs/prompt-pool-routing-map.md

@@ -651,9 +651,14 @@ The script does not import ComfyUI. It parses the repo and prints:
 - registered display node names and known return names;
 - per-JSON category counts;
 - named scene/expression/composition pool inventory.
+- JSON reference validation for every `scene_pools`, `expression_pools`, and
+  `composition_pools` reference;
+- item template validation so `{placeholder}` names resolve to `item_axes`.
 
 Use its output to spot doc drift after adding a new node or pool. If a new node
-or pool appears there but not in this map, update the relevant route table.
+or pool appears there but not in this map, update the relevant route table. The
+script exits nonzero when JSON pool references or item template axes do not
+resolve.
 
 ## Behavioral Smoke Helper