# CLAUDE.md — Jamie Journal Editor (Code)

## Overview

Jamie Clinic journal content editor for "정기호의 성형외과 진료실 이야기" (journal.jamie.clinic). Creates educational blog posts in Dr. Jung Ki-ho's authentic voice with Korean medical ad compliance. Supports full drafting (research → outline → article) and manuscript editing.

- **CMS**: Ghost (journal.jamie.clinic)
- **Partner skills**: `jamie-brand-audit` (41) — compliance review; `jamie-brand-editor` (40) — general branded content

## Quick Start

```bash
python code/scripts/journal_validator.py --input article.md
python code/scripts/journal_validator.py --input article.md --check structure,compliance
python code/scripts/journal_validator.py --input article.md --verbose --output report.json
```

## Workflow Modes

**Mode A — Full Drafting** (no manuscript): Receive topic → deep research → outline for approval → draft article → SEO + image specs + schema → compliance review → `jamie-brand-audit`

**Mode B — Manuscript Editing**: Receive 초안 → preserve original voice/analogies → restructure for web + SEO → add SEO + image specs + schema → compliance review → `jamie-brand-audit`

## Brand Voice (Dr. Jung)

### Personality Traits

| Trait | Expression Example |
|-------|-------------------|
| Trustworthy Expert | "2008년부터 눈 성형을 전문적으로 시행하고 있고" |
| Warm Explainer | "나무 옮겨 심는 거랑 똑같다고 하거든요" |
| Honest Advisor | "100% 성공률을 가진 의사는 없어요" |
| Patient-Centered | "환자분들이 말씀하시는 졸린 눈은..." |
| Humble Confidence | "저희들이 시행하고 있습니다" |

### Sentence Endings & Honorifics

| Type | Ratio | | Context | Honorific | Usage |
|------|-------|-|---------|-----------|-------|
| Formal (~습니다) | 90% | | Medical | 환자분 | 61% |
| Service (~드립니다) | 6% | | Service | 고객님 | 22% |
| Soft (~거든요) | 4% | | General | 여러분 | 17% |

**Standard opening**: "안녕하세요. 제이미성형외과 정기호 원장입니다." (시리즈 후속편: "지난 글에서~" 대체 가능)

## Analogy Dictionary

| Topic | Signature Metaphor |
|-------|--------------------|
| Fat graft survival | "나무 옮겨 심는 거랑 똑같다고 하거든요. 한 번 옮겨 심은 나무는 그 자리에서 계속 자라는 거예요." |
| 3-point fixation | "인형극 실 비유 - 실이 두 줄인 거랑 세 줄 네 줄인 거랑은 움직임의 자연스러움이 차이가 있겠죠" |
| Revision surgery | "깨끗한 도화지에 그림을 그리면 화가의 실력이 100% 발휘가 될 텐데, 재수술은 낙서가 있는 도화지에 덧칠을 하는 것" |
| Endotine | "똑딱이 단추와 같은 나사라고 생각하셔도 되겠습니다" |

## Content Structure (5-Step Body)

### Opening
```
안녕하세요. 제이미성형외과 정기호 원장입니다.
오늘은 [타겟 고객/고민]을 위한 [시술명]에 대해 [말씀드리겠습니다/소개해 드리겠습니다].
[주제에 대한 일반적인 오해나 필요성 언급]
```

