Skip to content

Generate clean 2D game sprites & animation atlases — component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.

docs: name the two catalogs precisely

Soohong Kim725ff0e7c57d
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 339217a..30724c8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,7 +8,7 @@ All notable public changes to `sprite-gen` are recorded here. Versions track the
- **Video → sprite loops.** One still becomes a whole motion set: `video-canvas` pads it into the canvas the state needs, `video` animates it in place through Grok Imagine, `video-frames` keys every frame, `video-loop` finds the true period (or the one performed action) and emits a strip, a transparent GIF and a WebP, and `video-set` runs directions × states with per-item reports. Every stage is measured and fails by name.
- **Parallel row generation is a command.** `gen-set` generates every state row of a prepared run N at a time with the run's own identity ref, one report per row, a table and a non-zero exit on any failure — what the skill used to describe in prose.
-- **One taxonomy.** `sprite-gen --help` opens with the four named pipelines (A atlas rows · B video → loop · C utilities · D post-processing) and groups every verb by domain; the grouping, the `scripts/` map and the docs index all derive from `sprite_gen/_modules.py`.
+- **One taxonomy.** `sprite-gen --help` opens with the four named pipelines (A atlas rows · B video → loop · C utilities · D post-processing) and groups every verb by domain; the grouping, the `scripts/` map and the pipeline list derive from `sprite_gen/_modules.py` (`MODULE_DOMAIN`, `PIPELINES`), and the docs classification is catalogued in `docs/README.md` itself, checked by tests against the file set and the pipeline catalog.
- **Documentation you can navigate.** `docs/README.md` indexes every doc once under its branch with a one-line owner; `docs/architecture.md` opens with a domain diagram and a four-pipeline diagram; the largest docs carry a table of contents; the repo README shrinks to an entry page and the sections it carried live in the docs that own them.
### Breaking
diff --git a/sprite_gen/_modules.py b/sprite_gen/_modules.py
index e82718a..06edf3c 100644
--- a/sprite_gen/_modules.py
+++ b/sprite_gen/_modules.py
@@ -48,9 +48,10 @@ MODULE_DOMAIN = {
}
-# Display order and one-line meaning of each domain — the taxonomy the CLI help, the
-# scripts map and the docs index enumerate from. Adding a module to MODULE_DOMAIN puts it
-# in its group; nothing else needs a hand edit.
+# Display order and one-line meaning of each domain — the taxonomy the CLI help and the
+# scripts map enumerate from (the docs classification is catalogued in docs/README.md and
+# tested against the file set). Adding a module to MODULE_DOMAIN puts it in its group;
+# nothing else needs a hand edit.
DOMAINS: list[tuple[str, str]] = [
("gen", "Generation — prepare a run, generate stills / rows / clips"),
("video", "Video → loop — canvas, keyed frames, seamless cycle, batch"),