| name | nt-asset-image-generation |
| description | Use ONLY after a source-first search (shared asset library + free CC0/OFL sources) finds no fit, to generate real raster art for AI Studio asset workflows: fake shots, icon/source sheets, sprites, UI art, or source images for later asset tools. Generation is the last resort, not the default. Prefer Codex CLI imagegen via `codex exec` and `scripts/codex_imagegen.sh`; use Antigravity/agy CLI only as fallback. Owns raster creation only; nt-asset-workflow coordinates asset tools, catalog/intake handoff, and ai_studio/quality visual acceptance. |
NT Asset Image Generation
Use when the agent must create real raster game art for an asset workflow but
has no native image model. Generate, verify the PNG, then hand off to
nt-asset-workflow.
Load Only What Applies
references/generation-paths.md: Path A codex exec, Path B agy, compare
mode, Path C REST/backend, START=$(date +%s), exact commands.references/verification-and-prompts.md: real raster forcing, size/eyeball
checks, composable prompts, Dead-ends, gemini CLI, GEMINI_API_KEY,
NODE_OPTIONS=--use-system-ca.references/throughput-and-handoff.md: batches, source-sheet workflow,
declarative pack configs (expand_jobs -> gen_batch -> slice_pack for
axis/grade families), sidecars, nt-asset-workflow handoff, and quality
evidence.
Source First (before generating)
Generation is the last resort. First run
node ai_studio/assets/catalog/search.mjs --query <need>: reuse a library hit,
or search free CC0/OFL sources and intake one. Only generate what you could not
source, and record the source decision in the task or game-owned asset notes.
Default Route
- Use Path A first:
codex_imagegen.sh.
- If Path A is unavailable or suspect, read verification guidance before
retrying or falling back.
- Use Path B
agy only as fallback or comparison.
- Use Path C only when Path A is broken or REST features/high volume are
explicitly needed.
- Pick the PNG off disk; keep raw generations in
tmp/; move only accepted
assets into durable folders.
Non-Negotiables
- Generate a real raster image; do not write/run drawing code, SVG, PIL,
ImageMagick, System.Drawing, shapes, or vectors.
- Never trust the delegated CLI transcript. Verify size and look at the PNG.
- Treat file size only as a fake detector, not as quality proof.
- Do not retry known dead-ends; use documented wrappers and gotchas.
- Generate composable runtime parts unless the task asks for a fake shot/review.
- Clean source images are not enough: assembled screens still need selected
quality-rule evidence.
Canvas Handoff (mandatory)
Every ACCEPTED generation lands on a canvas project (ai_studio/assets/canvas/
ops — CLI or direct import), never only in loose files:
- Pick the task-appropriate canvas: the current game's draft canvas, or the
canvas the task names. If none fits, CREATE a new canvas project titled
after the task (
cli.mjs create --title "<task>").
- Add with full provenance
meta: {origin: "ai", tool, prompt, refs, generated, license}. Sourced (non-generated) images get {origin: "sourced", source: <url/path>, license} instead. The prompt must never be
lost — the canvas element is its durable home.
- Raw rejects stay in
tmp/; only accepted results go onto the canvas.
- Generation placeholders land with NO alpha (raw art only). If the accepted
result needs a transparent background and it is on a flat light backdrop,
do NOT hand-build a white/black plate pair yourself — run the canvas op
alpha-dual-generate <projectId> --element <eid> (T0238): it generates the
missing dark plate via a codex edit, gates the pair, and mints one new cut
element beside the source in one call. See
ai_studio/assets/canvas/README.md ("Automatic dual-plate generation").
Minimal Report
State path used, output PNG, size/fake check, visual judgment, canvas project
and element id, handoff path, and rejected attempts or fallbacks.
