Make Store Assets

---
name: make-store-assets
summary: 로고 · 썸네일 · IAP 아이콘을 규격대로 만든다.
when: 심사 신청 전 스토어 에셋이 없거나 규격이 어긋났을 때.
---

# make-store-assets

## 먼저 지금 상태를 본다

```bash
pnpm assets
```

무엇이 비었고 무엇이 틀렸는지 알려준다. **여기서 시작하지 않으면 이미 있는 것을
덮어쓴다.** 사람이 직접 만들어 넣은 로고가 있을 수 있다.

## 근거를 모은다

프롬프트를 지어내지 마라. 이 순서로 읽는다.

| 어디 | 무엇을 얻는가 |
| --- | --- |
| `specs/` | 이 앱이 무엇을 하는 앱인지 |
| `apps/miniapp/granite.config.ts` | `brand.primaryColor` — 로고 색의 출발점 |
| `inbox/*/INVENTORY.md` | 사람이 넘겨준 기존 로고 · 브랜드 가이드 |
| `assets/SOURCES.md` | 전에 무슨 프롬프트로 만들었는지 |

근거가 하나도 없으면 **만들지 말고 물어봐라.** "무슨 앱인지 모르겠는데 로고를 만들어
봤습니다" 는 시간 낭비다.

## 만든다

```bash
pnpm imagegen --kind icon      --prompt "<장면 설명>"
pnpm imagegen --kind thumbnail --prompt "<장면 설명>"
pnpm imagegen --kind icon-dark --prompt "<장면 설명>"
pnpm imagegen --kind iap-icon --name <상품키> --prompt "<장면 설명>"
```

한 명령이 생성 · 규격 맞춤 · 출처 기록을 다 한다. codex 를 직접 부르지 마라.

### 프롬프트 쓰는 법

**넣을 것**

- 하나의 주제. 로고에 이것저것 담으면 16×16 으로 줄었을 때 아무것도 안 보인다
- 여백. 토스는 로고를 둥근 사각형으로 잘라 쓴다 — 가장자리에 붙은 요소는 잘린다
- 밝은 배경. 목록 배경이 밝다

**넣지 말 것**

- **글자.** 이미지 모델은 한글을 제대로 못 쓴다. 앱 이름은 콘솔이 따로 얹는다
- 사람 얼굴 · 신분증 · 실존 브랜드 로고
- 토스 UI 를 흉내 낸 화면 (스크린샷으로 오해받는다)
- 다른 앱과 헷갈릴 만한 것

`--style` 로 결을 바꿀 수 있지만, 기본값이 TDS 결에 맞춰져 있으니 이유 없이 바꾸지 마라.

### 종류별로

| 종류 | 무엇을 담나 |
| --- | --- |
| `icon` 600×600 | 앱을 한 단어로 요약하는 심볼 하나. 작아져도 알아볼 수 있어야 한다 |
| `icon-dark` 600×600 | 같은 심볼, 어두운 배경에서 안 묻히게. 앱 UI 의 다크 모드와 무관하다 |
| `thumbnail` 1932×828 | 상세 페이지 상단 배너. 가로로 길어서 로고를 그대로 늘리면 안 된다 |
| `iap-icon` 1024×1024 | 상품 하나를 나타내는 심볼. 상품마다 따로 |

## 확인한다

```bash
pnpm assets
```

`규격 통과` 가 나와야 끝난 것이다. 안 나오면 `pnpm assets fit <파일>` 로 맞추거나
프롬프트를 바꿔 다시 생성한다.

## codex 를 쓸 수 없으면

**다른 이미지 모델을 찾지 마라.** 이 순서로 폴백한다 (ADR-0002).

1. 이미지 없이 진행 — 단, 로고와 썸네일은 심사 신청에 필수라 언젠가는 필요하다
2. 사람에게 요청 — `assets/` 에 넣어 달라고 하고, `pnpm assets fit` 으로 규격만 맞춘다
3. 웹 검색 — 라이선스가 명확한 것만. `assets/SOURCES.md` 에 라이선스를 반드시 적는다

## 출력

- 만든 파일 · 해상도 · 쓴 프롬프트
- 아직 비어 있는 필수 항목
- 사람이 봐야 할 것: **"작게 줄여도 알아볼 수 있는지 확인해 주세요"**
  (16×16 으로 줄었을 때 뭉개지는지는 기계가 판정할 수 없다)