Add hardcore action family metadata

docs/prompt-architecture-improvement-plan.md

@@ -107,6 +107,9 @@ Already isolated:
 - shared hardcore environment-anchor cleanup lives in
   `hardcore_text_cleanup.py` and normalizes malformed pool joins before metadata
   reaches formatter routes.
+- shared hardcore action metadata lives in `hardcore_action_metadata.py`; custom
+  rows now emit `action_family`, `position_family`, `position_key`, and
+  `position_keys` so formatter routing and debugging do less keyword guessing.
 
 ### Pair / Adapter Layer
 
@@ -148,6 +151,8 @@ Already isolated:
 - `krea_action_context.py` owns shared action-family predicates, axis context
   text, climax detection, and detail-density normalization used by action and
   POV formatter routes.
+- `hardcore_action_metadata.py` owns shared action-family constants,
+  normalization, and inference used by the builder and Krea formatter route.
 - `krea_pov.py` owns POV labels, POV label filtering, and POV camera/composition
   support text.
 - `krea_detail.py` owns generic detail-clause splitting, deduping, joining, and
@@ -166,8 +171,8 @@ Already isolated:
 
 Improve later:
 
-- add metadata fields such as `action_family` / `position_family` to reduce
-  keyword guessing in hardcore formatter dispatch;
+- extend SDXL and caption routes to optionally consume `action_family` /
+  `position_family` when ordering tags or caption clauses;
 - add route-level smoke fixtures for representative metadata rows;
 
 ### SDXL Formatter Path
@@ -346,8 +351,8 @@ Medium-term:
 
 ## Recommended Next Passes
 
-1. Add metadata fields such as `action_family` / `position_family` to reduce
-   keyword guessing in hardcore filters and formatter dispatch.
+1. Extend SDXL and caption routes to optionally consume `action_family` /
+   `position_family` when ordering tags or caption clauses.
 2. Split `__init__.py` node classes by family after behavior is covered by smoke
    checks.
 3. Add route-level smoke fixtures for representative Krea/SDXL/caption metadata