Files
heros_web/docs/unit-sprite-shu-strategist-v2-approval-packet.md

3.7 KiB

Shu Strategist v2 Approval Packet

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

Decision Target

  • Unit: unit-shu-strategist
  • 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: unit-shu-officer
  • 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-strategist-source-v1.png
  • Contact sheet: handpaint-batch2-shu-strategist-v2-contact.png
  • Animation GIF: handpaint-batch2-shu-strategist-v2-animation.gif
  • Previous/v2 comparison: handpaint-batch2-shu-strategist-v2-before-after.png
  • 50px/72px scale comparison: handpaint-batch2-shu-strategist-v2-scale-compare.png
  • Battle-scale map composite: handpaint-batch2-shu-strategist-v2-battle-composite.png
  • Local browser debug sprite preview: handpaint-batch2-shu-strategist-v2-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-strategist.png
  • Action sheet: src/assets/images/units/unit-shu-strategist-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: 156..214 x 282..293
  • Action bbox range: 155..243 x 282..293
  • 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-strategist-source-v1.png --stem unit-shu-strategist --work-dir tmp\handpaint-shu-strategist-v2 --output-prefix handpaint-batch2-shu-strategist-v2 --fit-width-scale 0.96 --min-frame-height 282 --stretch-x 1.12
  • 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-strategist&v=shu-strategist-v2-final
  • Local browser debug sprite preview passed with debugSpritePreview=unit-shu-strategist
  • Local browser console errors: 0
  • Build and browser verification passed locally.

Quality Note

This v2 candidate keeps the v1 hand-painted source but widens the assembled frame enough to pass the 50px battle-readability gate. It is approved because:

  • It has a distinct fan and flowing robe silhouette, separating it from swords, spears, bows, and mounted units.
  • The 50px preview remains readable without bases, rings, glow marks, or completion badges.
  • Idle, walk, command, hurt, and attack frames use clear pose changes while keeping stable bottom alignment.
  • The unit remains inside the 313px frame with no border hits, no partial alpha, and no empty frames.
  • It matches the approved Shu batch style without feeling like a duplicate of Guan Yu or the archer.

Reject or request revision if:

  • The white robe silhouette feels too close to Liu Bei in a dense battle roster.
  • The fan becomes unreadable at 50px during a darker or busier map.
  • The unit appears to drift sideways across idle/walk loops.
  • Any future action frame crops the fan, robe hem, or extended sleeve.