feat: update instructions

2026-02-25 12:48:02 +07:00
parent 04848d2921
commit b09c034c99
3 changed files with 78 additions and 0 deletions
@@ -49,6 +49,17 @@ node <skill-dir>/banatie-gen.mjs \

 The reference image gives the AI a visual anchor (composition, colors, overall shape) while the prompt steers it toward the desired changes. This produces much better results than generating from scratch with a new prompt, because the output stays visually consistent with the original.

+## Reference Image Policy
+
+**Never add `--ref` silently when creating a new image.** The rules:
+
+1. **User explicitly provides a ref** (file path or @alias) → use it
+2. **Modification mode** (user gives feedback on an existing image) → use the existing image as ref automatically
+3. **New image, similar assets exist nearby** → **ask the user first**: "I see [filename] in the same folder. Would you like to use it as a reference for visual consistency, or generate from scratch?" Do not assume.
+4. **New image, no similar context** → generate from scratch, no ref
+
+The project's CLAUDE.md may override this policy with project-specific ref rules (e.g. "always use X as ref for assets in folder Y"). If CLAUDE.md provides ref guidance, follow it without asking.
+
 ## Workflow

 1. **Determine the mode.** Is this a new image or a modification of an existing one? If the user gives feedback on a recently generated image or asks to change something about an existing file, use modification mode.