feat: update instructions

2026-02-25 12:48:02 +07:00
parent 04848d2921
commit b09c034c99
3 changed files with 78 additions and 0 deletions
@@ -0,0 +1,57 @@
+# Asteroid Asset Generation Rules
+
+## Style overview
+
+The set has two tiers:
+
+**Single-piece asteroids (asteroid1–asteroid9)** — each is a standalone rock with its own unique shape and crack color. They serve as style sources for multi-piece variants.
+
+**Multi-piece asteroids (asteroid10–asteroid14)** — compact clusters of 3 pieces tightly pressed together. Each one inherits its style from a corresponding single-piece asteroid.
+
+## Style map
+
+| File | Shape type | Crack color | Style source |
+|------|-----------|-------------|--------------|
+| asteroid1 | round sphere | orange/amber | — |
+| asteroid3 | flat angular boulder | red glowing | — |
+| asteroid5 | tall elongated shard | purple/magenta | — |
+| asteroid7 | flat horizontal disc | pink/purple | — |
+| asteroid9 | tall spire with spikes | cyan/blue | — |
+| asteroid11 | 3-piece cluster | red (from asteroid3) | asteroid3 |
+| asteroid12 | 3-piece cluster | orange/golden (from asteroid1) | asteroid1 — **ideal composition reference** |
+| asteroid13 | 3-piece cluster | purple/magenta (from asteroid5) | asteroid5 |
+
+## Rules for generating new multi-piece asteroids
+
+### Composition
+- Always 3 pieces of **different sizes** tightly pressed together
+- Pieces must touch each other — no gaps, no space between them
+- The cluster must read as one compact object, not a scattered group
+- Vary the arrangement: triangle, stacked, side-by-side — avoid repeating the same layout
+
+### Style
+- Use `--ref` with the corresponding single-piece asteroid (not asteroid12)
+- Do not use `--template illustration` — it makes cracks too prominent and overrides the source style
+- Use the default `--template general`
+- Crack color, surface texture, and painting style must come from the reference
+
+### What to avoid
+- No floating debris or separate small fragments
+- No explosion effects
+- No atmospheric glow, energy bursts, or lightning spread outward from the object
+- No changing the crack color relative to the reference (e.g. if the ref has red cracks, the output must have red cracks — not orange, not purple)
+
+## Generation command pattern
+
+```bash
+node .claude/skills/gen-image/banatie-gen.mjs \
+  --prompt "three dark rocky asteroid pieces of different sizes tightly pressed together, <crack description from ref>, painterly art style, white background, compact cluster no gaps between stones, varied shapes and sizes" \
+  --output assets/items/asteroids/asteroidN.png \
+  --ref assets/items/asteroids/asteroidX.png
+```
+
+Where `asteroidX` is the style source from the table above.
+
+## Approved reference for composition
+
+**asteroid12.png** is the approved example of correct multi-piece composition: compact, no gaps, pieces vary in size, reads as one unit. Use it as a visual benchmark when evaluating new generations — but do NOT add it as `--ref` alongside the style source, as it will pull the style toward orange/golden.