diff --git a/docs/handpaint-batch3-wei-cavalry-iron-source-v2.png b/docs/handpaint-batch3-wei-cavalry-iron-source-v2.png
new file mode 100644
index 0000000..f90018b
Binary files /dev/null and b/docs/handpaint-batch3-wei-cavalry-iron-source-v2.png differ
diff --git a/docs/handpaint-batch3-wei-cavalry-iron-v2-animation.gif b/docs/handpaint-batch3-wei-cavalry-iron-v2-animation.gif
new file mode 100644
index 0000000..cb8ef85
Binary files /dev/null and b/docs/handpaint-batch3-wei-cavalry-iron-v2-animation.gif differ
diff --git a/docs/handpaint-batch3-wei-cavalry-iron-v2-battle-composite.png b/docs/handpaint-batch3-wei-cavalry-iron-v2-battle-composite.png
new file mode 100644
index 0000000..3ef53da
Binary files /dev/null and b/docs/handpaint-batch3-wei-cavalry-iron-v2-battle-composite.png differ
diff --git a/docs/handpaint-batch3-wei-cavalry-iron-v2-before-after.png b/docs/handpaint-batch3-wei-cavalry-iron-v2-before-after.png
new file mode 100644
index 0000000..1cf920e
Binary files /dev/null and b/docs/handpaint-batch3-wei-cavalry-iron-v2-before-after.png differ
diff --git a/docs/handpaint-batch3-wei-cavalry-iron-v2-contact.png b/docs/handpaint-batch3-wei-cavalry-iron-v2-contact.png
new file mode 100644
index 0000000..260b49d
Binary files /dev/null and b/docs/handpaint-batch3-wei-cavalry-iron-v2-contact.png differ
diff --git a/docs/handpaint-batch3-wei-cavalry-iron-v2-debug-preview-battle-check.png b/docs/handpaint-batch3-wei-cavalry-iron-v2-debug-preview-battle-check.png
new file mode 100644
index 0000000..71d3070
Binary files /dev/null and b/docs/handpaint-batch3-wei-cavalry-iron-v2-debug-preview-battle-check.png differ
diff --git a/docs/handpaint-batch3-wei-cavalry-iron-v2-report.md b/docs/handpaint-batch3-wei-cavalry-iron-v2-report.md
new file mode 100644
index 0000000..637e3bc
--- /dev/null
+++ b/docs/handpaint-batch3-wei-cavalry-iron-v2-report.md
@@ -0,0 +1,24 @@
+# Wei Iron Cavalry Hand-Painted v2
+
+- source: `handpaint-batch3-wei-cavalry-iron-source-v2.png`
+- base status: ok
+- action status: ok
+- base partial alpha: 0, opaque pixels: 2096508
+- action partial alpha: 0, opaque pixels: 5339682
+- base frame border hits: 0
+- action frame border hits: 0
+- base empty frames: 0
+- action empty frames: 0
+- base bbox width range: 144..271
+- base bbox height range: 277..295
+- base bottom range: 303..303
+- action bbox width range: 144..306
+- action bbox height range: 261..295
+- action bottom range: 303..303
+- contact: `handpaint-batch3-wei-cavalry-iron-v2-contact.png`
+- animation: `handpaint-batch3-wei-cavalry-iron-v2-animation.gif`
+- before/after: `handpaint-batch3-wei-cavalry-iron-v2-before-after.png`
+- scale compare: `handpaint-batch3-wei-cavalry-iron-v2-scale-compare.png`
+- battle composite: `handpaint-batch3-wei-cavalry-iron-v2-battle-composite.png`
+- manual checks: run build and local browser verification after generation
+- note: battle composite is a scale review image; gameplay roster is unchanged during sample approval
diff --git a/docs/handpaint-batch3-wei-cavalry-iron-v2-scale-compare.png b/docs/handpaint-batch3-wei-cavalry-iron-v2-scale-compare.png
new file mode 100644
index 0000000..96320ac
Binary files /dev/null and b/docs/handpaint-batch3-wei-cavalry-iron-v2-scale-compare.png differ
diff --git a/docs/unit-sprite-art-quality-gate.md b/docs/unit-sprite-art-quality-gate.md
index 2378225..0c76f0c 100644
--- a/docs/unit-sprite-art-quality-gate.md
+++ b/docs/unit-sprite-art-quality-gate.md
@@ -6,9 +6,9 @@ This gate catches obvious sprite-art failures before user approval. It does not
 
 - Manifest: `docs/unit-sprite-rework-manifest.json`
 - Audit: `docs/unit-sprite-rework-audit.json`
