# 작업 지시서: 마케팅 시스템 업그레이드 (task-1048.1 후속)

## 작업 ID: task-1054.1
## 레벨: Lv.3 (한정승인)
## 팀: dev2-team (오딘)

## 배경
task-1048.1에서 coreyhaines31/marketingskills 레포를 심층 분석한 결과, 우리 마케팅 시스템에 도입 가능한 3가지 핵심 요소가 식별됨:
1. **evals 시스템** — 스킬 품질 정량 보증 (197개 테스트 케이스 패턴)
2. **product-marketing-context 공유 아키텍처** — 모든 스킬이 단일 컨텍스트 참조
3. **description 라우팅 + 경계 테스트** — 스킬 간 정확한 라우팅 명세

분석 보고서: `/home/jay/workspace/memory/reports/task-1048.1.md`

## 에이전트 미팅 (5사이클 필수)

### 미팅 참석자 (필수)
- **로키 (DA/레드팀)** — 필수 참석. 기존 시스템 파괴 리스크 검증
- **아프로디테 (마케팅팀장)** — 마케팅 스킬 운영 관점
- **아르고스 (QA)** — 테스트/검증 관점
- **불칸 (백엔드)** — 기술 구현 관점

### 미팅 안건
1. **기존 시스템 현황 파악**: 현재 85개 스킬(`/home/jay/.claude/skills/`)의 구조, 마케팅팀 스킬 배치(`/home/jay/workspace/memory/org-details/marketing-team.json`), 운영 로직
2. **도입 항목별 충돌 분석**: 각 도입 요소가 기존 스킬/팀 프롬프트/dispatch 로직과 충돌하는 지점 식별
3. **Phase 분리 설계**: 각 도입 요소별 독립 Phase 설계, 의존성 그래프 작성
4. **롤백 전략**: 문제 발생 시 Phase별 원복 가능한 구조 설계
5. **검증 계획**: Phase별 검증 기준 (기존 스킬 회귀 테스트 포함)

### 미팅 결과물
- 3문서: 계획서 / 맥락노트 / 체크리스트
- Phase별 상세 실행 계획 (파일 단위까지)
- 충돌 분석 매트릭스 (기존 파일 × 변경 사항)

## 도입 대상 (즉시 도입 3건)

### 1. evals 시스템 도입
- 마케팅 관련 스킬에 evals.json 추가
- 경계 테스트 포함 (다른 스킬로 라우팅해야 하는 케이스)
- 검증 스크립트 도입 (validate-skills 패턴 참고)
- **대상 스킬**: ad-creative, copywriting, content-strategy, seo-audit, ai-seo, social-content, paid-ads, analytics-tracking 등 마케팅 핵심 스킬

### 2. product-marketing-context 공유 아키텍처 강화
- 기존 `product-marketing-context` 스킬이 이미 존재 (`/home/jay/.claude/skills/product-marketing-context/`)
- 현재 구조 분석 → coreyhaines31 패턴과 비교 → 개선점 도출
- 모든 마케팅 스킬의 "Before Starting" 섹션에 컨텍스트 참조 로직 추가/강화
- **주의**: 기존 스킬 동작을 깨뜨리지 않는 방식으로 (additive only)

### 3. description 라우팅 명세 강화
- 마케팅 스킬의 description에 경계 라우팅 명세 추가
- "이 작업은 X 스킬로" 같은 명확한 안내
- 기존 description을 덮어쓰지 않고 **보강**하는 방식

## 절대 주의사항 (충돌 방지)

### 건드리면 안 되는 것
- `dispatch.py` — 위임 로직은 별도 작업
- `prompts/team_prompts.py` — 팀 프롬프트는 별도 작업
- `memory/org-details/*.json` — 조직도 변경은 아누 승인 필요
- 기존 스킬의 **핵심 로직** (Core Principles, Output Format) — 보강만, 교체 금지

### 허용되는 변경
- 스킬 디렉토리 내 evals.json 신규 생성
- 스킬 SKILL.md의 description 보강 (기존 내용 유지 + 라우팅 추가)
- 스킬 SKILL.md의 "Before Starting" 섹션에 컨텍스트 참조 추가
- references/ 디렉토리 신규 생성 (대용량 데이터 외부화)
- 검증 스크립트 신규 생성

### Phase 분리 원칙
- **1 Phase = 1 독립 작업 단위** (세션이 죽어도 이어갈 수 있어야 함)
- Phase 간 연결 = 파일(산출물 경로)
- 각 Phase 완료 시: 기존 스킬 회귀 테스트 수행
- Phase 순서: 분석(현황 파악) → 설계(3문서) → evals 도입 → context 강화 → description 라우팅 → 통합 검증

## 산출물
- 에이전트 미팅 기록: `memory/meetings/marketing-system-upgrade.md` (5사이클)
- 3문서: `memory/specs/marketing-upgrade-plan.md`, `memory/specs/marketing-upgrade-context-note.md`, `memory/specs/marketing-upgrade-checklist.md`
- 충돌 분석 매트릭스: `memory/specs/marketing-upgrade-conflict-matrix.md`
- Phase별 실행 결과: 각 Phase 보고서
- 최종 통합 보고서: `memory/reports/task-1054.1.md`