# 마케팅 시스템 업그레이드 체크리스트 (task-1054.1)

**작성일:** 2026-03-26
**사용법:** 각 항목 완료 시 `[ ]` → `[x]`로 변경. 모든 항목 완료 시 해당 Phase 게이팅 통과.

---

## 사전 준비

- [ ] 백업 디렉토리 생성: `/home/jay/workspace/backups/marketing-upgrade-20260326/`
- [ ] 변경 대상 스킬 SKILL.md 원본 백업 완료 (Phase 2, 3 대상 전체)
- [ ] 검증 스크립트 경로 생성: `/home/jay/workspace/scripts/validate_marketing_upgrade.py`

---

## Phase 1: evals 도입

### 1-A. 기존 evals.json 무결성 확인 (변경 없음)

- [ ] `skills/copywriting/evals/evals.json` 존재 확인 (7개 eval)
- [ ] `skills/seo-audit/evals/evals.json` 존재 확인 (8개 eval)
- [ ] `skills/content-strategy/evals/evals.json` 존재 확인
- [ ] 3개 파일 JSON 파싱 유효성 확인 (python -m json.tool로 검증)

### 1-B. 신규 evals.json 생성 — ad-creative

- [ ] `skills/ad-creative/evals/` 디렉토리 생성
- [ ] `skills/ad-creative/evals/evals.json` 파일 생성
- [ ] skill_name: "ad-creative" 필드 포함
- [ ] eval 최소 5개 포함
- [ ] 각 eval에 id, prompt, expected_output, assertions, files 필드 포함
- [ ] paid-ads 라우팅 경계 케이스(eval) 포함
- [ ] JSON 파싱 유효성 확인

### 1-C. 신규 evals.json 생성 — ai-seo

- [ ] `skills/ai-seo/evals/` 디렉토리 생성
- [ ] `skills/ai-seo/evals/evals.json` 파일 생성
- [ ] skill_name: "ai-seo" 필드 포함
- [ ] eval 최소 5개 포함
- [ ] geo-optimizer 라우팅 경계 케이스(eval) 포함
- [ ] JSON 파싱 유효성 확인

### 1-D. 신규 evals.json 생성 — social-content

- [ ] `skills/social-content/evals/` 디렉토리 생성
- [ ] `skills/social-content/evals/evals.json` 파일 생성
- [ ] skill_name: "social-content" 필드 포함
- [ ] eval 최소 5개 포함
- [ ] thread-architect 라우팅 경계 케이스(eval) 포함
- [ ] JSON 파싱 유효성 확인

### 1-E. 신규 evals.json 생성 — paid-ads

- [ ] `skills/paid-ads/evals/` 디렉토리 생성
- [ ] `skills/paid-ads/evals/evals.json` 파일 생성
- [ ] skill_name: "paid-ads" 필드 포함
- [ ] eval 최소 5개 포함
- [ ] ad-creative 및 analytics-tracking 라우팅 경계 케이스(eval) 포함
- [ ] JSON 파싱 유효성 확인

### 1-F. 신규 evals.json 생성 — analytics-tracking

- [ ] `skills/analytics-tracking/evals/` 디렉토리 생성
- [ ] `skills/analytics-tracking/evals/evals.json` 파일 생성
- [ ] skill_name: "analytics-tracking" 필드 포함
- [ ] eval 최소 5개 포함
- [ ] paid-ads 라우팅 경계 케이스(eval) 포함
- [ ] JSON 파싱 유효성 확인

### Phase 1 완료 기준 (게이팅)
- [ ] 신규 evals.json 5개 모두 생성 완료
- [ ] 기존 evals.json 3개 무결성 확인 완료
- [ ] 전체 8개 파일 JSON 스키마 유효성 통과
- [ ] 각 파일 최소 5개 eval 포함 확인

**Phase 1 완료 서명:** __________ (날짜: __________)

---

## Phase 2: context 강화

### 2-A. 사전 백업

- [ ] `skills/blog-dominance/SKILL.md` 백업 완료
- [ ] `skills/geo-optimizer/SKILL.md` 백업 완료
- [ ] `skills/thread-architect/SKILL.md` 백업 완료
- [ ] `skills/naver-seo/SKILL.md` 백업 완료

### 2-B. Before Starting 섹션 추가 — blog-dominance

- [ ] `skills/blog-dominance/SKILL.md` 수정
- [ ] Before Starting 섹션 추가 (트리거 시스템 섹션 이전)
- [ ] `.agents/product-marketing-context.md` 참조 문구 포함
- [ ] `.claude/product-marketing-context.md` 대체 경로 포함
- [ ] 기존 트리거 시스템 섹션 변경 없음 확인
- [ ] diff 비교: 추가된 섹션 외 변경 없음 확인

### 2-C. Before Starting 섹션 추가 — geo-optimizer

