Add prompt route smoke checks

docs/prompt-pool-routing-map.md

@@ -655,6 +655,28 @@ The script does not import ComfyUI. It parses the repo and prints:
 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.
 
+## Behavioral Smoke Helper
+
+Route behavior should be checked when changing prompt generation, pair assembly,
+formatter metadata parsing, trigger handling, expression disabling, or scene
+continuity. Run:
+
+```bash
+python tools/prompt_smoke.py
+```
+
+The script does not import ComfyUI. It builds representative metadata rows and
+pair metadata through the core Python APIs, then verifies:
+
+- generated rows keep prompt, negative prompt, scene, composition, action item,
+  and role graph metadata populated;
+- Krea2, SDXL, and natural caption routes use metadata instead of text fallback;
+- SDXL and caption trigger handling keeps one trigger;
+- negative prompts do not duplicate comma-list items;
+- same-room Insta/OF continuity keeps prompt text and `hardcore_row.scene_text`
+  synchronized;
+- expression-disabled rows do not fall back to generated expression text.
+
 ## Editing Cheatsheet
 
 | Symptom | First file/function to inspect |