imagine-icon

imagine-icon

한 번의 호출로 iOS / Android adaptive / Web(favicon+PWA) 아이콘 세트를 산출한다. 마스터 생성은 AI, 리사이즈·레이아웃은 결정적 후처리다.

트리거

• imagine-icon "<컨셉>" / imagine-icon export <master.png> (명시 호출)
• "앱 아이콘 만들어줘"
• "favicon 만들어줘"
• "런처 아이콘", "launcher icon"
• "PWA 아이콘"
• "아이콘 세트 뽑아줘"

파이프라인

1. 마스터 생성 (AI): generate_size: 1024x1024 PNG로 Codex 이미지 모델 호출.
2. 프롬프트 구성: config.prompt_template의 고정 문구 + 사용자 컨셉 키워드만 조합. 제목·앱 이름을 프롬프트에 넣지 않는다. 4가지 variation_directions(minimal / 3d-glossy / flat-illustration / abstract-geometric) 중 --variation 지정이 없으면 기본 1장만 생성(--n 4로 4종 배치 생성 가능).
3. 세이프존 검증 (결정적): 마스터 PNG의 중앙 60% 박스 밖에 핵심 콘텐츠가 얼마나 있는지 픽셀 비율로 계산. quality_checks.safe_zone_overflow_max_ratio 초과 시 사용자에게 경고.
4. Alpha 검증: Android foreground는 배경 투명이어야 함 → PNG alpha 채널 검사, 전면 알파 0 픽셀이 없으면 "투명 배경 요청이 반영되지 않았을 수 있다" 경고.
5. 사이즈 익스포트: scripts/lib/icon-exporter.js의 exportSizes(masterPath, targets, outputDir, options) 호출. sharp 있으면 Lanczos3, 없으면 pngjs 박스 평균 폴백(작은 사이즈 품질 저하 경고).
6. 리포트 작성: _report.md에 각 파일 경로·resize 엔진·경고 요약.

출력 규약

./images/icons/<app-slug>/
├── master.png                     (1024×1024)
├── ios/
│   └── AppIcon-1024.png
├── android/
│   ├── ic_launcher_foreground.png   (512 canvas, 432 foreground, transparent)
│   └── ic_launcher_background.png   (512 solid color)
├── web/
│   ├── favicon-16.png
│   ├── favicon-32.png
│   ├── favicon-48.png
│   ├── apple-touch-icon-180.png
│   ├── pwa-192.png
│   └── pwa-512.png
├── manifest.webmanifest            (PWA, 선택)
└── _report.md

• <app-slug>는 사용자 컨셉에서 slugify. --out-dir 지정 시 그대로 사용(조용히 변경 금지).
• 루트 ./images/ 직하 쓰기 금지.

마스터 프롬프트 규약

다음 문구를 그대로 프롬프트에 포함한다 (config.prompt_template):

app icon, single focal motif, centered composition, 15% padding safe zone,
bold silhouette recognizable at small size, solid background or simple gradient,
no text

• 앱 이름·브랜드 문구는 프롬프트에 넣지 않는다. 아이콘에 글자가 새겨지는 것을 원천 차단.
• Negative prompt 강제: text, letters, typography, multiple objects, cluttered detail, photorealistic, watermark, logo text.
• --variation으로 방향성 지정:
  • minimal: minimal flat vector style, limited palette (≤3 colors), geometric primitives only
  • 3d-glossy: soft 3D rendering, subtle glossy highlight, studio lighting, rounded volumes
  • flat-illustration: flat illustration, solid shapes, decorative but legible at 16px
  • abstract-geometric: abstract geometric composition, bold shapes, strong silhouette