- [ ] `skills/geo-optimizer/SKILL.md` 수정
- [ ] Before Starting 섹션 추가
- [ ] `.agents/product-marketing-context.md` 참조 문구 포함
- [ ] `.claude/product-marketing-context.md` 대체 경로 포함
- [ ] 기존 주요 섹션 변경 없음 확인
- [ ] diff 비교: 추가된 섹션 외 변경 없음 확인

### 2-D. Before Starting 섹션 추가 — thread-architect

- [ ] `skills/thread-architect/SKILL.md` 수정
- [ ] Before Starting 섹션 추가
- [ ] `.agents/product-marketing-context.md` 참조 문구 포함
- [ ] `.claude/product-marketing-context.md` 대체 경로 포함
- [ ] 기존 트리거 시스템 섹션 변경 없음 확인
- [ ] diff 비교: 추가된 섹션 외 변경 없음 확인

### 2-E. Before Starting 섹션 추가 — naver-seo

- [ ] `skills/naver-seo/SKILL.md` 수정
- [ ] Before Starting 섹션 추가
- [ ] `.agents/product-marketing-context.md` 참조 문구 포함
- [ ] `.claude/product-marketing-context.md` 대체 경로 포함
- [ ] 기존 트리거 시스템 섹션 변경 없음 확인
- [ ] diff 비교: 추가된 섹션 외 변경 없음 확인

### Phase 2 완료 기준 (게이팅)
- [ ] 4개 스킬 SKILL.md Before Starting 섹션 추가 완료
- [ ] 각 파일에 product-marketing-context 참조 문구 존재 확인
- [ ] diff 비교: 변경 범위가 Before Starting 섹션 추가에만 국한
- [ ] 핵심 로직 섹션 (트리거 시스템, 진출 트리거 등) 변경 없음 확인

**Phase 2 완료 서명:** __________ (날짜: __________)

---

## Phase 3: description 라우팅 보강

### 3-A. 사전 백업

- [ ] Phase 3 대상 스킬 SKILL.md 전체 백업 완료 (사전 백업 미완료 스킬 추가)

### 3-B. 우선순위 1: 경계 불명확 스킬 쌍 라우팅 (즉시 처리)

- [ ] `skills/ad-creative/SKILL.md` description에 "NOT for: 캠페인 전략·예산 배분(→ paid-ads 스킬)" 추가
- [ ] `skills/paid-ads/SKILL.md` description에 "NOT for: 광고 소재·카피 작성(→ ad-creative 스킬)" 추가
- [ ] `skills/social-content/SKILL.md` description에 "NOT for: 트윗 스레드(→ thread-architect 스킬)" 추가
- [ ] `skills/ai-seo/SKILL.md` description에 "NOT for: GEO 심화(→ geo-optimizer 스킬)" 추가
- [ ] `skills/geo-optimizer/SKILL.md` description에 "NOT for: AI SEO 콘텐츠(→ ai-seo 스킬)" 추가 (기존 NOT for 패턴 활용)
- [ ] `skills/copywriting/SKILL.md` description 라우팅 현황 확인 ("For email copy, see email-sequence" 등 기존 라우팅 보존)

### 3-C. 우선순위 2: 핵심 8개 스킬 라우팅 보강

- [ ] ad-creative description 라우팅 최종 확인
- [ ] copywriting description 라우팅 최종 확인
- [ ] content-strategy description에 "NOT for: 개별 콘텐츠 작성(→ copywriting), SEO 진단(→ seo-audit)" 추가
- [ ] seo-audit description 라우팅 현황 확인 (기존 패턴 보존)
- [ ] ai-seo description 라우팅 최종 확인
- [ ] social-content description 라우팅 최종 확인
- [ ] paid-ads description 라우팅 최종 확인
- [ ] analytics-tracking description에 "NOT for: 광고 캠페인 전략(→ paid-ads), RevOps(→ revops)" 추가

### 3-D. 우선순위 3: 나머지 마케팅 스킬 라우팅 보강

- [ ] copywriting-prompt description 라우팅 추가
- [ ] copy-editing description 라우팅 추가 (copywriting과의 경계)
- [ ] lead-magnets description 라우팅 추가
- [ ] email-sequence description 라우팅 추가 (copywriting과의 경계)
- [ ] cold-email description 라우팅 추가 (email-sequence와의 경계)
- [ ] churn-prevention description 라우팅 추가
- [ ] revops description 라우팅 추가
- [ ] launch-strategy description 라우팅 추가
- [ ] marketing-ideas description 라우팅 추가
- [ ] marketing-psychology description 라우팅 추가
- [ ] referral-program description 라우팅 추가
- [ ] competitor-alternatives description 라우팅 추가
- [ ] free-tool-strategy description 라우팅 추가
- [ ] sales-enablement description 라우팅 추가 (revops와의 경계)
- [ ] programmatic-seo description 라우팅 추가 (seo-audit과의 경계)
- [ ] schema-markup description 라우팅 추가 (seo-audit과의 경계)
- [ ] site-architecture description 라우팅 추가
- [ ] blog-dominance description 라우팅 추가/보강 (기존 NOT for 패턴 표준화)
- [ ] geo-optimizer description 라우팅 추가/보강 (기존 NOT for 패턴 표준화)
- [ ] thread-architect description 라우팅 추가
- [ ] naver-seo description 라우팅 추가/보강 (기존 NOT for 패턴 표준화)
- [ ] ab-test-setup description 라우팅 추가
- [ ] pricing-strategy description 라우팅 추가

