---
name: i18n-add
description: Use whenever adding a new user-facing string to ClassPin. Generates ko/en/zh translations and inserts them into constants.tsx. Trigger on any JSX that needs a new i18n key.
---

# i18n-add — ClassPin 번역 추가 스킬

## 사용 방법

`/i18n-add <key> <한국어 원문>`

예시: `/i18n-add boardArchived 보드가 보관되었습니다.`

---

## 실행 프로토콜

### Step 1: 키 중복 확인
`constants.tsx`의 `i18n.ko` 섹션에서 `<key>`가 이미 존재하는지 검색한다.
- 이미 존재하면 기존 값을 보여주고 중단한다.
- 없으면 계속 진행한다.

### Step 2: 번역 생성
입력된 한국어 원문을 바탕으로 en/zh 번역을 생성한다.

번역 품질 기준:
- **영어 (en):** 자연스러운 UI 문구. 짧고 명확하게.
- **중국어 (zh):** 간체자(Simplified Chinese). 교육 앱 맥락에 맞게.

### Step 3: constants.tsx 삽입
`constants.tsx`의 `i18n` 객체 안 **ko, en, zh 세 곳 모두**에 동일한 키를 추가한다.

삽입 위치: 각 언어 블록의 **마지막 키 바로 앞** (언어 블록 끝에서 두 번째 줄).

삽입 형식:
```
<key>: '<번역값>',
```

### Step 4: 검증
삽입 후 ko/en/zh 세 곳에 키가 있는지 Grep으로 확인한다.

---

## 규칙

- **절대 일부만 추가하지 않는다** — ko만 추가하거나 en을 빠뜨리면 안 된다.
- 키 이름은 camelCase로 작성한다.
- JSX에서의 사용법도 함께 출력한다: `{t('<key>')}`
- 추가 후 반드시 3개 언어 모두 확인 메시지를 출력한다.

---

## 출력 형식

```
✅ 번역 키 추가 완료: <key>

ko: <한국어>
en: <영어>
zh: <중국어>

JSX 사용법: {t('<key>')}
```