Refactor pose analysis and bone rotation prompts

Simplified and clarified `step_1_prompt_analyse_image_and_get_pose_description.md`:
- Removed redundant comments and examples.
- Expanded `OUTPUT` section with a `Notes` field and increased word limit.
- Improved `LATERALITY LOCK` with conflict handling instructions.

Enhanced `step_2_prompt_generate_bone_rotations.md`:
- Added detailed workflows for torso, head/neck, arms, legs, and self-checks.
- Clarified `INPUT` and `OUTPUT` sections for realistic and consistent results.
- Updated `JOINT RANGE CONSTRAINTS` and added `COMMON ERRORS TO AVOID`.
- Improved internal workflows for parsing pose text and mapping biomechanical terms.

General formatting and consistency improvements across both files.

Author: AlexRynas

src/DesktopApp/ImageToPose.Desktop/Assets/step_1_prompt_analyse_image_and_get_pose_description.md

@@ -1,17 +1,3 @@
-# Before pasting into chat, delete the following comments section, including this line. 
-# You need to fill out the USER-SET ANCHORS section as shown in the examples to ensure the model can best describe the pose correctly.
-# Fill USER-SET ANCHORS and they become ground truth
-# Examples:
-# Examples (collapsed by field):
-# Left hand=<at 10 o’clock on wheel; clasped with right before chest; clasped with right behind back; cradling infant; crossed over right biceps; forward swing; grabbing bar; holding book; holding crutch; holding leash; holding mic; holding suitcase; in coat pocket (occluded); in left pocket (occluded); lead glove forward; occluded (likely on hip); occluded behind torso (likely on hip); on abdomen; on backpack strap; on floor; on forearm support; on guitar neck (fretboard); on handlebar; on hip; on keyboard; on pushrim; on railing; on thigh (partly occluded); palms together overhead; pressed together with right at sternum; raised overhead (open palm); rear rack; resting on knee; resting on left cheek; resting on stair rail; side extension (T); tossing ball; wave at shoulder height>
-# Right hand=<adjusting scarf; at side; back swing; chin support; clasped with left; clasped with left behind back; crossed over abdomen; crossed under left arm; forward reach; free; free swing; gesturing outward; grabbing bar; guarding chin; handlebar; holding cup; holding phone at chest; holding tote; mid-swing; on backpack strap; on brake hood; on forearm support; on gear lever; on hip; on lap; on mouse; on phone taking selfie; on pillow; on right thigh; on thigh; over strings; palms together overhead; pointing at screen; pressed together with left; racket back; reaching overhead to shelf; supporting back; unknown (fully occluded by bag)>
-# Left foot=<on right thigh (tree pose)>
-# Right foot=<occluded; off frame; on floor>
-# Facing=<frontal; left; left-profile; prone; right-profile; supine; up-stairs; ¾ left; ¾ right>
-# Notes=<air squat; ankles dorsiflexed; arms folded; bicycle, seat-weighted; boxing stance; camera slightly above; dance arabesque, left leg back; dog outside frame; head tilt right; kneeling on right knee; lightly forward head; lying on back; mark right hand uncertain; mild spine extension; mirror present—do NOT flip laterality; mountain pose reach; on stage; phone blocks wrist view; plank position, feet unseen; power stance, feet wide; pull-up hang, feet off frame; road bike drops; running stride; seated at desk; seated driver; seated think pose; seated, elbow on table; shirt hides wrist; shoulders retracted; standing guitarist; standing relaxed; standing, slight forward lean; tennis serve prep; tree pose, left foot on right thigh; visor shadow may hide wrist angles; walking toward camera; walking with carry; weight biased to right leg; wheelchair, slight trunk flexion; winter wear covers neck>
-# Facing=uncertain (likely left)
-# Keep Facing to one of: frontal, left-profile, right-profile, ¾ left, ¾ right, supine, prone, or a brief context like up-stairs.
-# Use occluded, partly occluded, or unknown where visibility is limited.
 ROLE (system)
 You are a vision-and-kinematics analyst.
 
