Files
heros_web/docs/unit-sprite-shu-archer-v5-approval-packet.md

4.1 KiB

Shu Archer v5 Approval Packet

This packet records the completed agent-approved unit-shu-archer Batch 2 Shu generic unit.

Decision Target

  • Unit: unit-shu-archer
  • Batch: Batch 2 Shu generic units
  • Status: approved
  • 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-cavalry
  • 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-archer-source-v5.png
  • Contact sheet: handpaint-batch2-shu-archer-v5-contact.png
  • Animation GIF: handpaint-batch2-shu-archer-v5-animation.gif
  • v4/v5 comparison: handpaint-batch2-shu-archer-v5-before-after.png
  • 50px/72px scale comparison: handpaint-batch2-shu-archer-v5-scale-compare.png
  • Battle-scale map composite: handpaint-batch2-shu-archer-v5-battle-composite.png
  • Local browser title check: handpaint-batch2-shu-archer-v5-browser-check.png
  • Local browser first battle check: handpaint-batch2-shu-archer-v5-battle-browser-check.png
  • Local browser debug sprite preview: handpaint-batch2-shu-archer-v5-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-archer.png
  • Action sheet: src/assets/images/units/unit-shu-archer-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: 158..260 x 284..295
  • Action bbox range: 152..260 x 276..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-archer-source-v5.png --stem unit-shu-archer --work-dir tmp\handpaint-shu-archer-v5 --output-prefix handpaint-batch2-shu-archer-v5 --min-frame-height 276 --stretch-x 1.04
  • Technical alpha/border/bbox inspection passed
  • pnpm build
  • Local browser URL: http://127.0.0.1:4173/heros_web/?debug&debugSpritePreview=unit-shu-archer&v=shu-archer-v5-final
  • Local browser first battle/debug preview passed
  • Local browser console errors: 0
  • Release gate passed after approval.
  • Build and browser verification passed locally.

Quality Note

This v5 candidate replaced v4 and was approved as the current Shu archer baseline. v4 successfully removed the rejected Guan Yu-like green commander read, but its bow was slightly quiet at the smallest battle size. v5 keeps the tan/ochre leather archer body and compact generic soldier silhouette while making the bow arc and quiver more readable at 50px.

This sample was approved because:

  • It reads clearly as a bow unit at the 50px battle size.
  • It no longer feels like a miniature Guan Yu or named green-robed officer.
  • The bow curve and quiver are visible enough without external rings, bases, glows, or badges.
  • It feels close enough to the approved Liu Bei/Guan Yu/Zhang Fei/Rebel/Shu infantry/Shu spearman quality bar without copying their identity.
  • The unit does not look ghostly, transparent, low-resolution, too thin, or like a placeholder.
  • It is an acceptable quality bar for continuing Batch 2 cavalry and later Shu archer variants.

After approval completed:

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

Reject or request revision if:

  • The bow silhouette is not readable enough at 50px.
  • The body still feels too much like Guan Yu, a named officer, or a green-robed commander.
  • The bow or arrow feels cropped, detached, or too thin at 50px.
  • The style is not close enough to the approved Batch 2 direction.