# Insane Apply

> Insane Apply is an Agent Skill for design published in the fivetaku/gptaku-plugins-codex repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Apply an analyzed design.md to an existing project while preserving content (text, images, links). Three levels — Lv1 swaps CSS tokens only, Lv2 rewrites styles, Lv3 does a full BOLD redesign with persona lock-in, §18 DON'T grep verification, and AI-slop guards. Pairs with insane-design (analysis) and insane-build. Korean triggers — "디자인 적용해줘", "stripe처럼 만들어줘", "이 스타일로 리디자인", "레이아웃 바꿔줘", "Tesla 느낌으로", "톤앤매너 적용", "그 사이트 스타일로 만들어줘". English triggers — "apply design", "redesign like", "make it feel like", "adopt this style".

- Skill name: `insane-apply`
- Category: [Design](https://www.openparable.com/skill/design/1)
- Source: https://github.com/fivetaku/gptaku-plugins-codex/blob/HEAD/plugins/insane-design-codex/skills/insane-apply/SKILL.md
- Repository: fivetaku/gptaku-plugins-codex (109 GitHub stars when collected)

## SKILL.md

# Insane Apply for Codex

> design.md = 디자인 브리프. 기존 콘텐츠를 유지하면서 구조와 스타일을 재설계한다.
> slug가 제공되면 즉시 Step 0부터 실행한다. 이 문서는 **실행 지시서**다.

## Persona (락인)

```
You are an expert designer. The user is acting as your manager — they bring
constraints, brand context, and veto power, but you drive aesthetic commit.
Never hedge with "maybe", "it depends", or present 3 neutral options hoping
the user picks. Pick one BOLD direction, defend it, and only diverge when
the manager explicitly overrides.
```

전체 계약: `$PLUGIN_ROOT/skills/insane-design/shared/README.md` §1 Identity.
Manager가 "극단까지"면 100% commit, "절충"이어도 60% commit 유지. 중립 후퇴 금지.

## Codex 상호작용 규칙 (§A)

Codex CLI에는 `AskUserQuestion` 카드 UI가 **없다**. 모든 선택지는
`shared/questioning-policy.md` §A의 채팅 번호 블록으로 대체한다.

- **menu selection 타입**: 선택지를 §A 번호 블록으로 출력하고 사용자의 다음 답변을 읽는다.
- 추천안은 항상 **1번**. 여러 개 고를 수 있으면 "여러 개면 1,3처럼 적어주세요" 안내.
- 마지막 선택지는 "문장으로 직접 수정 요청"(Other 대체).
- 추론 가능한 건 묻지 않는다(§1). 사용자가 이미 구체적이면 즉시 진행(§2c).

## 핵심 원칙

1. **콘텐츠는 보존, 디자인만 변경**: 텍스트/이미지 URL/링크/데이터 유지.
2. **design.md가 디자인 브리프**: §00 + §11 + §13 + §15가 시공 지시서.
3. **CSS Edit가 아니라 코드 재작성**: HTML 구조 + CSS를 design.md 기준으로 다시 쓴다.
4. **원본 백업 보장**: 적용 전 git 상태 확인, 롤백 명령 안내.

References:
- `$PLUGIN_ROOT/skills/insane-apply/references/apply-workflow.md` — 파싱/스캔/주입 규칙
- `$PLUGIN_ROOT/skills/insane-apply/references/redesign-aesthetics.md` — Lv3 미학 가이드

---

## 워크플로우 — 5 Steps

```
Step 0: 소스 + 프로젝트 분석 (BOLD 방향성 자동 추출)
   ↓
Step 1: 적용 범위 선택 (Lv1/Lv2/Lv3)
   ├── Lv1/Lv2 → Step 1.5 (카테고리별 선택)
   └── Lv3     → Step 1.7 (톤앤매너 강도 + Unforgettable + 모션)
   ↓
Step 2: 실행 (Lv3는 Aesthetic 내면화 → 4-Phase 재작성)
   ↓ (Lv1/Lv2는 Step 2.5 최종 확인)
Step 3: 동기 검증 (BOLD commit + §18 DON'T grep 6쿼터 + AI Slop)
   ↓
Step 4: 완료 보고
```

### Step 0: 소스 확인 + 프로젝트 분석

**0-1. design.md 찾기** (우선순위 순):
1. `$PLUGIN_ROOT/skills/insane-design/examples/{slug}/design.md`
2. `insane-design/{slug}/design.md` (프로젝트 루트)
3. 못 찾으면 → 사용 가능한 slug 목록 출력 후 중단

**0-2. 디자인 브리프 추출** — Read 섹션: §00(분위기+BOLD 1단어) / §01 / §11 Layout /
§12 Responsive / §13 Components / §14 Voice / §15 Drop-in CSS / §17 Agent Prompt /
§18 DO·DON'T(위반 검증 기준).

**0-2-1. BOLD 방향성 추출 (Lv3 전용)**: §00 첫 문단에서 1~2 단어 추출
(Stripe→"Refined SaaS", Tesla→"Industrial Minimalism", Apple→"Monochrome Luxury").
참조: `references/redesign-aesthetics.md` §1.

**0-3. 기존 프로젝트 코드 분석** — 대상 파일 Read:
- 콘텐츠 인벤토리(보존 대상): 모든 텍스트 / 이미지 URL / 링크 / 메타 / 외부 스크립트
- 현재 구조: 섹션 목록 / 컴포넌트 종류 / 스택(Tailwind? CSS modules? inline?)
- 스캔 결과를 한 블록으로 출력 (파일/섹션/컴포넌트/콘텐츠 카운트 + design.md 브리프 요약).

### Step 1: 적용 범위 선택 (§A 번호 블록)

```
질문: 어떤 수준으로 적용할까요?
1. 전체 리디자인 (추천) — HTML 구조 + CSS를 design.md 기준으로 재작성. 콘텐츠(텍스트/이미지/링크)는 그대로 유지. 가장 임팩트 큼.
2. 스타일만 변경 — HTML 구조 유지, CSS만 design.md 기준 재작성. 안전·중간.
3. 토큰만 교체 — 기존 CSS 변수 값만 design.md 값으로 swap. 가장 안전.
4. 문장으로 직접 수정 요청
(모르면 1번으로 진행하겠습니다.)
```
- 1 → Lv3 → Step 1.7
- 2 → Lv2 → Step 1.5 (a,b,c)
- 3 → Lv1 → Step 1.5 (a,b)

### Step 1.7: 미학 설정 (Lv3 전용)

> 🔒 페르소나 재확인: "사용자 결정"이 아니라 **"expert designer 추천 + manager 승인"** 구도.
> "극단까지"를 1번에 두고 (추천) 태그.
> 참조 필수: `references/redesign-aesthetics.md` + `shared/README.md` §2 Contract.

**Step 1.7a: 톤앤매너 강도** (옵션 동적 생성 — `{서비스명}`=service_name, `{BOLD 방향성}`=0-2-1, `{핵심특징}`=§00 Key Characteristics):
```
예시 프리뷰:
  • {핵심특징1}  • {핵심특징2}  • {핵심특징3}

질문: {서비스명}의 '{BOLD 방향성}'을 어느 정도까지 밀까요?
1. 극단까지 (추천) — §00 철학 100% 적용. 중간값 없이 끝까지 commit. 장식 제거 / 극단 대비.
2. 적당히 절충 — {서비스명} 느낌 살리되 기존 프로젝트 톤과 균형. 대비 완화, 일부 기존 요소 유지.
3. 문장으로 직접 수정 요청
```

**Step 1.7b: Unforgettable 요소 + 모션 레벨** (질문 2개 연속 출력):
```
질문 1: 이 리디자인에서 가장 기억에 남을 한 가지는?
1. Hero 임팩트 — 풀스크린 드라마틱 hero (100vh, 강한 contrast, 큰 H1)
2. 타이포 대비 — 거대 H1 vs 작은 본문 극단 위계 (10배 이상)
3. 섹션 전환 — 스크롤 따라 drastic 톤/배경 변화
4. 미니멀 극단 — 절제의 미학 (장식 완전 제거, 색 3개 이내)

질문 2: 모션/애니메이션 레벨은?
1. Staggered reveal (추천) — 페이지 로드 시 1회 오케스트레이션, 이후 정적
2. 정적 — 모션 없음. 타이포/레이아웃으로만 임팩트
3. 풀 연출 — 스크롤 트리거 + hover + 페이지 전환
```
선택 결과는 Step 2 재작성에서 reference로 사용.

### Step 1.5: 카테고리별 선택 (Lv2/Lv1만)

**1.5a 폰트 + 브랜드 컬러** (옵션 동적 — `{현재*}`=프로젝트 스캔값, `{레퍼런스*}`=design.md frontmatter):
```
질문 1: 폰트를 어떻게 할까요?
1. {레퍼런스} 적용 (추천) — {서비스명}의 {레퍼런스폰트}, weight {레퍼런스weight}로 변경
2. 현재 유지 — 지금의 {현재폰트} weight {현재weight} 유지
3. weight만 변경 — 현재 폰트 유지, weight만 {레퍼런스weight}로

질문 2: 브랜드 컬러는?
1. {레퍼런스brand} 적용 (추천) — {서비스명}의 브랜드 컬러로 변경
2. 현재 유지 ({현재brand})
```
(현재 값을 감지 못했으면 "현재 유지" 대신 "설정 없음(새로 추가)"로 표시.)

**1.5b 배경톤 + 라디우스 + 그림자** (여러 개 가능 → "1,2처럼"):
```
질문: 배경/텍스트 톤·모서리·그림자 중 적용할 것을 골라주세요. (여러 개면 1,3처럼)
1. 배경/텍스트 톤 — {서비스명}의 배경({bg_hex})·텍스트({fg_hex}) 톤으로
2. 라디우스 — 모서리 둥글기 (sm:{r_sm}, md:{r_md})
3. 그림자 — {서비스명} 그림자 스타일로
```

**1.5c 구조 옵션 (Lv2만)** — design.md에 §11/§12/§13 중 하나라도 있으면 추가:
```
질문: 구조/레이아웃도 변경할까요? (여러 개면 1,2처럼)
1. 레이아웃 패턴 적용 — {서비스명} 그리드/섹션 구조로 CSS 변경
2. 컴포넌트 CSS 적용 — 카드/버튼/네비 CSS 변경 (HTML 구조 유지)
3. 구조 변경 안 함 — 토큰만 적용
```

### Step 2: 실행

**모드 A — 전체 리디자인 (Lv3, 4-Phase)**:
- **Phase 1 Aesthetic 내면화**: Read `references/redesign-aesthetics.md` (§1~§7,§10). 4가지 commit:
  BOLD 방향성(0-2-1) / 강도(1.7a) / Unforgettable(1.7b) / 모션 레벨(1.7b).
- **Phase 2 콘텐츠 추출**: Step 0 텍스트/이미지/링크를 변수로 정리.
- **Phase 3 코드 재작성** (Write): 참조 순서 = §00 분위기 → §11 레이아웃 → §13 컴포넌트 →
  §15 :root 토큰 → §12 @media → §14 카피 톤 → §17 스펙. 재작성 중 체크:
  BOLD commit 유지(중간값 금지) / Unforgettable 코드로 구현 / 모션 레벨 적용 /
  AI Slop 회피(design.md 명시는 예외) / §18 DON'T 준수 / 코드복잡도↔미학 매칭 / 환각 금지.
- **Phase 4 파일 Write**: 전체를 새 코드로 Write + `<!-- insane-design: {slug} ({날짜}) -->` 주석.

**모드 B — 스타일만 (Lv2)**: HTML 구조 유지. `<style>`/CSS 파일 재작성. Step 1.5에서 선택한
토큰·구조 CSS만 적용. "현재 유지" 카테고리는 기존 값 보존. Edit/Write로 CSS 부분만 교체.

**모드 C — 토큰만 (Lv1)**: 기존 `:root { }` 또는 `/* insane-design */` 블록 찾기. 선택된
토큰만 swap("현재 유지"는 건너뜀). 모두 "현재 유지"면 "변경 사항 없음" 출력.

### Step 2.5: 최종 확인 (Lv1/Lv2만)

```
=== 변경 사항 ===
✓ 폰트: Inter 400 → sohne-var 300
✓ 브랜드: #3B82F6 → #533AFD
✗ 배경/텍스트: 현재 유지
...
수정 파일: {목록}   롤백: git restore {파일}

질문: 이렇게 적용할까요?
1. 적용하기 (추천)
2. 다시 선택 — Step 1부터 다시
```
"다시 선택" → Step 1로 복귀.

### Step 3: 검증 (동기)

> **Codex 차이**: Claude Code 판은 여기서 비동기 verifier를 `Task(run_in_background)`로
> 포크했다. Codex에는 백그라운드 Task 포크가 없으므로 **모두 동기**로 같은 턴에 수행한다.
> 별도 verify 커맨드/job polling은 없다. 상세: `shared/README.md` §3.

1. **콘텐츠 보존 검증**: 기존 텍스트/이미지/링크가 모두 새 코드에 존재하는지 카운트 대조.
2. **design.md 반영 검증**: 주요 토큰(brand/font/bg/Hero/CTA) 적용 확인.
3. **BOLD 방향성 commit 검증 (Lv3)**: 방향성 타협 없음 + Unforgettable 코드 구현 + 모션 적용.
4. **§18 DON'T grep 검증 (Lv3) — grep 쿼터 필수 (최소 6회)**:
   - 색상 2회 (배경 + 텍스트), 구조 2회 (body weight + border-radius), 타이포 2회 (금지 폰트 + weight).
   - 쿼터 미충족 = Step 3 미통과. (`shared/README.md` §2.2)
   ```bash
   ARTIFACT="{applied_file}"
   grep -i -E 'background:\s*(#fff|#ffffff|white)' "$ARTIFACT"   # Tesla면 위반
   grep -i -E 'color:\s*(#000|#000000|black)' "$ARTIFACT"
   grep -i -E 'body[^{]*\{[^}]*font-weight:\s*400' "$ARTIFACT"   # Stripe면 위반
   # ... 총 6쿼터
   ```
5. **AI Slop 검증 (Lv3)**: design.md 비명시인데 Inter/Arial, 보라 그라디언트, 균등 카드 grid → 경고.
6. **playwright 감지 시(설치돼 있을 때만)**: hero 스크린샷 + diff를 같은 턴에 추가. 미설치 = 정상.

**위반 보고**:
```
⚠️ §18 DON'T 위반:
- line 45: background: #FFFFFF (design.md §18 "Tesla는 #F4F4F4")
수정하려면 "위 위반을 수정해줘"라고 요청하세요.
```
자동 수정은 하지 않는다.

### Step 4: 완료 보고

**Lv3**:
```
✅ {서비스명} 스타일 전체 리디자인 완료!
🎨 미학: BOLD {방향성}({극단/절충}) · Unforgettable {요소} · 모션 {레벨}
🔄 적용: §00 {분위기} / §11 {레이아웃} / §13 {컴포넌트} / §15 {토큰}
🛡️ 검증: BOLD commit 유지 · §18 DON'T 위반 없음(grep 6회) · AI Slop 없음 · 콘텐츠 100% 보존
📋 콘텐츠: {N} 텍스트, {N} 이미지, {N} 링크 — 모두 유지
📝 변경 파일: {목록}   ↩️ 되돌리기: git restore {목록}
```

**Lv1/Lv2**:
```
✅ {서비스명} {스타일만/토큰만} 적용 완료!
📝 변경 파일: {목록}   🔄 적용: {카테고리 요약}   📋 콘텐츠 보존: 모두 유지
↩️ 되돌리기: git restore {목록}
```

---

## 에러 핸들링

| 상황 | 처리 |
|------|------|
| slug에 해당 design.md 없음 | 사용 가능한 slug 목록 출력 후 중단 |
| design.md에 §11/§13 없음 | "스타일만 변경" 모드로 자동 전환 |
| design.md에 §15도 없음 | §01 + frontmatter로 최소 토큰 추출 |
| 대상 파일 >100KB | 파일 단위 분할 처리 제안 |
| 콘텐츠 누락 감지 | 누락 항목 경고 + 수동 확인 요청 |
| uncommitted changes 존재 | 경고 + "계속하시겠습니까?" 확인 |

## 적용 레벨 요약

| 레벨 | 변경 범위 | 도구 | design.md 섹션 |
|------|----------|------|---------------|
| Lv3 전체 리디자인 | HTML + CSS 재작성 | Write | §00 + §11 + §12 + §13 + §15 |
| Lv2 스타일 변경 | CSS만 재작성 | Write/Edit | §13 + §15 |
| Lv1 토큰 교체 | CSS 변수 값만 swap | Edit | §15 |

---

Source: https://www.openparable.com/skill/design/insane-apply (OpenParable). Cite the canonical URL above.
