Improve paired cast continuity and wording

README.md

@@ -52,6 +52,12 @@ more natural language. Connect the prompt builder's `metadata_json` output to
 `prompt`; in that case the node falls back to prompt-label parsing or comma-tag
 cleanup.
 
+When connected to `SxCP Insta/OF Prompt Pair` metadata, the naturalizer emits a
+single combined natural caption with the shared descriptor plus separate
+softcore and hardcore version descriptions. It uses the final selected
+expression and composition from the generated rows, including any expression
+pool and intensity settings.
+
 Naturalizer controls:
 
 - `input_hint`: `auto`, `metadata_json`, or `caption_or_prompt`.
@@ -100,6 +106,12 @@ shared primary creator descriptor, then returns both a softcore prompt and a
 hardcore prompt from that same descriptor. This is useful when you want the same
 person/look/scene continuity but need two different prompt strengths.
 
+When the hardcore cast includes partners, pair mode also creates deterministic
+shared cast descriptors such as `woman A / primary creator` and `man A`. Use
+`softcore_cast=same_as_hardcore`, `hardcore_cast=couple`, and
+`continuity=same_creator_same_room` when you want a soft prompt with the same
+woman, man, and location as the hardcore prompt.
+
 It outputs:
 
 - `softcore_prompt`