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

85 lines
4.1 KiB
Markdown

# 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.