heros_web/docs/unit-sprite-shu-spearman-v3-approval-packet.md

Shu Spearman v3 Approval Packet

This packet records the approved unit-shu-spearman Batch 2 Shu quality baseline.

Decision Target

• Unit: unit-shu-spearman
• Batch: Batch 2 Shu generic units
• Status: approved by user
• Review stage: approved-baseline
• Review manifest: unit-sprite-rework-manifest.json
• Art quality gate: unit-sprite-art-quality-gate.md
• Next unit after approval: unit-shu-archer
• Commit/push/deploy: allowed after release gate verification

Visual Evidence

• Approval board at review time: unit-sprite-current-approval-board.png
• Source art: handpaint-batch2-shu-spearman-source-v3.png
• Contact sheet: handpaint-batch2-shu-spearman-v3-contact.png
• Animation GIF: handpaint-batch2-shu-spearman-v3-animation.gif
• v2/v3 comparison: handpaint-batch2-shu-spearman-v3-before-after.png
• 50px/72px scale comparison: handpaint-batch2-shu-spearman-v3-scale-compare.png
• Battle-scale map composite: handpaint-batch2-shu-spearman-v3-battle-composite.png
• Local browser title check: handpaint-batch2-shu-spearman-v3-browser-check.png
• Local browser first battle check: handpaint-batch2-shu-spearman-v3-battle-browser-check.png
• Local browser debug sprite preview: handpaint-batch2-shu-spearman-v3-debug-preview-battle-check.png
• Approved/pending deliverables board: unit-sprite-review-approved-and-pending.png
• Batch 2 inventory board: unit-sprite-review-batch2-shu.png
• Review index: unit-sprite-review-index.png

Technical Evidence

• Base sheet: src/assets/images/units/unit-shu-spearman.png
• Action sheet: src/assets/images/units/unit-shu-spearman-actions.png
• Base sheet size: 5008x1252
• Action sheet size: 11268x1252
• Base partial alpha: 0
• Action partial alpha: 0
• Base frame border hits: 0
• Action frame border hits: 0
• Base frame empty count: 0
• Action frame empty count: 0
• Base bbox range: 146..263 x 274..290
• Action bbox range: 146..276 x 280..295
• Base bottom range: 303..303
• Action bottom range: 303..303
• Audit status: ok

Completed Verification

• python scripts/assemble-handpaint-shu-infantry-quality-sample.py --source docs\handpaint-batch2-shu-spearman-source-v3.png --stem unit-shu-spearman --work-dir tmp\handpaint-shu-spearman-v3 --output-prefix handpaint-batch2-shu-spearman-v3 --fit-width-scale 1.12 --min-frame-height 274
• pnpm build
• Local browser app load passed at http://127.0.0.1:4173/heros_web/?debug&debugSpritePreview=unit-shu-spearman&v=shu-spearman-v3-final
• Local browser first battle load passed at the same URL.
• Local browser debug sprite preview passed at the same URL.
• Local browser console errors: 0
• Technical alpha/border/bbox inspection passed
• Build and browser verification passed locally.
• Release gate passed after approval.

Quality Note

This v3 candidate replaced v1 and v2 and is approved as the current Shu spearman baseline. v1 had strong spear identity but made the body feel slightly small at 50px; v2 improved stability but still had narrow front-facing silhouettes. v3 widens the front body block, keeps the spear class identity obvious, and better matches the approved Shu infantry v8 scale while preserving the 313px frame format.

Approved because:

• It reads clearly as a spear unit at the 50px battle size.
• It feels close enough to the approved Liu Bei/Guan Yu/Zhang Fei/Rebel/Shu infantry v8 direction.
• The spear line, green Shu armor, helmet, and foot-soldier silhouette read before the background.
• The unit does not look ghostly, transparent, low-resolution, too thin, or like a placeholder.
• The user accepted this as the quality bar for continuing Batch 2 spearmen and the next Shu generic unit.

After approval completed:

• unit-shu-spearman was moved from pendingApproval to approvedBaseline in unit-sprite-rework-manifest.json.
• Audit, review boards, release gate, and build were rerun.
• Next unit: unit-shu-archer.

Reject or request revision if:

• The body still feels too small next to approved Shu infantry v8.
• The spear tip or shaft feels cropped, detached, or too thin at 50px.
• The style is not close enough to the approved first batch and Shu infantry v8 direction.
• The 50px view is not readable enough for live battle play.