refactor: simplify CLAUDE.md + create BLOG_TEMPLATE.md
TaxBaik CI/CD / build-and-deploy (push) Failing after 40s

- Reduce CLAUDE.md blog section to essential guidelines only (10 lines)
- Move detailed templates and checklists to new BLOG_TEMPLATE.md
- Update core philosophy: education + natural professional referral
- Not 'hire me' but 'understand concepts → know when to consult'

BLOG_TEMPLATE.md includes:
 Complete 5-step blog post template
 Real persona examples (name, age, job, income)
 Before/After case structure
 Step-by-step calculation with tables
 Tone guidance (empowerment + professional value)
 Checklist for writers
 Do's & Don'ts
 Seasonal content ideas

Philosophy:
- Basic tax knowledge: anyone can do it
- Complex cases: professionals add efficiency
- Goal: grow customer understanding + increase professional service value
This commit is contained in:
2026-07-01 16:45:47 +09:00
parent abad1630b6
commit 7b27f748de
2 changed files with 236 additions and 125 deletions
+10 -125
View File
@@ -745,134 +745,19 @@ ssh kjh2064@178.104.200.7 crontab -l | grep backup
---
## 5-1. 블로그 & FAQ 콘텐츠 작성 규칙 (2026-07-01 신규 지침)
## 5-1. 블로그 & FAQ 콘텐츠 작성 규칙
### 📌 핵심 원칙 3가지
**핵심**: 고객 임파워먼트 (당신도 할 수 있습니다!)
- ✅ 주변에서 흔히 보는 실제 사례 (이름, 나이, 직업 구체화)
- ✅ 절세 효과 수치화 ("세금을 X만 원 절약했습니다")
- ✅ 중학교 2학년도 이해 가능한 수준
- ✅ 단계별 설명 + 표로 시각화
- ✅ 결론: "정확하게 하면 이런 이점이 있습니다" (임파워먼트)
**1. 실제 고객이 어려워하는 사례 중심**
- 추상적 설명 X → 구체적 금액 & 상황 O
- "세무 기장 팁" X → "사업자 기장 시 자주 하는 실수 5가지" O
**피해야 할 톤**: "복잡하니까 맡기세요" (세무사 의존성 강화)
**세무사 언급**: "더 복잡하면 전문가와 상담하세요" (선택지)
**2. 절세 팁과 실무 조언 (최소 3개)**
- 해야 할 것 vs 하면 안 될 것 명확
- 예: "영수증을 모으면 X만 원 절약"
**3. 중학교 2학년도 이해 가능한 수준**
- 어려운 용어는 괄호로 쉽게 설명
- 표, 그래프, 이모지로 시각화
- 문장은 짧고 간결
### 📝 블로그 포스트 구조 (필수 5단계)
#### Step 1️⃣: 도입부 (공감 + 질문)
```markdown
"카페를 운영하는데 세금이 얼마나 될까요?"
"많은 사업자들이 이 질문을 합니다."
→ 독자가 자신의 상황을 발견하도록 유도
```
#### Step 2️⃣: 실제 사례 (구체적 상황)
```markdown
### 상황: 카페를 운영하는 김 사장님
**월 판매량**: 300개
**상품 가격**: 평균 2만 원
**월 매출**: 600만 원
### 문제가 생겼어요
→ 영수증을 그냥 버렸어요
→ 나중에 세무청이 소득 누락으로 판단해 세금을 더 거두었습니다.
```
#### Step 3️⃣: 계산 & 설명 (단계별)
```markdown
### Step 1️⃣: 기본 정보 확인
### Step 2️⃣: 차익 계산
### Step 3️⃣: 공제 계산
| 항목 | 금액 |
|------|------|
| 매출 | 600만 원 |
| 경비 | 351만 원 |
| 순이익 | 249만 원 |
```
#### Step 4️⃣: 실무 팁 (ㅇ vs X)
```markdown
### ✅ 올바른 방법
- 📄 모든 영수증은 봉투에 정리해두기
- 📊 매일 또는 매주 판매액을 정리하기
### ❌ 하면 안 되는 것
- 영수증을 그냥 버리기
- 개인 물건을 사업 경비로 깎기
```
#### Step 5️⃣: 결론 & 강조 (핵심 3개)
```markdown
## 💡 꼭 기억하세요!
**1. 기장은 세금을 줄이는 가장 첫 번째 방법이다**
**2. 영수침을 모아두면 정당한 경비를 더 계산할 수 있다**
**3. 처음부터 정확하게 하면 나중에 편하다**
```
### ✅ 필수 체크리스트
- [ ] **실제 고객 사례** (이름, 구체적 금액, 실제 상황)
- [ ] **구체적 계산** (Step별로 명확, 표 포함)
- [ ] **절세 효과 수치화** ("세금을 X만 원 절약했습니다")
- [ ] **중학교 수준 언어** (어려운 용어는 괄호로 설명)
- [ ] **법률 정확성** (세법/시행령 오류 없음)
- [ ] **이모지 활용** (🏠, 💰, ✅, ❌ 등 시각화)
- [ ] **해야 할 것 vs 하면 안 될 것** (명확한 구분)
- [ ] **마지막 핵심 3개** (꼭 기억하세요! 섹션)
### 📋 피해야 할 표현
| ❌ 하지 말 것 | ✅ 대신 이렇게 |
|-----------|-----------|
| "세무 기장의 중요성" | "사업자 기장 시 자주 하는 실수 5가지" |
| "일반적으로..." | "예: 카페를 운영하는 김 사장님..." |
| "복잡한 계산..." | "Step 1,2,3으로 단계별 설명" |
| "전문용어 설명 없음" | "세금계산서란 (회사가 품질 보증하는 영수증)" |
| "결론 없음" | "💡 꼭 기억하세요! - 3개 핵심 요약" |
### 🎯 평가 기준 (점수 체계)
**⭐⭐⭐⭐⭐ (최고: 배포 권장)**
- ✅ 실제 고객 상황 & 이름
- ✅ 구체적 금액 & 계산 (표 포함)
- ✅ 절세 효과 수치화 ("세금 130만 원 절약")
- ✅ 중학교 수준의 언어
- ✅ 법률 정확성 완벽
**⭐⭐⭐⭐ (좋음: 사소한 수정 후 배포)**
- ✅ 고객 사례 있음
- ✅ 계산 과정 명확
- ⚠️ 일부 용어 설명 필요
**⭐⭐⭐ (보통: 개선 필요)**
- ⚠️ 추상적 표현 많음
- ⚠️ 계산 과정 부족
- ⚠️ 절세 팁 부족
**⭐⭐ 이하 (부족: 재작성)**
- ❌ 어려운 용어만 나열
- ❌ 법률 오류
- ❌ 실무 팁 전무
### 📌 시즌별 자동 배포 우선순위
**각 시즌에 관련 포스트가 자동으로 상단에 배치**:
| 월 | 시즌 | 추천 주제 | 예시 포스트 |
|----|------|---------|-----------|
| 1월 | 부가세 2기 신고 | 신고 기한 | "부가세 신고 - D-5일" |
| 2월 | 연말정산 | 환급 받기 | "환급금 최대화하기" |
| 3월 | 법인세 신고 | 법인세 | "법인세 신고 기한" |
| 5월 | **종합소득세 (피크)** | **핵심 신고** | "종소세 완벽 가이드" |
| 7월 | 부가세 1기 신고 | 신고 기한 | "부가세 신고 놓치지 말기" |
| 11월 | 종부세 | 부동산세 | "종부세 계산하기" |
**자세한 템플릿 및 체크리스트**: `BLOG_TEMPLATE.md` 참고
---