# AI Asset Generation

## Goal

Allow a request such as “Create a marble astronomical instrument for the Observatory” to produce an insertable reference asset without manual stylistic repair.

## Generation packet

An image model receives:

1. canonical identity, category, subtype, Purpose and intended interactions;
2. the four Commons primary references and two nearest accepted Components;
3. projection, world dimensions, footprint, orientation and anchors;
4. palette roles, material profiles, ornament family and detail tier;
5. neutral authoring light, emission, shadow and light-receiving behavior;
6. required transparent RGBA output, safe margin and resolution;
7. enumerated orientation and state variants;
8. explicit non-Kiduna failure modes;
9. validation thresholds and Scene insertion fixtures.

## Prompt template

```text
Asset: <canonical name>
Category / subtype: <schema values>
Purpose: <why it exists>
References: Commons 01–04; <nearest accepted components>
Projection: 2.5D isometric, 2:1 basis
Dimensions: <x × y × z WU>
Footprint: <shape and size>
Orientation: <required variants>
Anchors: placement, interaction, shadow, focus, <typed attachments>
Materials: <canonical material IDs>
Palette roles: <approved roles>
Light: warm upper-left key; cool upper-right fill; separable contact shadow
State: <idle plus requested states>
Detail tier: <focal / interactive / supporting / distant>
Output: RGBA PNG; real transparent alpha; safe margin; no text
Avoid: game icon, visible tile, cartoon, glossy pack, generic fantasy,
       simulated checkerboard, incompatible baked background light
Validation: all hard gates; ≥88/100; fixtures <A> and <B>
```

## Output checks

- PNG color type must include alpha and at least one pixel must have alpha below 255.
- Alpha edges must not include checkerboard, white fringe or premultiplied dark halo.
- Pixel dimensions, safe margin and logical orientation must match the packet.
- Contact shadow must be soft, separable or reconstructible.
- No scene-specific horizon or background color may be baked into a portable Component.

## Iteration

Change one variable at a time. Preserve accepted geometry, identity, lighting and materials while correcting the named defect. A regenerated image receives a new asset version and validation Record.

## Provenance

Record model/tool, date, prompt, reference asset IDs, human selections, edits, rights, checksum and validation result. Generated imagery never replaces the untouched primary references.