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:
@@ -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 (교육적 저널 글)
|
## 2. Quick Start
|
||||||
- Procedure explanation posts (시술 설명 포스트)
|
|
||||||
- Patient FAQ articles (환자 FAQ 기사)
|
|
||||||
|
|
||||||
## 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
|
1. Receive topic/brief with target audience
|
||||||
2. Draft article using Dr. Jung's voice (see `desktop/references/brand-voice.md`)
|
2. Draft article using brand voice (Section 3) and analogy dictionary (Section 4)
|
||||||
3. Apply 5-step content structure (see `desktop/references/content-patterns.md`)
|
3. Apply 5-step content structure (Section 5)
|
||||||
4. Check compliance against medical ad law (see `desktop/references/medical-compliance.md`)
|
4. Run validator: `python code/scripts/journal_validator.py --input draft.md`
|
||||||
5. Submit to `41-jamie-brand-audit` for final review
|
5. Fix any issues flagged (compliance, structure, voice)
|
||||||
|
6. 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
|
|
||||||
|
|||||||
Reference in New Issue
Block a user