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
+226
View File
@@ -0,0 +1,226 @@
# 블로그 포스트 작성 템플릿
## 🎯 핵심 철학
- **목표**: 고객들이 세무 개념을 이해 → 세무사의 가치를 더 잘 인식
- **톤**: 교육적이고 격려적 (하지만 의존성은 자연스럽게 유도)
- **메시지**: "기초는 이렇게, 복잡하면 전문가와 함께"
---
## 📝 템플릿 (복사해서 사용)
### 📌 Step 1: 도입부 (공감)
```markdown
# [제목]
"[구체적 상황]?"
"많은 [직업]들이 이 상황을 겪습니다."
→ 독자가 자신의 상황을 발견하도록
```
**예시**:
```markdown
# 동네 카페 월세 낼 때 세금이 안 나와요 - 정말 그럴까?
"사업을 시작했는데 세금을 낸 적이 없어요"
"많은 소규모 사업자들이 이렇게 생각합니다."
```
---
### 👤 Step 2: 실제 사례 (구체적 페르소나)
**필수 정보**:
- 이름, 나이, 직업, 사업 경력
- 월/연간 매출 (현실적 수치)
- 실제 겪은 문제/성공 사례
```markdown
### 상황: [지역] [카테고리]를 운영하는 [이름]님 ([나이]세, 사업 [년]차)
**기본 정보**:
- 위치: [구체적 위치]
- 월 매출: [금액]
- 월 경비: [주요 항목들]
### 원래는 이렇게 했어요 (실패 사례)
→ [실제 실수 1]
→ [실제 실수 2]
**결과**: 세금을 [X만 원] 더 내게 됨 (또는 세무조사 대상)
### 바뀐 후 (성공 사례)
→ [해결책 1]
→ [해결책 2]
**결과**: 세금을 [X만 원] 절약함 (또는 안정적인 운영)
```
**예시**:
```markdown
### 상황: 강남 역삼동에서 카페를 운영하는 김민수님 (34세, 사업 3년차)
**기본 정보**:
- 위치: 강남역 3번 출구 근처
- 월 매출: 약 600만 원 (평일 200만, 주말 400만)
- 월 경비: 월세 150만, 재료비 180만, 직원급여 100만 원
### 원래는 이렇게 했어요
→ "세금은 큰 회사나 내는 거라고 생각했어요"
→ 영수증도 대충 정리하고
**결과**: 세무청에서 3년치를 추징받고 가산세까지...손해 70만 원
### 바뀐 후
→ 매달 영수증을 정리해서
→ 세무사와 년 1회 기장 상담
**결과**: 세금도 명확하고, 추징도 없음. 심플하고 안전
```
---
### 📊 Step 3: 계산 & 설명
**구조**:
1. **기본 정보 확인** (위에서 제시한 사례 요약)
2. **단계별 계산** (Step 1, Step 2, ... 명확히)
3. **표로 시각화**
```markdown
## 계산 방법
### Step 1️⃣: 매출 정리
월 600만 원 × 12개월 = 연 7,200만 원
### Step 2️⃣: 경비 계산
| 항목 | 월 | 연간 |
|------|-----|------|
| 월세 | 150만 | 1,800만 |
| 재료비 | 180만 | 2,160만 |
| 직원급여 | 100만 | 1,200만 |
| 기타 | 20만 | 240만 |
| **합계** | **450만** | **5,400만** |
### Step 3️⃣: 순이익
7,200만 - 5,400만 = **1,800만 원**
### Step 4️⃣: 세금
1,800만 원 × 약 6% = **약 108만 원/년**
```
---
### 💡 Step 4: 실무 팁 (3~5개)
**구조**: ✅ 이렇게 하세요 / ❌ 이렇게 하면 안 돼요
```markdown
## 이렇게 하면 세금이 명확해요
### ✅ 해야 할 것
1. **영수증 정리** - 매달 봉투에 모아두기
2. **기본 기록** - 엑셀에 간단히 기입
3. **연 1회 점검** - 세무사와 기본 상담
4. **투명성** - 세무청 신고는 정확하게
### ❌ 하면 안 되는 것
1. **영수증 버리기** - 나중에 증거 없음
2. **개인비와 섞기** - 기장 혼란
3. **신고 늦추기** - 가산세 발생
4. **과하게 깎기** - 세무조사 리스크
```
---
### 🎓 Step 5: 결론 (임파워먼트 + 세무사 자연스러운 유도)
**구조**:
1. "기초 수준이면 이 정도면 충분"
2. "하지만 이렇게 복잡해지면 전문가 도움이 효율적"
3. "세무사와 함께 하는 게 장기적으로 낫다"
```markdown
## 기초는 누구나 할 수 있어요
**이 정도면 자신이 충분히 가능합니다**:
- 소규모 사업 (월 500만~1,000만 원)
- 단순 경비 (재료, 임차료 등)
- 월 1회 정도 기본 정리
→ 영수증 정리 + 기본 엑셀 기입면 충분
---
## 하지만 이렇게 복잡하면 전문가 도움이 효율적입니다
**세무사 상담을 권하는 경우**:
- 📊 월 매출이 2,000만 원을 넘어갈 때
- 💼 여러 사업을 동시에 운영할 때
- 🏠 부동산 등 추가 수입이 있을 때
- 📈 직원을 여러 명 두고 있을 때
- 🌍 해외 거래나 수입이 있을 때
→ 이런 경우는 세무사와 함께 하면:
- ✅ 세금을 더 효율적으로 절약 (프로 기법)
- ✅ 세무조사 때 당당하게 대응
- ✅ 복잡한 문제를 빠르게 해결
- ✅ 시간을 절약 (당신은 사업에만 집중)
---
## 요약
**기본 개념을 아는 것만으로도**:
- 실수를 줄이고
- 세금을 절약하고
- 세무사와의 상담이 훨씬 효율적
당신의 상황이 어느 정도인지 판단하고,
필요할 때 전문가와 함께 하세요.
```
---
## ✅ 작성 체크리스트
### 내용
- [ ] **실제 사례**: 동네 카페/편의점/학원 같은 주변 상황
- [ ] **구체적 페르소나**: 이름, 나이, 직업, 사업 경력
- [ ] **실제 금액**: 매출, 경비, 세금 (현실적 수치)
- [ ] **Before/After**: 실패 사례 → 성공 사례
- [ ] **절세 효과**: "X만 원 절약" 또는 "손해를 막음"
- [ ] **계산**: Step별로 명확, 표 포함
### 톤
- [ ] **교육적**: 개념을 이해하도록
- [ ] **격려적**: 경고/협박 없음
- [ ] **현실적**: 복잡할 수 있다는 인정
- [ ] **세무사 자연스러운 유도**: "필요할 때 도움되는 선택"
- [ ] **임파워먼트**: "기초는 누구나 할 수 있어요"
### 표현
- [ ] **중학교 수준**: 어려운 용어는 () 설명
- [ ] **이모지**: 🏠💰✅❌📊 등으로 시각화
- [ ] **짧은 문장**: 한 문장에 한 개념
- [ ] **표와 리스트**: 수치는 표로, 항목은 리스트로
---
## 피해야 할 표현
| ❌ 이렇게 | ✅ 이렇게 |
|---------|---------|
| "복잡하니까 맡기세요" | "기초는 누구나, 복잡하면 전문가" |
| "전문가는 필수입니다" | "필요할 때 도움받으면 효율적" |
| "혼자서도 잘해요" | "기초 수준은 자신이 가능해요" |
| "세무사에 위임하세요" | "당신의 상황에 따라 판단하세요" |
| "절대 실수하면 안 돼요" | "실수할 수 있으니 미리 대비하세요" |
---
## 시즌별 주제 예시
| 월 | 추천 주제 | 톤 |
|----|---------|-----|
| 1월 | 부가세 2기 신고 기한 | "이 정도면 자신이 가능" |
| 5월 | 종소세 신고 방법 | "핵심 개념 + 전문가 도움 타이밍" |
| 7월 | 부가세 1기 신고 | "기초 정리 방법" |
| 11월 | 다음해 준비 | "계획하면 편해요" |
+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` 참고
---