[Art][WorkBuddy] Prototype art asset pipeline — sprites, icons, tiles, concept docs

[BotTony329]

Task

• Task ID: ART-001
• Task name: Prototype Art Asset Pipeline
• Owner: WorkBuddy (Art Director / Asset Pipeline Engineer)
• Objective: Deliver all prototype art assets — placeholder sprites, concept documents, specifications, directory structure, and Godot import guide — so Claude can git pull and start development immediately.
• Scope: Art assets only. No game code, no GDScript, no PRD changes, no framework modifications.

Implementation

• Changes: Created complete art asset pipeline for the Nine Nether prototype:

  • 63 placeholder PNG sprites with correct dimensions (horizontal sprite sheets)
  • 8 detailed concept documents covering all characters, enemies, boss, icons, tiles, effects, backgrounds, and UI
  • Master art specification (palette, sizes, naming conventions, standards)
  • Godot 4 import guide with step-by-step instructions
  • Per-directory README.md and metadata.md files with frame counts, sizes, and FPS
  • Naming convention document
  • Placeholder generation script (Python/PIL)
  • Updated AI_HANDOFF.md

• Files changed: 95 files (63 PNGs + 28 docs/config + 4 modified)

• Interfaces used: None (art-only, no code interfaces)

• Core files modified: docs/AI_HANDOFF.md (updated with art pipeline status)

• Architecture implications: None — art assets only, no system/framework changes

Asset Inventory

Category	Files	Details
Player	6 sprite sheets	idle/run/jump/attack/hurt/death (48×48 frames)
Enemies	15 sprite sheets	Ghost Soldier, Ghost Archer, Corpse Beast
Boss	5 sprite sheets	Gate Guardian Ghost General (96×96 frames)
Weapon Icons	6	宋刀/长枪/鬼火/护符/酒葫芦/残破军旗 (32×32)
UI Icons	11	HP/体力/攻击/护甲/暴击/速度/献祭/鬼火/Boss/钥匙/阴钱 (32×32)
Tiles	7	floor/brick/wall/bridge/brazier/tombstone/spike (32×32)
Effects	4	hit_slash/blood_splash/ghost_fire/death_fade (48×48)
Background	4	tree/broken_flag/chains/deep (parallax)
UI Elements	4	health_bar/stamina_bar/frame/minimap_frame

Directory Structure

assets/
├── player/     ← Player sprites + README + metadata
├── enemy/      ← Enemy sprites + README + metadata
├── boss/       ← Boss sprites + README + metadata
├── icons/
│   ├── weapons/ ← Weapon icons + README
│   └── ui/      ← UI icons + README
├── tiles/      ← Tile sprites + README + metadata
├── effects/    ← VFX sprites + README + metadata
├── background/ ← Parallax elements + README + metadata
└── ui/         ← UI elements + README + metadata
docs/
├── ART_SPEC.md ← Master art specification
└── art/        ← All concept docs + guides
godot/
└── import_presets.md ← Godot import settings + SpriteFrames reference
tools/
└── generate_placeholders.py ← Placeholder generation script

Validation

• Tests added or updated: N/A (art assets, no code tests)
• Commands run: python3 tools/generate_placeholders.py — all 63 images generated successfully
• Manual validation: Verified all PNG dimensions match metadata specifications; verified all filenames follow naming convention; verified directory structure matches spec
• Known issues: All PNGs are placeholders (magenta border + checkerboard). They have correct dimensions but need to be replaced with final pixel art before release.
• Handoff notes: Claude should read docs/ART_SPEC.md first, then each directory's metadata.md for sprite sheet frame counts and FPS. All sprite sheets are horizontal strips — use H-Frames in Godot SpriteFrames. Import with Nearest filter, no mipmaps.

Checklist

• Read AGENTS.md
• Read AI_HANDOFF.md
• No direct push to main or develop
• No unrelated refactoring
• No balance values scattered as magic numbers
• Tests added or updated (N/A — art only)
• Existing tests pass (N/A)
• Documentation updated (AI_HANDOFF.md updated)
• Frozen interface changes are explicitly documented (none changed)