Sprite Gen
Two user entry points: make sprites or make an image. Existing generation, extraction and export tools do the work; the user chooses the result and provider.
Start every generation request here
Read user-workflow, then run the appropriate read-only guide:
$SPRITE_GEN_ROOT/.venv/bin/sprite-gen workflow --kind sprite
$SPRITE_GEN_ROOT/.venv/bin/sprite-gen workflow --kind image
Pass choices already stated in the request. The guide checks access, combines explicit choices with saved defaults, and returns only missing questions. Follow its start and finish stages. Always pass the resolved provider explicitly to generation tools. Deliver checked files before offering the curation view; save defaults only when the user agrees. The complete conversation and settings contract is owned by the linked document, not duplicated in individual pipeline docs.
Execution routes
| Task | Entry | Contract |
|---|---|---|
| GPT image sprites | prepare, gen-set --provider codex, extract, compose and QA |
atlas-workflow |
| Grok video sprites | video-set |
video-pipeline |
| Ordinary image or edit | gen --provider codex or gen --provider grok |
gen |
| Base and direction anchors | anchor |
directional-anchor-workflow |
| Curation view or existing image candidates | curation, unpack-atlas --pngs-dir |
curation |
| Uniform background removal or imported sheets | cutout, slice-sheet |
sheet-slicing |
| Palette swap | sprite-gen recolor-palette, sprite-gen recolor |
recolor |
| Rig layer composition | sprite-gen compose-layers |
layer-tracks |
| Idle breathing | curation choice, baked by compose | breathing |
| Engine exports | export-aseprite, export-pngs |
engine-export |
| Defaults | defaults show, defaults save, defaults clear |
user-workflow |
Use existing automatic pipeline stages for background removal, extraction, alignment and export. Do not ask users to select each script. For a direct utility request, run that utility; no unrelated generation questions are needed. Preserve the row pipeline and component extraction for image sprites. One-shot grid generation and fixed cell cutting are not an alternative sprite-generation route.
실행 인터프리터
SPRITE_GEN_ROOT is the absolute installed repository path. Use $SPRITE_GEN_ROOT/.venv/bin/sprite-gen or $SPRITE_GEN_ROOT/.venv/bin/python; do not assume an activated shell. 폴백 금지: create a missing venv or report the failure, never use an arbitrary global Python. NumPy 가 없는 인터프리터 fails at package import. Setup and diagnosis: interpreter.
Contracts and advanced tools
run-contract owns numeric requests, run layout, atomic publication and curated exports. architecture explains domain ownership. docs index lists every specialized feature and QA procedure. sprite-gen --help derives the command map from the package catalog. Never replace canonical extraction with temporary crop scripts while presenting the result as a pipeline output.
