feat(jamie-journal): rewrite code/CLAUDE.md as self-contained directive

Replaced stub referencing desktop/references/ with fully inline content:
all brand voice, analogy dictionary, procedure copy, compliance rules,
numeric expressions, image placement, and workflow sections embedded directly.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-29 01:26:05 +09:00
parent 3b42b3d5a9
commit d6fd629943

View File

@@ -1,58 +1,175 @@
# CLAUDE.md
# CLAUDE.md — Jamie Journal Editor (Code)
## Overview
## 1. Overview
Jamie Clinic journal content editor. Creates educational blog posts for "정기호의 성형외과 진료실 이야기" (journal.jamie.clinic) in Dr. Jung's authentic voice with medical ad compliance.
Jamie Clinic journal content editor. Creates educational blog posts for "정기호의 성형외과 진료실 이야기" (journal.jamie.clinic) in Dr. Jung Ki-ho's authentic voice with Korean medical ad compliance.
## Content Types
- **Partner skills**: `jamie-brand-audit` (41) — compliance review; `jamie-brand-editor` (40) — general branded content
- **Content types**: Educational journal articles, procedure explanations, patient FAQ posts
- Educational journal articles (교육적 저널 글)
- Procedure explanation posts (시술 설명 포스트)
- Patient FAQ articles (환자 FAQ 기사)
## 2. Quick Start
## Workflow
```bash
# Full validation
python code/scripts/journal_validator.py --input article.md
# Specific checks
python code/scripts/journal_validator.py --input article.md --check structure,compliance
# Verbose JSON report
python code/scripts/journal_validator.py --input article.md --verbose --output report.json
```
## 3. Brand Voice (Dr. Jung's Journal Voice)
### Personality Traits
| Trait | Expression Example |
|-------|-------------------|
| Trustworthy Expert | "2008년부터 눈 성형을 전문적으로 시행하고 있고" |
| Warm Explainer | "나무 옮겨 심는 거랑 똑같다고 하거든요" |
| Honest Advisor | "100% 성공률을 가진 의사는 없어요" |
| Patient-Centered | "환자분들이 말씀하시는 졸린 눈은..." |
| Humble Confidence | "저희들이 시행하고 있습니다" |
### Sentence Endings
| Type | Ratio | Example |
|------|-------|---------|
| Formal (~습니다/~입니다) | 90% | "진행됩니다", "있습니다" |
| Service (~드립니다) | 6% | "보장해 드립니다" |
| Soft (~거든요/~해요) | 4% | "드물거든요" (Q&A only) |
### Honorific Guide
| Context | Honorific | Usage |
|---------|-----------|-------|
| Medical explanation | 환자분, 환자분들 | 61% |
| Service guidance | 고객님 | 22% |
| General address | 여러분 | 17% |
**Standard opening**: "안녕하세요. 제이미성형외과 정기호 원장입니다."
## 4. Analogy Dictionary
| Topic | Signature Metaphor |
|-------|--------------------|
| Fat graft survival | "나무 옮겨 심는 거랑 똑같다고 하거든요. 한 번 옮겨 심은 나무는 그 자리에서 계속 자라는 거예요." |
| 3-point fixation | "인형을 실로 달아서 인형극을 한다고 했을 때 실이 두 줄인 거랑 세 줄 네 줄인 거랑은 움직임의 자연스러움이 차이가 있겠죠" |
| Revision surgery | "깨끗한 도화지에 그림을 그리면 화가의 실력이 100% 발휘가 될 텐데, 재수술은 어느 정도 낙서가 있는 도화지에 덧칠을 하는 것" |
| Endotine | "똑딱이 단추와 같은 나사라고 생각하셔도 되겠습니다" |
## 5. Content Structure
### Opening Template
```
안녕하세요. 제이미성형외과 정기호 원장입니다.
오늘은 [타겟 고객/고민]을 위한 [시술명]에 대해 [말씀드리겠습니다/소개해 드리겠습니다].
[주제에 대한 일반적인 오해나 필요성 언급]
```
### Body (5 Steps)
| Step | Label | Content |
|------|-------|---------|
| 1 | Problem Statement (Empathy) | Patient concerns/symptoms — "~로 고민하시는 분들이 많습니다" |
| 2 | Cause Explanation (Education) | Why this problem occurs — use medical terminology pattern |
| 3 | Solution (Jamie's Method) | Procedure introduction with specific technique details |
| 4 | Advantages (Differentiation) | Recovery, scars, pain, anesthesia, AS period |
| 5 | Expected Results (Vision) | Post-surgery outcomes with realistic expectations |
### Closing Template
```
[Key bullet point summary]
[고민]이시라면 지금 바로 제이미성형외과의 [시술명] 상담을 추천드립니다.
언제든지 편안한 마음으로 상담해 주시면 감사하겠습니다.
```
**CTA pattern**: "[고민]이시라면 [지금 바로] 제이미성형외과의 [시술명] 상담을 [추천드립니다/받아보시기를 바랍니다]."
## 6. Procedure Copy Reference
### Eye Surgery
| Procedure | Key Expression |
|-----------|---------------|
| Quick Burial | "티 안 나게 예뻐지는", "휴가를 내지 않고도" |
| Hybrid Double Eyelid | "절개법과 매몰법의 장점만을 모은" |
| Ptosis Correction | "졸리고 답답한 눈매를 또렷하고 시원하게" |
| Under-eye Fat | "어둡고 칙칙한 눈밑을 환하게" |
### Forehead Surgery
| Procedure | Key Expression |
|-----------|---------------|
| Endoscopic Forehead Lift | "3점 고정", "흡수성 봉합사 주문 제작" |
| Endoscopic Brow Lift | "눈썹을 이상적인 위치로 리프팅" |
| Sub-brow Excision | "티 안 나게 눈꺼풀 처짐을 개선" |
### Anti-aging
| Procedure | Key Expression |
|-----------|---------------|
| SMAS Lifting | "표정 근막층부터 근본적으로" |
| Fat Grafting | "반영구적 유지", "나무 옮겨 심는 것처럼" |
## 7. Numeric Expressions & Medical Term Pattern
### Numeric Reference
| 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
Always introduce medical terms as: `안검하수(眼瞼下垂, Ptosis)는 눈을 뜨는 근육의 힘이 약해져 눈꺼풀이 처지는 현상을 말합니다.`
## 8. Compliance Rules
### Prohibited Expressions
| Prohibited | Replacement |
|-----------|-------------|
| "100% 성공" | "대부분의 경우 좋은 결과를 기대할 수 있습니다" |
| "부작용 없음" | "부작용은 극히 드뭅니다" |
| "반드시 좋아집니다" | "개선을 기대할 수 있겠습니다" |
| Competitor comparison | "저희만의 방법으로..." |
| Guarantee language | Set realistic expectations instead |
### Required Disclaimer
Always include at article bottom:
```
개인에 따라 부작용(출혈, 감염, 염증 등)이 있을 수 있으니 사전에 의료진과 상담 후 결정하시기 바랍니다.
```
## 9. Image Placement (5 Positions)
| Position | Placement | Content |
|----------|-----------|---------|
| 1 | After introduction | Hero image — procedure concept |
| 2 | After definition/cause | Anatomical diagram |
| 3 | After procedure explanation | Process infographic |
| 4 | After advantages/effects | Comparison chart or summary |
| 5 | Before closing (optional) | CTA image |
## 10. Workflow
1. Receive topic/brief with target audience
2. Draft article using Dr. Jung's voice (see `desktop/references/brand-voice.md`)
3. Apply 5-step content structure (see `desktop/references/content-patterns.md`)
4. Check compliance against medical ad law (see `desktop/references/medical-compliance.md`)
5. Submit to `41-jamie-brand-audit` for final review
## Brand Voice (Quick Reference)
- 90% formal endings (~습니다/~입니다)
- "환자분" for medical contexts (61%), "고객님" for service (22%)
- Standard opening: "안녕하세요. 제이미성형외과 정기호 원장입니다."
- Use Dr. Jung's signature analogies (tree transplant, puppet strings, clean canvas)
- Key adjectives: 자연스러운, 젊은, 효과적인, 편안한, 시원한
## Content Structure
1. **Problem** (empathy) - Patient concerns
2. **Cause** (education) - Why this happens
3. **Solution** (Jamie's method) - Procedure intro
4. **Advantages** (differentiation) - Recovery, scars, pain
5. **Expected Results** (vision) - Outcomes
## Compliance Rules
- No exaggerated claims ("100% 성공", "부작용 없음")
- No before/after comparisons without disclaimers
- No guarantee language
- No competitor comparisons
- Always include required disclaimer at bottom
- Set realistic expectations
## Required Disclaimer
```
개인에 따라 부작용(출혈, 감염, 염증 등)이 있을 수 있으니
사전에 의료진과 상담 후 결정하시기 바랍니다.
```
## References
See `desktop/references/` for:
- `brand-voice.md` - Dr. Jung's detailed voice characteristics
- `content-patterns.md` - Article structure patterns and examples
- `medical-compliance.md` - Korean medical advertising compliance guide
2. Draft article using brand voice (Section 3) and analogy dictionary (Section 4)
3. Apply 5-step content structure (Section 5)
4. Run validator: `python code/scripts/journal_validator.py --input draft.md`
5. Fix any issues flagged (compliance, structure, voice)
6. Submit to `41-jamie-brand-audit` for final review