@@ -28,8 +14,8 @@ LATERALITY LOCK (MANDATORY)
 3) If [USER_ANCHORS] is present and seems to conflict with the image, write Check=FLAG and still use USER_ANCHORS, adding a one-clause note of the conflict.
 
 OUTPUT (exactly two blocks)
-[ANCHORS] Left hand=?, Right hand=?, Left foot=?, Right foot?, Facing=?, Check=PASS|FLAG
-[POSE] One paragraph (4–6 sentences, ≤140 words) covering: camera/view; global stance & lean; head/neck (yaw/pitch/tilt); torso orientation/lean/side-bend; each shoulder/arm (flexion/abduction/protraction), elbow bend, forearm rotation; hands (gesture + palm orientation); hips/legs/knees/feet/ankles; brief occlusions/uncertainties.
+[ANCHORS] Left hand=?, Right hand=?, Left foot=?, Right foot?, Facing=?, Notes=?, Check=PASS|FLAG
+[POSE] One paragraph (4–6 sentences, ≤150 words) covering: camera/view; global stance & lean; head/neck (yaw/pitch/tilt); torso orientation/lean/side-bend; each shoulder/arm (flexion/abduction/protraction), elbow bend, forearm rotation; hands (gesture + palm orientation); hips/legs/knees/feet/ankles; brief occlusions/uncertainties.
 
 RULES
 - Use the subject’s anatomical left/right only.

src/DesktopApp/ImageToPose.Desktop/Assets/step_2_prompt_generate_bone_rotations.md

@@ -9,9 +9,9 @@ Given a precise pose text and, optionally, a reference photo to resolve ambiguit
 - Rotate bones directly (no controllers). Do **not** add keyframes, change locations, scales, parenting, or constraints.
 
 # INPUT
-1) POSE TEXT (PRIMARY — authoritative): Between the markers below, the user inserts a concise pose paragraph. This is the main source of truth.
+1) POSE TEXT (PRIMARY – authoritative): Between the markers below, the user inserts a concise pose paragraph. This is the main source of truth.
 POSE_TEXT_START
-(Insert pose paragraph here — anatomical left/right, global stance/lean, head/neck yaw/pitch/tilt, torso orientation/lean/side-bend, shoulders/arms/elbows/forearms/hands, hips/legs/knees/feet, occlusions/uncertainties.)
+{USER_POSE_DESCRIPTION_HERE}
 POSE_TEXT_END
 
 2) OPTIONAL PHOTO: A single image of the same pose. Use only to **clarify** details that the POSE TEXT leaves ambiguous.
@@ -21,6 +21,7 @@ POSE_TEXT_END
   - a single top-level assignment: `POSE_DEGREES = { ... }`
 - No other text, comments, imports, printing, or helper code.
 - Each bone value is a list `[X, Y, Z]` in **degrees**. Use integers or floats.
+- **CRITICAL**: Avoid round numbers (0, 10, 20, 90) unless genuinely appropriate. Real poses use values like 18, -41, 72, 25.
 - If uncertain, put `[0, 0, 0]` (prefer 0 over guessing).
 
 # LATERALITY LOCK (MANDATORY)
@@ -69,47 +70,146 @@ Legs/Feet
 # T-POSE COMPENSATION CRITICAL
 The MPFB rig's T-pose has inherent bends that must be compensated:
 - Elbows are slightly bent in T-pose: To achieve real T pose with a straight arm, set `lowerarm_*.X = -45` and adjust `upperarm_*.Z` (left: +45, right: -45)
+- **TRIGGERS for applying compensation**: "straight arm", "extended arm", "nearly straight", "elbow locked", "arm trailing behind", "arm hanging down", "arm at rest"
 - These compensations are ONLY applied when the pose requires straight/extended arms
 
