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.mdindex 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.### Breakingdiff --git a/sprite_gen/_modules.py b/sprite_gen/_modules.pyindex 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"),