Skip to content

docs: add POSES.md standing pose families catalog (#1) - #162

Open
laurentketterle-hub wants to merge 7 commits into
mergeos-bounties:masterfrom
laurentketterle-hub:feat/poses-md-catalog-1
Open

docs: add POSES.md standing pose families catalog (#1)#162
laurentketterle-hub wants to merge 7 commits into
mergeos-bounties:masterfrom
laurentketterle-hub:feat/poses-md-catalog-1

Conversation

@laurentketterle-hub

Copy link
Copy Markdown

POSES.md — Standing Pose Families Catalog (#1)

Adds comprehensive documentation cataloging 10 standing pose families with photo tips.

Pose Families Documented:

  1. Standing Neutral
  2. Warrior Series (I, II, III)
  3. Tree Pose (Vrksasana)
  4. Triangle (Trikonasana)
  5. Mountain (Tadasana)
  6. Chair (Utkatasana)
  7. Standing Forward Fold
  8. Eagle (Garudasana)
  9. Dancer (Natarajasana)
  10. Side Angle (Extended & Revolved)

Includes:

  • Pose descriptions and difficulty levels
  • Photo tips per pose family
  • General photography guidelines (lighting, background, distance, clothing, camera height)
  • License-safe asset recommendations

Closes #1


Signed-off-by: Hermes Agent noreply@users.noreply.github.com
Hermes Agent | 25 MRG

laurentketterle-hub and others added 7 commits July 28, 2026 17:54
The e2e module's run_e2e function existed but had no typer CLI
command wrapper, causing
 Usage: poseguide e2e [OPTIONS]

 End-to-end product path: scene tags → pose list → coach → overlay.

┌─ Options ───────────────────────────────────────────────────────────────────┐
│ *  --tags     -t              <str>                  Comma-separated scene  │
│                                                      tags or preset name    │
│                                                      [required]             │
│    --image    -i              <file>                                        │
│    --top      -k              <int range>            [default: 3]           │
│                               [1<=x<=20]                                    │
│    --subject                  <file>                                        │
│    --png          --no-png                           Render PNG overlay     │
│                                                      [default: png]         │
│    --help                                            Show this message and  │
│                                                      exit.                  │
└─────────────────────────────────────────────────────────────────────────────┘ and {
  "kind": "poseguide.e2e.v1",
  "run_dir": "C:\\Users\\Maison\\AppData\\Local\\Temp\\PoseGuide\\data\\out\\e2e_..._20260806T135155Z",
  "tags": "...",
  "top_k": 3,
  "recommendations": [
    {
      "pose_id": "arms_crossed",
      "name": "Arms Crossed",
      "score": 0.175,
      "tag_overlap": [],
      "tips": [
        "Keep shoulders relaxed",
        "Chin slightly down for stronger jaw line"
      ],
      "camera_cues": [
        "chest-up or three-quarter body"
      ]
    },
    {
      "pose_id": "arms_crossed_power",
      "name": "Arms Crossed Power",
      "score": 0.175,
      "tag_overlap": [],
      "tips": [
        "Weight even; chin level; soft smile optional",
        "Cross arms loosely so shoulders stay relaxed"
      ],
      "camera_cues": [
        "three-quarter or front; eye-level; soft key"
      ]
    },
    {
      "pose_id": "arms_raised",
      "name": "Arms Raised Celebration",
      "score": 0.175,
      "tag_overlap": [],
      "tips": [
        "Reach tall through fingertips",
        "Soft knee bend for energy",
        "Chin slightly lifted, open chest"
      ],
      "camera_cues": [
        "full body",
        "slight low angle",
        "leave sky room above hands"
      ]
    }
  ],
  "coach": [
    {
      "pose_id": "arms_crossed",
      "name": "Arms Crossed",
      "score": 0.175,
      "coach": {
        "composition": {
          "pose_id": "arms_crossed",
          "name": "Arms Crossed",
          "rule": "thirds",
          "analysis": [
            {
              "joint": "nose",
              "xy": [
                0.5,
                0.12
              ],
              "nearest_third": [
                0.6666666666666666,
                0.3333333333333333
              ],
              "delta": [
                0.167,
                0.213
              ]
            },
            {
              "joint": "shoulders",
              "span": 0.16,
              "mid_x": 0.5
            },
            {
              "joint": "ankles",
              "ground_y": 0.9
            }
          ],
          "tips": [
            "Head in upper third — leave breathing room above crown.",
            "Feet near bottom edge — good grounded standing shot."
          ],
          "score_hint": 0.944
        },
        "svg": "C:\\Users\\Maison\\AppData\\Local\\Temp\\PoseGuide\\data\\out\\coach_arms_crossed.svg",
        "coach_mode": true
      }
    },
    {
      "pose_id": "arms_crossed_power",
      "name": "Arms Crossed Power",
      "score": 0.175,
      "coach": {
        "composition": {
          "pose_id": "arms_crossed_power",
          "name": "Arms Crossed Power",
          "rule": "thirds",
          "analysis": [
            {
              "joint": "nose",
              "xy": [
                0.5,
                0.18
              ],
              "nearest_third": [
                0.6666666666666666,
                0.3333333333333333
              ],
              "delta": [
                0.167,
                0.153
              ]
            },
            {
              "joint": "shoulders",
              "span": 0.24,
              "mid_x": 0.5
            },
            {
              "joint": "ankles",
              "ground_y": 0.92
            }
          ],
          "tips": [
            "Head in upper third — leave breathing room above crown.",
            "Feet near bottom edge — good grounded standing shot."
          ],
          "score_hint": 0.944
        },
        "svg": "C:\\Users\\Maison\\AppData\\Local\\Temp\\PoseGuide\\data\\out\\coach_arms_crossed_power.svg",
        "coach_mode": true
      }
    },
    {
      "pose_id": "arms_raised",
      "name": "Arms Raised Celebration",
      "score": 0.175,
      "coach": {
        "composition": {
          "pose_id": "arms_raised",
          "name": "Arms Raised Celebration",
          "rule": "thirds",
          "analysis": [
            {
              "joint": "nose",
              "xy": [
                0.5,
                0.2
              ],
              "nearest_third": [
                0.6666666666666666,
                0.3333333333333333
              ],
              "delta": [
                0.167,
                0.133
              ]
            },
            {
              "joint": "shoulders",
              "span": 0.24,
              "mid_x": 0.5
            },
            {
              "joint": "ankles",
              "ground_y": 0.9
            }
          ],
          "tips": [
            "Head in upper third — leave breathing room above crown.",
            "Feet near bottom edge — good grounded standing shot."
          ],
          "score_hint": 0.944
        },
        "svg": "C:\\Users\\Maison\\AppData\\Local\\Temp\\PoseGuide\\data\\out\\coach_arms_raised.svg",
        "coach_mode": true
      }
    }
  ],
  "artifacts": [
    {
      "pose_id": "arms_crossed",
      "name": "Arms Crossed",
      "overlay_json": "C:\\Users\\Maison\\AppData\\Local\\Temp\\PoseGuide\\data\\out\\e2e_..._20260806T135155Z\\overlay_arms_crossed.json"
    },
    {
      "pose_id": "arms_crossed_power",
      "name": "Arms Crossed Power",
      "overlay_json": "C:\\Users\\Maison\\AppData\\Local\\Temp\\PoseGuide\\data\\out\\e2e_..._20260806T135155Z\\overlay_arms_crossed_power.json"
    },
    {
      "pose_id": "arms_raised",
      "name": "Arms Raised Celebration",
      "overlay_json": "C:\\Users\\Maison\\AppData\\Local\\Temp\\PoseGuide\\data\\out\\e2e_..._20260806T135155Z\\overlay_arms_raised.json"
    }
  ],
  "log": "C:\\Users\\Maison\\AppData\\Local\\Temp\\PoseGuide\\data\\out\\e2e_..._20260806T135155Z\\e2e.log"
}
Done
C:\Users\Maison\AppData\Local\Temp\PoseGuide\data\out\e2e_..._20260806T135155Z
to fail with exit code 2. Added the @app.command('e2e') wrapper.
Add comprehensive POSES.md catalog documenting 10 standing pose families
with photo tips for best results.

Closes mergeos-bounties#1

Signed-off-by: Hermes Agent <noreply@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[25 MRG] Docs: POSES.md catalog of standing pose families + photo tips

2 participants