| Step | Label | Content |
|------|-------|---------|
| 1 | Problem (Empathy) | Patient concerns — "~로 고민하시는 분들이 많습니다" |
| 2 | Cause (Education) | Why this occurs — use medical term format |
| 3 | Solution (Jamie's Method) | Procedure with technique details |
| 4 | Advantages (Differentiation) | Recovery, scars, pain, AS period |
| 5 | Results (Vision) | Realistic outcomes |

### Closing
```
[고민]이시라면 지금 바로 제이미성형외과의 [시술명] 상담을 추천드립니다.
언제든지 편안한 마음으로 상담해 주시면 감사하겠습니다.
```

## SEO Metadata

| 항목 | 형식 |
|------|------|
| 메타 제목 | [주제] — [핵심키워드] \| 제이미성형외과 (60자 이내) |
| 메타 디스크립션 | 120-160자, 핵심 키워드 포함, CTA 암시 |
| Slug | 영문 소문자, 하이픈 구분, 핵심 키워드 3-5개 |
| 태그 | 핵심 키워드 5-10개 (한글) |

## Procedure Copy Reference

| Category | Procedure | Key Expression |
|----------|-----------|---------------|
| Eye | Quick Burial | "티 안 나게 예뻐지는", "휴가를 내지 않고도" |
| Eye | Hybrid Double Eyelid | "절개법과 매몰법의 장점만을 모은" |
| Eye | Ptosis Correction | "졸리고 답답한 눈매를 또렷하고 시원하게" |
| Eye | Under-eye Fat | "어둡고 칙칙한 눈밑을 환하게" |
| Forehead | Endoscopic Forehead Lift | "3점 고정", "흡수성 봉합사 주문 제작" |
| Forehead | Endoscopic Brow Lift | "눈썹을 이상적인 위치로 리프팅" |
| Forehead | Sub-brow Excision | "티 안 나게 눈꺼풀 처짐을 개선" |
| Anti-aging | SMAS Lifting | "표정 근막층부터 근본적으로" |
| Anti-aging | Fat Grafting | "반영구적 유지", "나무 옮겨 심는 것처럼" |

## Numeric Expressions & Medical Term Format

| Item | Expression |
|------|-----------|
| Surgery time | "10~15분", "1시간 정도", "4시간 정도" |
| Recovery | "다음 날부터", "4~5일", "일주일 정도" |
| AS period | "5년간 AS 보장" |
| Management | "1년간 무료 리프팅 관리" |
| Survival rate | "30% 정도, 많게는 40%까지" |
| Duration | "5년 이상", "반영구적" |

**Medical term format**: `안검하수(眼瞼下垂, Ptosis)는 눈을 뜨는 근육의 힘이 약해져 눈꺼풀이 처지는 현상을 말합니다.`

영문 병기: 본문 첫 등장 시 적용, 섹션 타이틀은 선택적, 그래픽은 핵심 해부학 용어만, Featured Image는 국문만(예외 없음).

## Do's & Don'ts

**Do's**: Patient empathy first, use signature analogies, specific numbers, realistic expectations, 원고 편집 시 원문 표현·비유·직설적 경고 보존

| Prohibited | Replacement |
|-----------|-------------|
| "100% 성공" | "대부분의 경우 좋은 결과를 기대할 수 있습니다" |
| "부작용 없음" | "부작용은 극히 드뭅니다" |
| "전문/전문병원" | "중점진료", "풍부한 경험" |
| "완벽/최고/최상" | 사용 불가 |
| "무통/완치/해결" | "개선", "지향" |
| Competitor comparison | "저희만의 방법으로..." |

## Required Disclaimer (#알립니다#)

```
※ 본 콘텐츠는 의학 정보 제공을 목적으로 작성되었으며,
개인의 상태에 따라 적합한 치료 방법은 다를 수 있습니다.

※ 모든 수술 및 시술은 개인에 따라 결과가 다를 수 있으며,
출혈, 감염, 붓기, 비대칭 등의 부작용이 발생할 수 있습니다.
반드시 전문의와 충분한 상담 후 결정하시기 바랍니다.
```

## Image Specifications

**Color palette**: Background `#E0E5EB` (flat, no gradients), Primary text `#333333`, Accent `#6B8FAF`, Secondary `#8B9BA8`, JAMIE logo `#6d7856`

**Featured Image** (1200×675px, 16:9): 실사 모델 필수, 국문 카피만 (영문 절대 금지), 포스트 제목 그대로 사용 금지, JAMIE 워터마크는 앱 옵션으로 처리. Ghost Post Settings에서 설정 — 본문에 삽입하지 않음.

**본문 이미지** (1200×600px): 2번부터 시작. 위치: ②정의/원인 후 해부학 도식, ③시술 설명 후 인포그래픽, ④장점/효과 후 비교 차트, ⑤마무리 전 CTA (선택).

**금지 요소**: 실제 수술 장면, Before/After 라벨, 수술 도구 사실적 사진, 3D/그라디언트, 장식 테두리, 클립아트.

**파일명**: `[topic]-[detail]-[type]-[number].png` (type: featured, recovery-timeline, comparison, anatomy, infographic, flowchart)

## Gemini Image Prompt Templates

4종 템플릿 사용. 모든 프롬프트에 `[PRIMARY]`/`[SECONDARY]` 블록으로 시각적 위계 구조화, HEX 컬러 명시, 의료 고지문 미포함.

- **Featured**: 실사 인물 + 국문 카피, `#E0E5EB` 배경, 16:9
- **Timeline**: 수평 타임라인 노드 (`#6B8FAF` 활성, `#8B9BA8` 비활성), 1200×600px
- **Comparison**: 2-column 레이아웃, `#8B9BA8` 구분선, 1200×600px
- **Anatomy**: 미니멀 line-art, `#6B8FAF` 화살표, 핵심 용어만 영문 병기, 1200×600px

구성 의도가 불명확할 때 임의 해석하지 말고 사용자에게 확인.

## Schema Data (Ghost CMS)

FAQPage + BreadcrumbList를 하나의 `<script>` 태그에 `@graph` 배열로 통합. Ghost Post Settings → Code injection → Post Header에 삽입.

## Output — 3-파일 1세트

1. **종합 초안** (`jamie-journal_[slug]_comprehensive-draft.md`): SEO + 본문 + 이미지 사양/Gemini 프롬프트 + Schema + 체크리스트 + 편집자 노트
2. **Ghost 본문** (`ghost_[slug]_body.md`): 클린 마크다운, 이미지 2번부터, #알립니다# 포함
3. **Code Injection** (`ghost_[slug]_code-injection.html`): @graph 통합 스크립트