### Phase 3 완료 기준 (게이팅)
- [ ] 우선순위 1 스킬 쌍 라우팅 추가 완료 (6개 스킬)
- [ ] 핵심 8개 스킬 라우팅 보강 완료
- [ ] 나머지 23개 스킬 라우팅 보강 완료
- [ ] YAML frontmatter 파싱 오류 없음 (python -c "import yaml" 테스트)
- [ ] 라우팅에서 참조하는 스킬명이 모두 존재하는 디렉토리인지 확인
- [ ] 기존 description 내용(Use when, 트리거 키워드) 변경 없음 확인

**Phase 3 완료 서명:** __________ (날짜: __________)

---

## Phase 4: 통합 검증

### 4-A. 검증 스크립트 준비

- [ ] `/home/jay/workspace/scripts/validate_marketing_upgrade.py` 생성 완료
- [ ] V1 (evals 스키마 검증) 함수 구현
- [ ] V2 (description YAML 유효성) 함수 구현
- [ ] V3 (Before Starting 참조 확인) 함수 구현
- [ ] V4 (라우팅 패턴 일관성) 함수 구현
- [ ] V5 (핵심 로직 변경 무결성) 함수 구현
- [ ] `--target all/evals/context/routing` 옵션 구현

### 4-B. 정적 검증 실행

- [ ] V1 evals 스키마 검증: 8개 스킬 모두 pass
- [ ] V2 description YAML 유효성: 변경된 모든 스킬 pass
- [ ] V3 Before Starting 참조: 4개 스킬 pass
- [ ] V4 라우팅 패턴 일관성: 존재하지 않는 스킬 참조 없음 pass
- [ ] V5 핵심 로직 무결성: 백업 대비 변경 없음 pass
- [ ] 검증 리포트 JSON 생성 확인

### 4-C. 회귀 테스트 기준 확인

- [ ] 백업 파일 vs 현재 파일 diff 비교 완료 (각 수정 파일)
- [ ] 추가된 내용 외 기존 내용 변경 없음 확인
- [ ] 동적 회귀 테스트 일정 수립 완료

### 4-D. 최종 검토

- [ ] dispatch.py 변경 없음 확인
- [ ] team_prompts.py 변경 없음 확인
- [ ] org-details/*.json 변경 없음 확인
- [ ] 기존 evals.json 3개 (copywriting, seo-audit, content-strategy) 변경 없음 확인
- [ ] 백업 디렉토리 정리 (성공 후 유지 or 삭제 결정)

### Phase 4 완료 기준 (게이팅)
- [ ] 검증 스크립트 5개 항목 모두 pass 또는 warn
- [ ] fail 항목 0개
- [ ] 회귀 테스트 계획 수립 완료

**Phase 4 완료 서명:** __________ (날짜: __________)

---

## 전체 완료 기준

- [ ] Phase 1 완료 (evals.json 8개 확보)
- [ ] Phase 2 완료 (context 강화 4개 스킬)
- [ ] Phase 3 완료 (description 라우팅 전체 마케팅 스킬)
- [ ] Phase 4 완료 (검증 스크립트 pass)
- [ ] 미팅 기록 업데이트 (완료 상태 반영)
- [ ] task-1054.1 완료 처리

---

## 빠른 참조: 대상 파일 목록

### Phase 1 신규 생성
```
skills/ad-creative/evals/evals.json
skills/ai-seo/evals/evals.json
skills/social-content/evals/evals.json
skills/paid-ads/evals/evals.json
skills/analytics-tracking/evals/evals.json
```

### Phase 2 수정
```
skills/blog-dominance/SKILL.md
skills/geo-optimizer/SKILL.md
skills/thread-architect/SKILL.md
skills/naver-seo/SKILL.md
```

### Phase 3 수정 (우선순위 1 - 즉시)
```
skills/ad-creative/SKILL.md
skills/paid-ads/SKILL.md
skills/social-content/SKILL.md
skills/ai-seo/SKILL.md
skills/geo-optimizer/SKILL.md
skills/copywriting/SKILL.md (확인)
```

### Phase 4 생성
```
scripts/validate_marketing_upgrade.py
```

---

*체크리스트 버전: 1.0 | task-1054.1*