heros_web/docs/unit-sprite-shu-officer-v1-approval-packet.md

Shu Officer v1 Approval Packet

This packet records the completed Codex-approved unit-shu-officer Batch 2 Shu generic unit.

Decision Target

• Unit: unit-shu-officer
• Batch: Batch 2 Shu generic units
• Status: approved for continuous production run
• Review stage: pending-approval before promotion, then approved-baseline
• Review manifest: unit-sprite-rework-manifest.json
• Art quality gate: unit-sprite-art-quality-gate.md
• Next unit after approval: none in the current Batch 2 queue
• 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-officer-source-v1.png
• Contact sheet: handpaint-batch2-shu-officer-v1-contact.png
• Animation GIF: handpaint-batch2-shu-officer-v1-animation.gif
• Previous/v1 comparison: handpaint-batch2-shu-officer-v1-before-after.png
• 50px/72px scale comparison: handpaint-batch2-shu-officer-v1-scale-compare.png
• Battle-scale map composite: handpaint-batch2-shu-officer-v1-battle-composite.png
• Local browser debug sprite preview: handpaint-batch2-shu-officer-v1-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-officer.png
• Action sheet: src/assets/images/units/unit-shu-officer-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: 161..206 x 288..295
• Action bbox range: 161..238 x 282..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-officer-source-v1.png --stem unit-shu-officer --work-dir tmp\handpaint-shu-officer-v1 --output-prefix handpaint-batch2-shu-officer-v1 --fit-width-scale 0.96 --min-frame-height 282
• Technical alpha/border/bbox inspection passed
• python scripts/audit-unit-sprite-sheets.py
• pnpm build
• Local browser URL: http://127.0.0.1:4173/heros_web/?debug&debugSpritePreview=unit-shu-officer&v=shu-officer-v1-final
• Local browser debug sprite preview passed with debugSpritePreview=unit-shu-officer
• Local browser console errors: 0
• Build and browser verification passed locally.

Quality Note

This v1 candidate replaces the old cropped Shu officer placeholder with a heavier armored field officer sprite that reads as a command unit rather than a basic soldier. It is approved because:

• The deep green cloak, bronze armor, red-gold sash, and command baton form a clear officer silhouette at 50px.
• It separates from the approved infantry and spearman by posture and command equipment, and from the strategist by armor weight.
• It does not rely on bases, rings, glow marks, or completion badges to be readable.
• Idle, walk, command, hurt, and victory poses show meaningful frame differences while keeping stable bottom alignment.
• It remains inside the 313px frame with no border hits, no partial alpha, and no empty frames.

Reject or request revision if:

• The officer starts to read as a named hero rather than a generic elite officer.
• The command baton or cloak tassels are cropped in future revisions.
• The 50px view feels too close to Liu Bei or Guan Yu in dense formations.
• Idle or walk loops visibly drift sideways in gameplay.