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

75 lines
3.7 KiB
Markdown

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