# Batch 2 Shu Spearman Production Spec

Use this only after `unit-shu-infantry` v3 is approved.

## Target

- Unit key: `unit-shu-spearman`
- Batch: Batch 2 Shu generic units
- Role: generic Shu spear infantry
- Style reference:
  - `unit-liu-bei`
  - `unit-guan-yu`
  - `unit-zhang-fei`
  - `unit-shu-infantry` v3
- Required output sheets:
  - `src/assets/images/units/unit-shu-spearman.png`
  - `src/assets/images/units/unit-shu-spearman-actions.png`

## Visual Direction

- Must read as a spear unit at 50px battle scale.
- Long spear silhouette should be visible in every side-facing combat/walk frame.
- Body should be broad enough to match the v3 infantry quality bar, but slightly leaner than Zhang Fei.
- Use green Shu cloth/armor with bronze/gold plates, dark outline, and large readable color blocks.
- Use a sturdy foot-soldier stance, not a unique hero pose.
- Keep the spear contained inside each 313px frame; no detached shaft/tip fragments.
- Do not solve readability with base rings, badges, glows, or UI decoration.

## Source Image Prompt

```text
Use case: stylized-concept
Asset type: production source image for a tactical RPG unit sprite sheet
Primary request: Create a high-quality hand-painted raster contact sheet for ONE Shu spearman unit, in the same production style as the approved Shu infantry v3 sample but clearly differentiated by a long spear silhouette.
Scene/backdrop: perfectly flat solid #ff00ff chroma-key background only, no shadows, no floor plane, no texture, no text.
Subject: original Three Kingdoms-inspired Shu spear infantry, not Guan Yu, not Zhang Fei, no copyrighted game assets, no logos. Green-and-bronze lamellar armor, long spear/qiang, compact round or small strapped shield only if it does not obscure the spear, sturdy boots, dark hair topknot or helmet, small cloak/tabard. The character should look like an elite generic Shu spear soldier.
Style/medium: premium hand-painted pixel-adjacent raster game art, bold dark ink outline, large readable color masses, crisp opaque body shapes, subtle painted armor highlights, tactical RPG battle sprite source art.
Composition/framing: 6 columns by 2 rows contact sheet, twelve separate full-body frames, each frame centered with generous padding and the entire spear visible. No cropping. Keep each figure around 78-84% of its cell height with stable body scale and ground position across all frames.
Frames left to right, top row: front idle with spear upright, front walk step, east walk side with spear angled forward, back walk with spear visible behind shoulder, west walk side mirrored pose, attack windup with spear pulled back. Bottom row: spear thrust with readable forward line, sweeping spear slash, command gesture, item/strategy gesture, hurt recoil, victory pose.
Animation constraints: each frame should be newly drawn with natural pose differences in arms, legs, spear, cloak and cloth folds, but body size must remain stable. Idle should not twist sideways. Walk frames should not drift far horizontally. Action frames must stay inside their cell.
Readability constraints: at 50px game scale the spear line, green Shu armor, and infantry body block must read before the background. Use thicker silhouette, deeper shadows, stronger outline, fewer tiny details, clear weapon shape.
Avoid: thin line art, transparent body pixels, ghostly low opacity, tiny head, overly realistic painting, chibi proportions, blurred edges, cropped spear tip, detached spear fragments, labels, captions, watermarks, UI, grid lines, checker backgrounds, duplicated identical frames.
```

## Expected Artifacts

- Source: `docs/handpaint-batch2-shu-spearman-source-v1.png`
- Contact sheet: `docs/handpaint-batch2-shu-spearman-contact.png`
- Animation GIF: `docs/handpaint-batch2-shu-spearman-animation.gif`
- Previous/new comparison: `docs/handpaint-batch2-shu-spearman-before-after.png`
- Battle-scale comparison: `docs/handpaint-batch2-shu-spearman-scale-compare.png`
- Battle map composite: `docs/handpaint-batch2-shu-spearman-battle-composite.png`
- Report: `docs/handpaint-batch2-shu-spearman-report.md`

## Validation Targets

- Base partial alpha: `0`
- Action partial alpha: `0`
- Base frame border hits: `0`
- Action frame border hits: `0`
- Base sheet size: `5008x1252`
- Action sheet size: `11268x1252`
- `unit-shu-spearman` must appear as `ok` in `docs/unit-sprite-rework-audit.json`
- `unit-sprite-review-batch2-shu.png` must show `unit-shu-spearman` as visually stronger than the old placeholder.