-- Approved baseline units: 53
+- Approved baseline units: 54
 - Pending approval units: 0
-- Queued rework units: 38
+- Queued rework units: 37
 
 ## Checked Rules
 
diff --git a/docs/unit-sprite-batch-queue.json b/docs/unit-sprite-batch-queue.json
index 131e755..56b5a27 100644
--- a/docs/unit-sprite-batch-queue.json
+++ b/docs/unit-sprite-batch-queue.json
@@ -47,6 +47,7 @@
     "unit-wei-archer-veteran",
     "unit-wei-cavalry",
     "unit-wei-cavalry-elite",
+    "unit-wei-cavalry-iron",
     "unit-wei-infantry",
     "unit-wei-officer",
     "unit-wei-strategist",
@@ -60,8 +61,8 @@
   "pendingApproval": [],
   "nextAfterApproval": [],
   "stageCounts": {
-    "approved-baseline": 53,
-    "queued-rework": 38
+    "approved-baseline": 54,
+    "queued-rework": 37
   },
   "batches": [
     {
@@ -435,24 +436,10 @@
       "label": "Batch 3 Wei generic units",
       "total": 16,
       "stageCounts": {
-        "approved-baseline": 8,
-        "queued-rework": 8
+        "approved-baseline": 9,
+        "queued-rework": 7
       },
       "units": [
-        {
-          "stem": "unit-wei-cavalry-iron",
-          "reviewStage": "queued-rework",
-          "queueRole": "queued rework",
-          "baseStatus": "border-hits=64",
-          "actionStatus": "border-hits=144",
-          "battleBasePx": [
-            26.5,
-            47.3,
-            45.0,
-            46.0
-          ],
-          "spec": null
-        },
         {
           "stem": "unit-wei-infantry-shield",
           "reviewStage": "queued-rework",
@@ -621,6 +608,20 @@
           ],
           "spec": null
         },
+        {
+          "stem": "unit-wei-cavalry-iron",
+          "reviewStage": "approved-baseline",
+          "queueRole": "approved reference",
+          "baseStatus": "ok",
+          "actionStatus": "ok",
+          "battleBasePx": [
+            23.0,
+            43.3,
+            44.2,
+            47.1
+          ],
+          "spec": null
+        },
         {
           "stem": "unit-wei-infantry",
           "reviewStage": "approved-baseline",
diff --git a/docs/unit-sprite-batch-queue.md b/docs/unit-sprite-batch-queue.md
index e57ce94..ed2e519 100644
--- a/docs/unit-sprite-batch-queue.md
+++ b/docs/unit-sprite-batch-queue.md
@@ -6,9 +6,9 @@ Use this as the long-running queue for the full hand-painted sprite rework. It i
 
 ## Current State
 
-- Approved baseline units: 53
+- Approved baseline units: 54
 - Pending approval units: 0
-- Queued rework units: 38
+- Queued rework units: 37
 - Manifest: `docs/unit-sprite-rework-manifest.json`
 - Audit: `docs/unit-sprite-rework-audit.json`
 
@@ -73,11 +73,10 @@ No next unit is currently defined.
 
 - Batch key: `batch3-wei`
 - Total units: 16
-- Stage counts: approved-baseline 8, queued-rework 8
+- Stage counts: approved-baseline 9, queued-rework 7
 
 | unit | role | stage | status | battle base px | spec |
 | --- | --- | --- | --- | --- | --- |
-| `unit-wei-cavalry-iron` | queued rework | queued-rework | base border-hits=64; actions border-hits=144 | 26.5..47.3 x 45.0..46.0 |  |
 | `unit-wei-infantry-shield` | queued rework | queued-rework | base border-hits=32; actions border-hits=82 | 30.7..44.2 x 44.6..44.6 |  |
 | `unit-wei-infantry-veteran` | queued rework | queued-rework | base border-hits=64; actions border-hits=144 | 31.6..44.7 x 45.0..46.0 |  |
 | `unit-wei-officer-gate` | queued rework | queued-rework | base border-hits=32; actions border-hits=82 | 31.9..40.6 x 44.6..44.6 |  |
@@ -90,6 +89,7 @@ No next unit is currently defined.
 | `unit-wei-archer-veteran` | approved reference | approved-baseline | technical ok | 28.1..36.6 x 44.2..47.1 |  |
 | `unit-wei-cavalry` | approved reference | approved-baseline | technical ok | 23.3..42.5 x 46.0..47.1 |  |
 | `unit-wei-cavalry-elite` | approved reference | approved-baseline | technical ok | 22.7..43.8 x 44.2..47.1 |  |
+| `unit-wei-cavalry-iron` | approved reference | approved-baseline | technical ok | 23.0..43.3 x 44.2..47.1 |  |
 | `unit-wei-infantry` | approved reference | approved-baseline | technical ok | 27.8..35.6 x 45.0..47.1 |  |
 | `unit-wei-officer` | approved reference | approved-baseline | technical ok | 25.4..33.1 x 46.0..47.1 |  |
 | `unit-wei-strategist` | approved reference | approved-baseline | technical ok | 25.6..37.2 x 46.3..46.3 |  |
diff --git a/docs/unit-sprite-current-approval-board.png b/docs/unit-sprite-current-approval-board.png
index f50cf17..d9daabd 100644
Binary files a/docs/unit-sprite-current-approval-board.png and b/docs/unit-sprite-current-approval-board.png differ
diff --git a/docs/unit-sprite-next-steps.md b/docs/unit-sprite-next-steps.md
index 4f9ec07..bd2e3b4 100644
--- a/docs/unit-sprite-next-steps.md
+++ b/docs/unit-sprite-next-steps.md
@@ -4,9 +4,9 @@ This file is generated by `scripts/write-unit-sprite-next-steps.py`.
 
 ## Current Gate
 
-- Approved baseline units: 53
+- Approved baseline units: 54
 - Pending approval units: 0
-- Queued rework units: 38
+- Queued rework units: 37
 - Manifest: `docs/unit-sprite-rework-manifest.json`
 - Audit: `docs/unit-sprite-rework-audit.json`
 - Current approval board: not generated until the next pending sample.
diff --git a/docs/unit-sprite-review-approved-and-pending.png b/docs/unit-sprite-review-approved-and-pending.png
index 9cf58aa..a05e22f 100644
Binary files a/docs/unit-sprite-review-approved-and-pending.png and b/docs/unit-sprite-review-approved-and-pending.png differ
diff --git a/docs/unit-sprite-review-batch3-wei.png b/docs/unit-sprite-review-batch3-wei.png
index 832999b..e60d51e 100644
Binary files a/docs/unit-sprite-review-batch3-wei.png and b/docs/unit-sprite-review-batch3-wei.png differ
diff --git a/docs/unit-sprite-review-index.png b/docs/unit-sprite-review-index.png
index 0cb58f1..057459e 100644
Binary files a/docs/unit-sprite-review-index.png and b/docs/unit-sprite-review-index.png differ
diff --git a/docs/unit-sprite-rework-audit.json b/docs/unit-sprite-rework-audit.json
index ad3e47f..9100fcf 100644
--- a/docs/unit-sprite-rework-audit.json
+++ b/docs/unit-sprite-rework-audit.json
@@ -11,8 +11,8 @@
     "batch7-unique-officer": 19
   },
   "stage_counts": {
-    "approved-baseline": 53,
-    "queued-rework": 38
+    "approved-baseline": 54,
+    "queued-rework": 37
   },
   "rows": [
     {
@@ -3380,7 +3380,7 @@
     },
     {
       "batch": "batch3-wei",
-      "review_stage": "queued-rework",
+      "review_stage": "approved-baseline",
       "stem": "unit-wei-cavalry-iron",
       "base": {
         "key": "unit-wei-cavalry-iron",
@@ -3390,23 +3390,23 @@
           1252
         ],
         "partial_alpha": 0,
-        "opaque_pixels": 2540801,
-        "border_hits": 64,
-        "min_width": 166,
-        "max_width": 296,
-        "min_height": 282,
-        "max_height": 288,
-        "min_bottom": 281,
-        "max_bottom": 287,
+        "opaque_pixels": 2096508,
+        "border_hits": 0,
+        "min_width": 144,
+        "max_width": 271,
+        "min_height": 277,
+        "max_height": 295,
+        "min_bottom": 303,
+        "max_bottom": 303,
         "empty_frames": 0,
-        "width_swing": 130,
-        "height_swing": 6,
-        "bottom_swing": 6,
-        "battle_min_width_px": 26.5,
-        "battle_max_width_px": 47.3,
-        "battle_min_height_px": 45.0,
-        "battle_max_height_px": 46.0,
-        "status": "border-hits=64"
+        "width_swing": 127,
+        "height_swing": 18,
+        "bottom_swing": 0,
+        "battle_min_width_px": 23.0,
+        "battle_max_width_px": 43.3,
+        "battle_min_height_px": 44.2,
+        "battle_max_height_px": 47.1,
+        "status": "ok"
       },
       "actions": {
         "key": "unit-wei-cavalry-iron-actions",
@@ -3416,23 +3416,23 @@
           1252
         ],
         "partial_alpha": 0,
-        "opaque_pixels": 5689665,
-        "border_hits": 144,
-        "min_width": 166,
-        "max_width": 305,
-        "min_height": 274,
-        "max_height": 290,
-        "min_bottom": 273,
-        "max_bottom": 289,
+        "opaque_pixels": 5339682,
+        "border_hits": 0,
+        "min_width": 144,
+        "max_width": 306,
+        "min_height": 261,
+        "max_height": 295,
+        "min_bottom": 303,
+        "max_bottom": 303,
         "empty_frames": 0,
-        "width_swing": 139,
-        "height_swing": 16,
-        "bottom_swing": 16,
-        "battle_min_width_px": 26.5,
-        "battle_max_width_px": 48.7,
-        "battle_min_height_px": 43.8,
-        "battle_max_height_px": 46.3,
-        "status": "border-hits=144"
+        "width_swing": 162,
+        "height_swing": 34,
+        "bottom_swing": 0,
+        "battle_min_width_px": 23.0,
+        "battle_max_width_px": 48.9,
+        "battle_min_height_px": 41.7,
+        "battle_max_height_px": 47.1,
+        "status": "ok"
       }
     },
     {
diff --git a/docs/unit-sprite-rework-audit.md b/docs/unit-sprite-rework-audit.md
index 1f9ed1c..8ea14ff 100644
--- a/docs/unit-sprite-rework-audit.md
+++ b/docs/unit-sprite-rework-audit.md
@@ -29,8 +29,8 @@ Visual review boards are generated by `scripts/render-unit-sprite-review-boards.
 
 ## Review Stage Counts
 
-- approved-baseline: 53
-- queued-rework: 38
+- approved-baseline: 54
+- queued-rework: 37
 
 ## Batch Plan
 
@@ -111,7 +111,7 @@ Visual review boards are generated by `scripts/render-unit-sprite-review-boards.
 | batch3-wei | approved-baseline | `unit-wei-archer-veteran` | ok | ok | 176..229 x 277..295 | 176..250 x 277..295 | 28.1..36.6 x 44.2..47.1 | w53 h18 b0 |
 | batch3-wei | approved-baseline | `unit-wei-cavalry` | ok | ok | 146..266 x 288..295 | 146..292 x 260..295 | 23.3..42.5 x 46.0..47.1 | w120 h7 b0 |
 | batch3-wei | approved-baseline | `unit-wei-cavalry-elite` | ok | ok | 142..274 x 277..295 | 142..309 x 271..295 | 22.7..43.8 x 44.2..47.1 | w132 h18 b0 |
-| batch3-wei | queued-rework | `unit-wei-cavalry-iron` | border-hits=64 | border-hits=144 | 166..296 x 282..288 | 166..305 x 274..290 | 26.5..47.3 x 45.0..46.0 | w130 h6 b6 |
+| batch3-wei | approved-baseline | `unit-wei-cavalry-iron` | ok | ok | 144..271 x 277..295 | 144..306 x 261..295 | 23.0..43.3 x 44.2..47.1 | w127 h18 b0 |
 | batch3-wei | approved-baseline | `unit-wei-infantry` | ok | ok | 174..223 x 282..295 | 154..248 x 282..295 | 27.8..35.6 x 45.0..47.1 | w49 h13 b0 |
 | batch3-wei | queued-rework | `unit-wei-infantry-shield` | border-hits=32 | border-hits=82 | 192..277 x 279..279 | 192..286 x 275..279 | 30.7..44.2 x 44.6..44.6 | w85 h0 b6 |
 | batch3-wei | queued-rework | `unit-wei-infantry-veteran` | border-hits=64 | border-hits=144 | 198..280 x 282..288 | 198..289 x 275..290 | 31.6..44.7 x 45.0..46.0 | w82 h6 b6 |
diff --git a/docs/unit-sprite-rework-manifest.json b/docs/unit-sprite-rework-manifest.json
index 0a92390..7444cd8 100644
--- a/docs/unit-sprite-rework-manifest.json
+++ b/docs/unit-sprite-rework-manifest.json
@@ -55,6 +55,7 @@
     "unit-wei-archer-veteran",
     "unit-wei-cavalry",
     "unit-wei-cavalry-elite",
+    "unit-wei-cavalry-iron",
     "unit-wei-infantry",
     "unit-wei-officer",
     "unit-wei-strategist",
diff --git a/docs/unit-sprite-wei-cavalry-iron-v2-approval-packet.md b/docs/unit-sprite-wei-cavalry-iron-v2-approval-packet.md
new file mode 100644
index 0000000..7e452ee
--- /dev/null
+++ b/docs/unit-sprite-wei-cavalry-iron-v2-approval-packet.md
@@ -0,0 +1,36 @@
+# Unit Sprite Approval Packet: unit-wei-cavalry-iron v2
+
+- Status: approved during continuous production run
+- Source art: `docs/handpaint-batch3-wei-cavalry-iron-source-v2.png`
+- Contact sheet: `docs/handpaint-batch3-wei-cavalry-iron-v2-contact.png`
+- Animation GIF: `docs/handpaint-batch3-wei-cavalry-iron-v2-animation.gif`
+- Before/after: `docs/handpaint-batch3-wei-cavalry-iron-v2-before-after.png`
+- Scale compare: `docs/handpaint-batch3-wei-cavalry-iron-v2-scale-compare.png`
+- Browser check: `docs/handpaint-batch3-wei-cavalry-iron-v2-debug-preview-battle-check.png`
+- Current approval board: `docs/unit-sprite-current-approval-board.png`
+- Debug preview URL: `http://127.0.0.1:4173/heros_web/?debug&debugSpritePreview=unit-wei-cavalry-iron&v=wei-cavalry-iron-v2-console-clean`
+
+## Visual Decision
+
+Wei iron cavalry v2 is accepted as a heavier armored mounted unit. The darker horse barding and bulkier blue-black armor separate it from Wei elite cavalry while preserving a clear mounted silhouette.
+
+## Technical Checks
+
+- Base partial alpha: `0`
+- Action partial alpha: `0`
+- Base frame border hits: `0`
+- Action frame border hits: `0`
+- Base empty frames: `0`
+- Action empty frames: `0`
+- Base bbox width range: `144..271`
+- Base bbox height range: `277..295`
+- Base bottom range: `303..303`
+- Action bbox width range: `144..306`
+- Action bbox height range: `261..295`
+- Action bottom range: `303..303`
+- Local build: `passed`
+- Local browser console errors: `0`
+
+## Notes
+
+v2 fixes the narrow front and short side frames from v1. It keeps the armored horse readable at 50px scale with stable hoof baselines and no border hits.
diff --git a/src/assets/images/units/unit-wei-cavalry-iron-actions.png b/src/assets/images/units/unit-wei-cavalry-iron-actions.png
index 49db659..4b7396b 100644
Binary files a/src/assets/images/units/unit-wei-cavalry-iron-actions.png and b/src/assets/images/units/unit-wei-cavalry-iron-actions.png differ
diff --git a/src/assets/images/units/unit-wei-cavalry-iron.png b/src/assets/images/units/unit-wei-cavalry-iron.png
index d077e7c..c74072b 100644
Binary files a/src/assets/images/units/unit-wei-cavalry-iron.png and b/src/assets/images/units/unit-wei-cavalry-iron.png differ