-# ANCHOR-DRIVEN ESTIMATION WORKFLOW (INTERNAL — do not output)
-1) Parse POSE TEXT into joints: global stance/lean; pelvis/torso; left/right shoulders/arms/elbows/forearms/hands; hips/knees/feet; head/neck.
-2) Determine facing/orientation; align verbs to anchors (e.g., "leans forward" → +X on spine; "turns head right" → **negative** Y if +Y is "turn left"). Flip signs to comply with anchors.
-3) Arms/legs: respect hinge-only joints (forearms, calves) → only X varies; set Y/Z=0.
-4) If POSE TEXT is ambiguous, consult the image to refine magnitudes/signs, but do not contradict anchors.
-5) Prefer small magnitudes when uncertain. Symmetry checks: contrapposto often implies pelvis/head counter-rotation.
-6) Clamp to plausible human ranges; if still unsure, use 0.
-7) Torso Analysis: Distribute forward/backward lean across spine segments. Pelvis often counter-balances upper body lean.
-8) Arm Straightness: If pose describes "straight arm" or "fully extended arm", apply T-pose compensation.
-
-# SIGN MAP (INTERNAL—do not output). Convert biomechanical words to your axis signs:
-- Hip flexion ⇒ thigh_ X = negative* (leg forward).
-- Hip extension ⇒ thigh_ X = positive* (leg back).
-- Shoulder flexion (reach forward) ⇒ upperarm_ X = positive*.
-- Shoulder abduction/elevation ⇒ upperarm_ Y = positive*.
-- Lower/bring arm down: right: upperarm_r Z positive lowers; left: upperarm_l Z positive raises (per your meanings); use Z for small height trims.
+# ANCHOR-DRIVEN ESTIMATION WORKFLOW (INTERNAL – do not output)
+
+## PHASE 1: TORSO ORIENTATION (CRITICAL)
+1. **Determine camera position** relative to subject (front, back, left side, right side, 3/4 view)
+2. **Identify torso facing direction** relative to camera:
+   - If "views her from the right" or "right side" → subject faces away from camera (toward left)
+   - If "views her from the left" or "left side" → subject faces toward camera (toward right)
+   - If "front view" → subject faces camera
+3. **Map facing to Y-axis rotations**:
+   - Subject turning LEFT (from subject's POV) = POSITIVE Y on spine/neck/head
+   - Subject turning RIGHT (from subject's POV) = NEGATIVE Y on spine/neck/head
+   - **DOUBLE CHECK**: Re-read camera position and verify Y signs match
+4. **Distribute spine rotations**:
+   - Torso lean (forward/back) → use X-axis across spine_01, spine_02, spine_03
+   - Torso twist/turn (left/right) → use Y-axis across spine_01, spine_02, spine_03
+   - **NEVER leave all spine segments at [0,0,0]** unless truly standing perfectly straight
+   - Example distribution: If leaning forward 15° total, use spine_01:X=10, spine_02:X=0, spine_03:X=-15 (can vary)
+   - Example twist: If turning left 45°, use spine_02:Y=15, spine_03:Y=20
+
+## PHASE 2: HEAD & NECK
+1. Parse head orientation relative to torso
+2. Apply Y-axis turn using **same sign convention** as torso
+3. Add X-axis for chin up/down
+4. Add Z-axis tilt only if explicitly mentioned
+
+## PHASE 3: ARMS (THINK IN 3D)
+**CRITICAL**: Arms almost always need multi-axis rotations. Follow this checklist for each arm:
+
+### For each arm, ask:
+1. **Height of hand** (high/low relative to shoulder):
+   - Left arm: Use upperarm_l.Z (positive=up)
+   - Right arm: Use upperarm_r.Y (positive=up) and upperarm_r.Z (negative=down)
+   - Typical values: -45° to +135° for shoulder elevation
+
+2. **Forward/back position of hand**:
+   - Use upperarm.X (positive=forward)
+   - Typical range: -30° to +90°
+
+3. **Elbow bend angle**:
+   - Straight/extended → lowerarm.X = -45 (T-pose compensation)
+   - Slightly bent (~20°) → lowerarm.X = 15 to 25
+   - 90° bend → lowerarm.X = 45 to 55
+   - Fully bent → lowerarm.X = 90 to 135
+   - **NEVER use negative values for bent elbows** (except -45 for straight)
+
+4. **Hand orientation**:
+   - Palm facing: Use hand.Y (clockwise turn)
+   - Palm up/down: Use hand.Z (left=up, right=down)
+   - Wrist bend: Use hand.X
+   - **DON'T leave at [0,0,0]** if pose describes grip, gesture, or specific hand position
+
+5. **Clavicle adjustment**:
+   - Shoulder protracted (forward) → clavicle.X positive
+   - Shoulder elevated (shrugged) → clavicle.Y/Z (varies by side)
+   - Typical range: -15° to +30°
+
+### Common arm pose patterns:
+- **Reaching forward horizontally**: upperarm.X=60-80, upperarm.Y/Z=small, lowerarm.X=-45 to 35
+- **Reaching up to head/face**: upperarm.X=small, upperarm.Y=40-60 (right) or upperarm.Z=45-90 (left), lowerarm.X=45-90
+- **Arm at side relaxed**: upperarm=[0,0,±45], lowerarm.X=-45
+- **Arm behind body**: upperarm.X=-20 to -40, lowerarm.X=-45
+
+## PHASE 4: LEGS
+1. **Hip flexion** (thigh forward):
+   - Negative X = leg forward
+   - Typical range: -135° (high knee) to -10° (slight forward)
+   - **Don't over-flex**: -90° is extreme, most poses use -30° to -60°
+
+2. **Hip abduction** (leg sideways):
+   - Positive Z = leg moves outward
+   - Typical range: -10° to +30°
+   - **Don't ignore this**: Seated poses often have 15-25° abduction
+
+3. **Knee bend**:
+   - 0° = straight (locked knee)
+   - Positive X = bent
+   - Typical values: 5° (nearly straight), 30° (slight), 60° (moderate), 90-100° (sharp), 135° (full)
+   - **Match thigh flexion**: If thigh=-80°, calf should be 70-100° to keep foot reasonable
+
+4. **Foot/ankle**:
+   - Small adjustments for plantarflexion (X) and rotation (Y/Z)
+   - Usually -10° to +15°
+
+## PHASE 5: SELF-CHECK (MANDATORY BEFORE OUTPUT)
+Run these checks on your estimated dictionary:
+
+1. **Spine Check**: At least ONE spine segment has non-zero value (unless perfect T-pose)
+2. **Torso-Head Coherence**: If spine turns left (+Y), head should also turn left or be neutral
+3. **Camera-Face Alignment**: 
+   - Right side camera view + "facing camera" → head/spine should turn left (+Y)
+   - Left side camera view + "facing camera" → head/spine should turn right (-Y)
+4. **Multi-Axis Arms**: Each upperarm should have at least TWO non-zero axes (unless truly T-pose)
+5. **Elbow Sign Check**: 
+   - Straight arm → lowerarm = -45
+   - Bent arm → lowerarm = POSITIVE (never negative except -45)
+6. **Hand Orientation**: If pose describes hand position/grip → hand should NOT be [0,0,0]
+7. **Leg Abduction**: If seated, straddling, or wide stance → thigh.Z should be non-zero
+8. **Magnitude Reality**: Values should vary (avoid all 0, 10, 20, 90 patterns)
+9. **Hinge Compliance**: lowerarm and calf have Y=0, Z=0 always
+10. **Range Validation**: Check values against limits below
 
 # JOINT RANGE CONSTRAINTS
 Respect these anatomical limits unless pose explicitly exceeds them:
-- Spine forward lean: `spine_*.X` typically ≤ 30° each
-- Head rotation: `head.Y` from -80° to +80° (right/left), typically ≤ +-30°
-- Shoulder elevation: `upperarm_l.Z` from -45° to +135°, `upperarm_r.Z` from +45° to -135° where +-45° is the the lowest position and +-135° is the highest
-- Elbow extension: `lowerarm_*.X` from -45° to 135° (-45° = straight, 135° = fully bent)
-- Hip rotation: `thigh_*.X` from -135° to +30° (forward/back)
-- Knee extension: `calf_*.X` from 0° to +135° (0° = straight, 135° = fully bent)
-
-# SELF-CHECK GATES (must pass before output)
-- **Anchor Sign Check**: Each non-zero angle's sign matches the anchor meanings above.
-- **Left/Right Consistency**: No inadvertent mirroring; bone names match anatomical sides in POSE TEXT.
-- **Hinge Compliance**: `lowerarm_*` and `calf_*` have non-zero X only; their Y/Z = 0.
-- **Ball Joints**: `ball_*` remain `[0,0,0]` unless the rig truly requires toe bend (default to 0).
-- **Global Coherence**: Pelvis/torso/head directions make sense together (e.g., if pelvis Y=+ left turn, head may counter-rotate per POSE TEXT).
-- **Shoulder Elevation Guardrail**: Unless POSE TEXT explicitly says "abducted/raised/elevated," constrain clavicle_ Y ∈ [-5°, +5°]* and upperarm_ Y ∈ [-5°, +5°]**.
-- **Arm Straightness Check**: If pose implies straight arms, verify `lowerarm_*.X = -45` and corresponding `upperarm_*.Z` adjustment
-- **T-pose Compensation**: Remember T-pose has inherent elbow bend requiring compensation for straight arms
-- **Range Validation**: All joint angles within anatomical limits specified in JOINT RANGE CONSTRAINTS
+- Spine forward/back lean: `spine_*.X` typically -30° to +30° each
+- Spine turn: `spine_*.Y` typically 0° to +45° for visible rotation
+- Head rotation: `head.Y` from -80° to +80° (right/left)
+- Shoulder elevation: 
+  - `upperarm_l.Z` from -45° (lowest) to +135° (overhead)
+  - `upperarm_r.Y` from -45° to +135°, `upperarm_r.Z` from +45° (lowest) to -135° (overhead)
+- Elbow: `lowerarm_*.X` from -45° (straight) to 135° (fully bent)
+- Hip flexion: `thigh_*.X` from -135° (knee to chest) to +30° (leg back)
+- Hip abduction: `thigh_*.Z` typically -10° to +30°
+- Knee: `calf_*.X` from 0° (straight) to +135° (fully bent)
+
+# COMMON ERRORS TO AVOID
+1. ❌ Setting all spine segments to [0,0,0]
+2. ❌ Using only one axis for arm rotations
+3. ❌ Getting head turn direction backwards (re-check camera position)
+4. ❌ Forgetting T-pose compensation for straight arms
+5. ❌ Leaving hands at [0,0,0] when they have specific grips
+6. ❌ Over-flexing legs (don't default to -90° hip flexion)
+7. ❌ Ignoring hip abduction (Z-axis) in wide or seated poses
+8. ❌ Using negative lowerarm values for bent elbows
+9. ❌ Using only round numbers (0, 10, 20, 90)
+10. ❌ Forgetting clavicle rotations when shoulders are protracted/elevated
 
 # OUTPUT RULES (HARD)
 - Respond with **one** fenced code block only, language tag `python`.
 - Inside it, output exactly:
-  POSE_DEGREES = { ... }  # with the keys from the BONE LIST above
-- No extra text before/after, no comments, no prints, no placeholders.
+  ```python
+  POSE_DEGREES = {
+      "pelvis": [X, Y, Z],
+      # ... all 22 bones
+  }
+  ```
+- No extra text before/after, no comments inside the dict, no prints, no placeholders.
+- Use realistic angle values (not just 0, 10, 20, 90).
+- Every bone must be present with a [X, Y, Z] list.
+
+Generate the pose following the enhanced workflow above.