feat(gtm-guardian): Reorganize skill with dual-platform structure

- Add desktop/ directory for Claude Desktop (Phase 1-5: analysis, design, docs) - Add code/ directory for Claude Code (Phase 6-7: automation, audit) - Create SKILL.md with YAML frontmatter for Desktop compatibility - Create CLAUDE.md for Code automation workflows - Organize references by platform scope with shared files duplicated - Add templates for tagging plan and event taxonomy - Include README.md with overview and usage guide 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-31 19:59:22 +09:00
parent c6ab33726f
commit b859d0a266
22 changed files with 3214 additions and 0 deletions
--- a/custom-skills/22-gtm-guardian/desktop/SKILL.md
+++ b/custom-skills/22-gtm-guardian/desktop/SKILL.md
@@ -0,0 +1,121 @@
+---
+name: gtm-guardian
+description: |
+  Google Tag Manager 태깅 전략 수립부터 구현까지 7단계 워크플로우를 지원하는 SMART Tool.
+
+  Triggers:
+  - GTM 태깅 계획, Tagging Plan 작성, 이벤트 설계
+  - DataLayer 스키마 설계, dataLayer 구현 가이드
+  - 사용자 행동 분석, User Behaviour Modeling, KPI 정의
+  - Event Taxonomy, 이벤트 택소노미, 이벤트 명명 규칙
+  - GTM 구현 가이드, 태그 설정 체크리스트
+  - Server-side GTM, sGTM, Stape, Google Tag Gateway
+  - GA4 이벤트, Meta Pixel, Kakao Pixel, Google Ads 전환 추적
+---
+
+# GTM Guardian (Desktop)
+
+GTM(Google Tag Manager) 태깅 전략 수립부터 구현까지의 전체 라이프사이클을 지원하는 7단계 워크플로우 스킬.
+
+**Desktop 범위**: Phase 1-5 (분석, 설계, 문서 작성, Browser 분석, Notion 연동)
+
+## 7-Phase Workflow Overview
+
+| Phase | Name | Output | Tools |
+|-------|------|--------|-------|
+| 1 | Web/App Analysis | DOM 분석 리포트 | Browser MCP |
+| 2 | User Behaviour & KPI | 행동 흐름도, KPI 정의서 | Notion MCP |
+| 3 | Tagging Plan | 태깅 계획서 | templates/ |
+| 4 | Event Taxonomy | 이벤트 택소노미 시트 | Google Sheets |
+| 5 | Implementation Guide | 구현 가이드, 체크리스트 | Notion MCP |
+| 6 | Progressive Audit | 진단 리포트 | **→ Claude Code** |
+| 7 | Lookup App | 이벤트 조회 앱 | **→ Claude Code** |
+
+## Quick Start
+
+```
+사용자 요청 분석 → Phase 식별 → 해당 Phase 워크플로우 실행 → Notion 저장
+```
+
+### Phase 식별 가이드
+
+| 키워드 | Phase | Reference |
+|--------|-------|-----------|
+| "사이트 분석", "DOM", "요소 분석" | 1 | [phase1-analysis.md](references/phase1-analysis.md) |
+| "행동 분석", "KPI", "전환 정의" | 2 | [phase2-behaviour.md](references/phase2-behaviour.md) |
+| "태깅 계획", "Tagging Plan" | 3 | [phase3-tagging-plan.md](references/phase3-tagging-plan.md) |
+| "이벤트 택소노미", "명명 규칙" | 4 | [phase4-taxonomy.md](references/phase4-taxonomy.md) |
+| "구현 가이드", "체크리스트" | 5 | [phase5-implementation.md](references/phase5-implementation.md) |
+| "진단", "감사", "업데이트" | 6 | → Claude Code 권장 |
+| "조회 앱", "Lookup" | 7 | → Claude Code 권장 |
+
+## Core References
+
+### DataLayer & Events
+- [datalayer-schema.md](references/datalayer-schema.md) - GA4 권장 이벤트 기반 DataLayer 스키마
+- [platform-mapping.md](references/platform-mapping.md) - GA4, Meta, Kakao, Google Ads 이벤트 매핑
+- [naming-conventions.md](references/naming-conventions.md) - 태그/트리거/변수 네이밍 규칙
+
+### Server-side GTM
+- [sgtm-guide.md](references/sgtm-guide.md) - sGTM 아키텍처 및 Stape 설정
+
+### Implementation
+- [qa-checklist.md](references/qa-checklist.md) - 구현 QA 체크리스트
+
+### Templates
+- [tagging-plan-template.md](templates/tagging-plan-template.md) - 태깅 계획서 템플릿
+- [event-taxonomy-template.csv](templates/event-taxonomy-template.csv) - 이벤트 택소노미 시트 템플릿
+
+## Notion Integration
+
+산출물 저장 대상: [GTM Knowledge Base](https://www.notion.so/dintelligence/2cf581e58a1e80c8b358f1625356e931)
+
+### 저장 워크플로우 (MCP)
+1. `notion/API-post-search`로 대상 페이지/DB 탐색
+2. Phase별 템플릿 적용하여 콘텐츠 구성
+3. `notion/API-post-page`로 페이지 생성
+4. 상위 페이지에 링크 추가
+
+### Page Naming Convention
+```
+[Phase#] - [Project] - [Type] - [Date]
+예: P3 - ClientA - Tagging Plan - 2025-01
+```
+
+## Site Type Patterns
+
+| Site Type | Key Events | Focus Areas |
+|-----------|------------|-------------|
+| E-commerce | view_item, add_to_cart, purchase | Transaction, ROAS |
+| Lead Gen | generate_lead, form_submit | Form tracking, Lead value |
+| SaaS | sign_up, subscription_* | Activation, Retention |
+| Media | article_view, scroll, video_* | Engagement depth |
+| B2B | demo_request, pricing_view | Funnel progression |
+
+## Execution Principles
+
+1. **Phase 순서 준수**: 선행 Phase 완료 후 다음 단계
+2. **문서화 우선**: 모든 결정사항 Notion에 기록
+3. **점진적 구현**: 핵심 이벤트 → 확장 이벤트
+4. **검증 필수**: 구현 후 QA 체크리스트 수행
+5. **버전 관리**: GTM 컨테이너 버전 및 문서 버전 추적
+
+## Browser Analysis (Phase 1)
+
+Browser MCP 또는 Firecrawl MCP를 활용한 DOM 분석:
+
+```
+1. 페이지 렌더링 후 DOM 분석
+2. 주요 요소 식별 (CTA, 폼, 상품 목록)
+3. 기존 dataLayer 상태 확인
+4. 트리거 가능 요소 문서화
+```
+
+## Error Handling
+
+| Issue | Resolution |
+|-------|------------|
+| DataLayer 미구현 | 개발팀 가이드 제공, 우선순위 태그로 시작 |
+| 이벤트 누락 | Phase 1-2 재검토 |
+| 태그 미발화 | Phase 5 체크리스트, GTM Preview 디버깅 |
+| 데이터 정합성 오류 | GA4 DebugView 검증 |
--- a/custom-skills/22-gtm-guardian/desktop/references/datalayer-schema.md
+++ b/custom-skills/22-gtm-guardian/desktop/references/datalayer-schema.md
@@ -0,0 +1,193 @@
+# DataLayer Schema Reference
+
+GA4 권장 이벤트 기반 DataLayer 스키마 정의.
+
+## Core Principles
+
+1. GTM 스니펫 이전에 dataLayer 초기화
+2. 이벤트 발생 시점에 push (사전 아님)
+3. ecommerce 객체는 push 전 clear 필수
+4. PII 데이터 직접 수집 금지
+
+## Base Structure
+
+### Page Load
+```javascript
+window.dataLayer = window.dataLayer || [];
+dataLayer.push({
+  'event': 'page_data',
+  'page': {
+    'type': 'home|category|product|cart|checkout|thankyou|content|search',
+    'name': 'Page Name',
+    'category': 'Category/Subcategory',
+    'language': 'ko'
+  },
+  'user': {
+    'status': 'logged_in|logged_out',
+    'id': 'hashed_user_id',           // SHA256, 로그인 시에만
+    'type': 'new|returning|member|guest',
+    'loginMethod': 'email|kakao|naver|google'
+  }
+});
+```
+
+## E-commerce Events
+
+### view_item
+```javascript
+dataLayer.push({ ecommerce: null });
+dataLayer.push({
+  'event': 'view_item',
+  'ecommerce': {
+    'currency': 'KRW',
+    'value': 29000,
+    'items': [{
+      'item_id': 'SKU_12345',
+      'item_name': 'Product Name',
+      'item_brand': 'Brand Name',
+      'item_category': 'Category',
+      'item_variant': 'Blue / Large',
+      'price': 29000,
+      'quantity': 1
+    }]
+  }
+});
+```
+
+### add_to_cart
+```javascript
+dataLayer.push({ ecommerce: null });
+dataLayer.push({
+  'event': 'add_to_cart',
+  'ecommerce': {
+    'currency': 'KRW',
+    'value': 29000,
+    'items': [{
+      'item_id': 'SKU_12345',
+      'item_name': 'Product Name',
+      'price': 29000,
+      'quantity': 1
+    }]
+  }
+});
+```
+
+### begin_checkout
+```javascript
+dataLayer.push({ ecommerce: null });
+dataLayer.push({
+  'event': 'begin_checkout',
+  'ecommerce': {
+    'currency': 'KRW',
+    'value': 58000,
+    'coupon': 'WELCOME10',
+    'items': [/* cart items */]
+  }
+});
+```
+
+### purchase
+```javascript
+dataLayer.push({ ecommerce: null });
+dataLayer.push({
+  'event': 'purchase',
+  'ecommerce': {
+    'transaction_id': 'T_20250115_001',
+    'affiliation': 'Store Name',
+    'value': 53000,
+    'tax': 4818,
+    'shipping': 3000,
+    'currency': 'KRW',
+    'coupon': 'WELCOME10',
+    'items': [{
+      'item_id': 'SKU_12345',
+      'item_name': 'Product Name',
+      'price': 29000,
+      'quantity': 1
+    }]
+  }
+});
+```
+
+## Lead Gen Events
+
+### generate_lead
+```javascript
+dataLayer.push({
+  'event': 'generate_lead',
+  'currency': 'KRW',
+  'value': 50000,
+  'lead': {
+    'source': 'contact_form|landing_page',
+    'type': 'inquiry|quote_request'
+  }
+});
+```
+
+### form_submit
+```javascript
+dataLayer.push({
+  'event': 'form_submit',
+  'form': {
+    'id': 'contact_form',
+    'name': 'Contact Us Form',
+    'type': 'contact',
+    'success': true
+  }
+});
+```
+
+## Engagement Events
+
+### login / sign_up
+```javascript
+dataLayer.push({
+  'event': 'login',  // or 'sign_up'
+  'method': 'email|kakao|naver|google'
+});
+```
+
+### search
+```javascript
+dataLayer.push({
+  'event': 'search',
+  'search_term': 'user search query',
+  'search': {
+    'results_count': 42,
+    'category': 'product|content'
+  }
+});
+```
+
+## Item Object Reference
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| item_id | string | Yes | SKU |
+| item_name | string | Yes | 상품명 |
+| price | number | Yes | 단가 |
+| quantity | number | Yes | 수량 |
+| item_brand | string | No | 브랜드명 |
+| item_category | string | No | 카테고리 |
+| item_category2-5 | string | No | 하위 카테고리 |
+| item_variant | string | No | 옵션 |
+| coupon | string | No | 쿠폰 코드 |
+| discount | number | No | 할인 금액 |
+| index | number | No | 목록 위치 |
+
+## Validation Rules
+
+```javascript
+// ✅ Correct
+'price': 29000        // number
+'quantity': 1         // number
+'currency': 'KRW'     // uppercase
+
+// ❌ Wrong
+'price': '29000'      // string
+'currency': 'krw'     // lowercase
+```
+
+### Array Limits
+- items[]: 최대 200개
+- 초과 시 분할 전송
--- a/custom-skills/22-gtm-guardian/desktop/references/naming-conventions.md
+++ b/custom-skills/22-gtm-guardian/desktop/references/naming-conventions.md
@@ -0,0 +1,130 @@
+# GTM Naming Conventions
+
+일관된 GTM 컨테이너 관리를 위한 네이밍 규칙.
+
+## Tag Naming
+
+### Pattern
+```
+[Platform] - [Type] - [Description]
+```
+
+### Examples
+| Platform | Type | Description | Tag Name |
+|----------|------|-------------|----------|
+| GA4 | Config | Main | GA4 - Config - Main |
+| GA4 | Event | purchase | GA4 - Event - purchase |
+| GAds | Conversion | Purchase | GAds - Conversion - Purchase |
+| Meta | Event | Purchase | Meta - Event - Purchase |
+| Kakao | Event | purchase | Kakao - Event - purchase |
+
+## Trigger Naming
+
+### Pattern
+```
+[Type] - [Condition] - [Context]
+```
+
+### Type Codes
+| Code | Type | Example |
+|------|------|---------|
+| PV | Page View | PV - All Pages |
+| DL | DataLayer Event | DL - purchase |
+| Click | Click | Click - CTA Button |
+| Form | Form Submit | Form - Contact |
+| Scroll | Scroll Depth | Scroll - 75% |
+| Vis | Element Visibility | Vis - Video Player |
+
+### Examples
+```
+PV - All Pages
+PV - Thank You Page
+DL - purchase
+DL - add_to_cart
+Click - CTA Button - Hero
+Form - Contact Form
+Scroll - 90%
+```
+
+## Variable Naming
+
+### Pattern
+```
+[Type] - [Name/Path]
+```
+
+### Type Codes
+| Code | Type | Example |
+|------|------|---------|
+| DLV | DataLayer Variable | DLV - ecommerce.value |
+| CJS | Custom JavaScript | CJS - Item IDs Array |
+| Const | Constant | Const - GA4 Measurement ID |
+| LT | Lookup Table | LT - Page Type Mapping |
+| URL | URL Variable | URL - Path |
+| DOM | DOM Element | DOM - Product Title |
+
+### Examples
+```
+DLV - event
+DLV - ecommerce.transaction_id
+DLV - ecommerce.items
+CJS - Items for Meta
+CJS - Formatted Price
+Const - GA4 Measurement ID
+Const - Meta Pixel ID
+LT - Payment Method Mapping
+```
+
+## Folder Structure
+
+```
+📁 01. Configuration
+📁 02. GA4 Events
+📁 03. Google Ads
+📁 04. Meta Pixel
+📁 05. Kakao Pixel
+📁 06. Other Platforms
+📁 07. Utilities
+📁 99. Deprecated
+```
+
+## Built-in Variables to Enable
+
+```
+Pages: ✅ Page URL, Path, Hostname, Referrer
+Utilities: ✅ Event, Container ID, Random Number
+Clicks: ✅ Element, Classes, ID, URL, Text
+Forms: ✅ Element, Classes, ID, URL, Text
+History: ✅ New/Old History Fragment/State
+Videos: ✅ All YouTube variables
+Scrolling: ✅ Depth Threshold, Units, Direction
+Visibility: ✅ Percent Visible, On-Screen Duration
+```
+
+## Anti-patterns
+
+```
+❌ Tag 1, New Tag, Test
+❌ GA4 purchase event (일관성 없음)
+❌ G4-E-Pch (과도한 약어)
+❌ Very Long Tag Name for Purchase Complete Event (너무 김)
+
+✅ GA4 - Event - purchase
+✅ DL - purchase
+✅ CJS - Items for Meta
+```
+
+## Version Notes
+
+```
+v[Major].[Minor] - [Description]
+예: v12.1 - Added form_submit event
+
+## Changes
+- Added: 
+- Modified: 
+- Removed: 
+
+## Reason
+[변경 이유]
+```
--- a/custom-skills/22-gtm-guardian/desktop/references/phase1-analysis.md
+++ b/custom-skills/22-gtm-guardian/desktop/references/phase1-analysis.md
@@ -0,0 +1,115 @@
+# Phase 1: Web/App Analysis
+
+웹사이트 또는 앱의 태깅 가능 요소를 분석하여 DOM 구조, 동적 요소, 트리거 포인트를 파악.
+
+## Objectives
+
+1. Rendered HTML 소스 분석
+2. DOM 구조 및 주요 요소 식별
+3. 동적 요소 및 SPA 동작 파악
+4. 트리거 구성 가능 요소 도출
+
+## Analysis Checklist
+
+### 1. Page Structure
+- [ ] 페이지 유형 분류 (home, category, product, cart, checkout, thankyou)
+- [ ] URL 패턴 분석 (path, query params)
+- [ ] 페이지 템플릿 구조 파악
+
+### 2. Interactive Elements
+- [ ] CTA 버튼 (class, id, data-* attributes)
+- [ ] 폼 요소 (form id, input names)
+- [ ] 네비게이션 링크
+- [ ] 아코디언/탭/모달 요소
+
+### 3. E-commerce Elements (해당 시)
+- [ ] 상품 목록 컨테이너
+- [ ] 상품 카드 구조 (SKU, price, name 위치)
+- [ ] 장바구니 버튼
+- [ ] 결제 버튼
+- [ ] 주문 완료 정보 위치
+
+### 4. Dynamic Content
+- [ ] SPA/Ajax 로딩 패턴
+- [ ] Infinite scroll
+- [ ] Dynamic pricing
+- [ ] User-dependent content
+
+## Browser Analysis Steps
+
+```
+1. DevTools Console에서 dataLayer 확인
+   > window.dataLayer
+
+2. DOM 구조 분석
+   > document.querySelectorAll('[data-gtm]')
+   > document.querySelectorAll('form')
+   > document.querySelectorAll('[class*="cta"], [class*="button"]')
+
+3. 네트워크 탭에서 기존 태그 확인
+   > google-analytics.com, googletagmanager.com 요청 필터
+
+4. 이벤트 리스너 확인
+   > getEventListeners(document.querySelector('#element'))
+```
+
+## Output Template
+
+```markdown
+# [사이트명] DOM Analysis Report
+
+## Site Overview
+- **URL**: 
+- **Type**: E-commerce / Lead Gen / SaaS / Media / B2B
+- **Framework**: WordPress / React / Vue / Custom
+
+## Page Types Identified
+| Page Type | URL Pattern | Key Elements |
+|-----------|-------------|--------------|
+| Home | / | hero_cta, featured_products |
+| Product | /product/* | add_to_cart, product_details |
+
+## Taggable Elements
+### Buttons & CTAs
+| Element | Selector | Current ID/Class | Recommended Trigger |
+|---------|----------|------------------|---------------------|
+| Add to Cart | .add-to-cart | N/A | Click - Class Match |
+
+### Forms
+| Form | ID/Name | Fields | Submit Button |
+|------|---------|--------|---------------|
+
+### Dynamic Elements
+| Element | Type | Loading Pattern | Trigger Strategy |
+|---------|------|-----------------|------------------|
+
+## Existing GTM/Analytics
+- [ ] GTM Container: GTM-XXXXXX
+- [ ] GA4: G-XXXXXXXX
+- [ ] Other pixels: 
+
+## Recommendations
+1. 
+2. 
+```
+
+## Common Patterns
+
+### WordPress/WooCommerce
+- Product: `.single-product`, `add_to_cart` class
+- Cart: `.woocommerce-cart-form`
+- Checkout: `.woocommerce-checkout`
+
+### Shopify
+- Product: data-product-id attribute
+- Cart: form[action="/cart/add"]
+- Checkout: checkout.shopify.com 별도 도메인
+
+### React/SPA
+- History API 변경 감지 필요
+- Custom Event 트리거 활용
+- MutationObserver 고려
+
+## Next Phase
+
+분석 완료 후 → Phase 2: User Behaviour Modeling
--- a/custom-skills/22-gtm-guardian/desktop/references/phase2-behaviour.md
+++ b/custom-skills/22-gtm-guardian/desktop/references/phase2-behaviour.md
@@ -0,0 +1,167 @@
+# Phase 2: User Behaviour Modeling & KPI Definition
+
+사용자의 웹/앱 사용 흐름을 분석하고, 중점 관리 행동과 KPI를 정의.
+
+## Objectives
+
+1. 사용자 여정(User Journey) 매핑
+2. 핵심 전환 포인트(Conversion Points) 식별
+3. KPI 및 측정 지표 정의
+4. 이벤트 우선순위 결정
+
+## User Journey Framework
+
+### Standard Funnel Stages
+```
+Awareness → Interest → Consideration → Intent → Purchase → Loyalty
+    ↓          ↓           ↓            ↓          ↓         ↓
+ Landing    Browse     View Item    Add Cart   Checkout   Repeat
+```
+
+### Site Type별 Journey
+
+#### E-commerce
+```
+Landing → Category → Product View → Add to Cart → Checkout → Purchase
+                          ↓
+                    Wishlist/Compare
+```
+
+#### Lead Generation
+```
+Landing → Content Browse → Form View → Form Start → Form Submit → Thank You
+                               ↓
+                         Chat/Call CTA
+```
+
+#### SaaS
+```
+Landing → Pricing → Sign Up Start → Email Verify → Onboarding → Activation
+                         ↓
+                   Demo Request
+```
+
+## Conversion Points Definition
+
+### Macro Conversions (Hard)
+| Conversion | Business Value | Typical Events |
+|------------|----------------|----------------|
+| Purchase | Revenue | purchase |
+| Lead Submit | Lead value | generate_lead |
+| Sign Up | LTV estimate | sign_up |
+| Subscription | MRR | subscribe |
+
+### Micro Conversions (Soft)
+| Conversion | Intent Signal | Typical Events |
+|------------|---------------|----------------|
+| Add to Cart | Purchase intent | add_to_cart |
+| Form Start | Engagement | form_start |
+| Video Complete | Content consumption | video_complete |
+| Scroll 75% | Page engagement | scroll |
+
+## KPI Framework
+
+### SMART KPI Template
+```
+Metric: [이름]
+Definition: [정의]
+Formula: [계산식]
+Target: [목표값]
+Tracking Event: [관련 이벤트]
+```
+
+### Standard E-commerce KPIs
+| KPI | Formula | Events Required |
+|-----|---------|-----------------|
+| Conversion Rate | transactions / sessions | purchase, session_start |
+| AOV | revenue / transactions | purchase |
+| Cart Abandonment | 1 - (purchases / carts) | add_to_cart, purchase |
+| Product View Rate | product_views / sessions | view_item |
+
+### Lead Gen KPIs
+| KPI | Formula | Events Required |
+|-----|---------|-----------------|
+| Lead Conversion Rate | leads / sessions | generate_lead |
+| Form Completion Rate | submits / form_starts | form_start, form_submit |
+| Cost per Lead | ad_spend / leads | generate_lead + ad data |
+
+### Engagement KPIs
+| KPI | Formula | Events Required |
+|-----|---------|-----------------|
+| Avg Session Duration | total_time / sessions | Enhanced Measurement |
+| Pages per Session | pageviews / sessions | page_view |
+| Scroll Depth | avg(scroll_percent) | scroll |
+
+## Event Priority Matrix
+
+### Priority 1 (Must Have)
+- purchase / generate_lead (primary conversion)
+- begin_checkout (funnel step)
+- add_to_cart (intent signal)
+- page_view (baseline)
+
+### Priority 2 (Should Have)
+- view_item (product engagement)
+- form_start (form engagement)
+- login / sign_up (user identity)
+- search (intent signal)
+
+### Priority 3 (Nice to Have)
+- scroll_depth (engagement)
+- video_progress (content consumption)
+- share (virality)
+- cta_click (UI interaction)
+
+## Output Template
+
+```markdown
+# [프로젝트명] User Behaviour & KPI Report
+
+## User Journey Map
+[Mermaid diagram 또는 텍스트 플로우차트]
+
+## Conversion Points
+### Macro Conversions
+| Conversion | Value | Priority | Event |
+|------------|-------|----------|-------|
+
+### Micro Conversions
+| Conversion | Signal | Priority | Event |
+|------------|--------|----------|-------|
+
+## KPI Definition
+### Primary KPIs
+| KPI | Formula | Target | Tracking |
+|-----|---------|--------|----------|
+
+### Secondary KPIs
+| KPI | Formula | Target | Tracking |
+|-----|---------|--------|----------|
+
+## Event Priority List
+### Must Track (P1)
+- 
+### Should Track (P2)
+-
+### Nice to Track (P3)
+-
+
+## Custom Dimensions Required
+| Dimension | Scope | Values | Purpose |
+|-----------|-------|--------|---------|
+
+## Custom Metrics Required
+| Metric | Type | Unit | Purpose |
+|--------|------|------|---------|
+```
+
+## Stakeholder Input Needed
+
+- Marketing: 캠페인 목표, 전환 가치
+- Sales: Lead qualification criteria
+- Product: 핵심 사용자 액션
+- Analytics: 리포팅 요구사항
+
+## Next Phase
+
+KPI 정의 완료 후 → Phase 3: Tagging Plan Design
--- a/custom-skills/22-gtm-guardian/desktop/references/phase3-tagging-plan.md
+++ b/custom-skills/22-gtm-guardian/desktop/references/phase3-tagging-plan.md
@@ -0,0 +1,169 @@
+# Phase 3: Tagging Plan Design
+
+사용자 행동 흐름에 맞춘 맞춤 이벤트 정의, 명명 규칙, 파라미터, 맞춤 측정 기준/지표 설계.
+
+## Objectives
+
+1. Custom Event 정의
+2. 이벤트 명명 규칙 수립
+3. 환경 변수 및 파라미터 정의
+4. Custom Dimensions/Metrics 설계
+5. DataLayer 스키마 연계
+
+## Tagging Plan Document Structure
+
+### 1. Executive Summary
+```
+Project: [프로젝트명]
+Client: [클라이언트명]
+Website/App: [URL/앱명]
+Version: 1.0
+Last Updated: YYYY-MM-DD
+Author: [작성자]
+```
+
+### 2. Measurement Objectives
+| Priority | Objective | KPI | Target |
+|----------|-----------|-----|--------|
+| P1 | 구매 전환 추적 | Conversion Rate | 3% |
+| P2 | 장바구니 이탈 분석 | Cart Abandonment | < 70% |
+
+### 3. Event Naming Convention
+
+#### Pattern
+```
+[domain]_[action]_[object]
+```
+
+#### Rules
+- 소문자, 언더스코어 사용
+- GA4 권장 이벤트 우선 사용
+- 커스텀 이벤트는 접두어로 구분: `custom_`
+
+#### Examples
+| Action | Event Name | Type |
+|--------|------------|------|
+| 상품 조회 | view_item | Recommended |
+| 장바구니 담기 | add_to_cart | Recommended |
+| 위시리스트 | add_to_wishlist | Recommended |
+| CTA 클릭 | custom_cta_click | Custom |
+| 탭 전환 | custom_tab_change | Custom |
+
+### 4. Parameter Design
+
+#### Standard Parameters (GA4 Recommended)
+| Parameter | Type | Required | Example |
+|-----------|------|----------|---------|
+| currency | string | Yes | "KRW" |
+| value | number | Yes | 29000 |
+| items | array | Yes | [...] |
+| transaction_id | string | purchase only | "T_12345" |
+
+#### Custom Parameters
+| Parameter | Type | Scope | Description |
+|-----------|------|-------|-------------|
+| user_type | string | event | new/returning |
+| page_type | string | event | home/product/cart |
+| login_method | string | event | kakao/naver/email |
+
+### 5. Custom Dimensions
+
+| Name | Scope | Values | GA4 Configuration |
+|------|-------|--------|-------------------|
+| User Type | User | new, returning | user_type |
+| Membership Level | User | bronze, silver, gold | membership_level |
+| Page Type | Event | home, category, product, cart, checkout | page_type |
+
+### 6. Custom Metrics
+
+| Name | Unit | Description | Event Source |
+|------|------|-------------|--------------|
+| Wishlist Adds | Count | 위시리스트 추가 수 | add_to_wishlist |
+| Form Starts | Count | 폼 시작 수 | form_start |
+
+### 7. Environment Configuration
+
+```javascript
+// 환경 변수 설정
+const GTM_CONFIG = {
+  development: {
+    gtmId: 'GTM-DEV123',
+    ga4Id: 'G-DEV456',
+    debugMode: true
+  },
+  staging: {
+    gtmId: 'GTM-STG123',
+    ga4Id: 'G-STG456',
+    debugMode: true
+  },
+  production: {
+    gtmId: 'GTM-PROD123',
+    ga4Id: 'G-PROD456',
+    debugMode: false
+  }
+};
+```
+
+### 8. Platform Mapping
+
+| Action | GA4 | Meta | Kakao | Google Ads |
+|--------|-----|------|-------|------------|
+| 상품 조회 | view_item | ViewContent | viewContent | - |
+| 장바구니 | add_to_cart | AddToCart | addToCart | - |
+| 구매 완료 | purchase | Purchase | purchase | purchase |
+
+→ 상세 매핑: [platform-mapping.md](platform-mapping.md)
+
+### 9. DataLayer Requirements
+
+→ 상세 스키마: [datalayer-schema.md](datalayer-schema.md)
+
+## Tagging Plan Template
+
+```markdown
+# [Project] Tagging Plan v1.0
+
+## 1. Overview
+### 1.1 Project Information
+### 1.2 Measurement Objectives
+### 1.3 Key Conversions
+
+## 2. Event Specification
+### 2.1 Recommended Events
+### 2.2 Custom Events
+### 2.3 Parameter Reference
+
+## 3. DataLayer Specification
+### 3.1 Page Load Data
+### 3.2 E-commerce Events
+### 3.3 Engagement Events
+
+## 4. Tag Configuration
+### 4.1 GA4 Tags
+### 4.2 Google Ads Tags
+### 4.3 Meta Pixel Tags
+### 4.4 Kakao Pixel Tags
+
+## 5. Implementation Notes
+### 5.1 Developer Requirements
+### 5.2 QA Checklist
+### 5.3 Timeline
+
+## Appendix
+- A. Naming Conventions
+- B. Platform Event Mapping
+- C. Change Log
+```
+
+## Quality Checklist
+
+- [ ] 모든 P1 이벤트 정의됨
+- [ ] 이벤트 명명 규칙 일관성
+- [ ] 필수 파라미터 정의 완료
+- [ ] Custom Dimensions scope 적절
+- [ ] 플랫폼별 매핑 완료
+- [ ] DataLayer 스키마와 정합성 확인
+
+## Next Phase
+
+Tagging Plan 완료 후 → Phase 4: Event Taxonomy Design
--- a/custom-skills/22-gtm-guardian/desktop/references/phase4-taxonomy.md
+++ b/custom-skills/22-gtm-guardian/desktop/references/phase4-taxonomy.md
@@ -0,0 +1,159 @@
+# Phase 4: Event Taxonomy Design
+
+이벤트 명명 규칙, 태그 이름, 트리거 조건, 파라미터, 맞춤 측정 기준/지표를 구글 시트로 체계화.
+
+## Objectives
+
+1. 이벤트 택소노미 시트 구조화
+2. 태그/트리거/변수 명명 일관성
+3. 파라미터 및 측정 기준 연계
+4. 팀 간 공유 가능한 문서화
+
+## Event Taxonomy Sheet Structure
+
+### Sheet 1: Events Master
+
+| Column | Description | Example |
+|--------|-------------|---------|
+| event_name | 이벤트 명 | purchase |
+| event_category | 이벤트 유형 | ecommerce |
+| trigger_type | 트리거 유형 | dataLayer |
+| trigger_condition | 트리거 조건 | event equals 'purchase' |
+| parameters | 필수 파라미터 | transaction_id, value, currency, items |
+| custom_dimensions | 연계 측정기준 | user_type, payment_method |
+| custom_metrics | 연계 지표 | - |
+| ga4_mapping | GA4 이벤트 | purchase (recommended) |
+| meta_mapping | Meta 이벤트 | Purchase |
+| kakao_mapping | Kakao 이벤트 | purchase |
+| priority | 우선순위 | P1 |
+| notes | 비고 | 결제 완료 페이지에서 발화 |
+
+### Sheet 2: Parameters Reference
+
+| Column | Description | Example |
+|--------|-------------|---------|
+| parameter_name | 파라미터 명 | transaction_id |
+| data_type | 데이터 타입 | string |
+| required | 필수 여부 | Yes |
+| scope | 범위 | event |
+| events | 사용 이벤트 | purchase, refund |
+| ga4_param | GA4 파라미터명 | transaction_id |
+| datalayer_path | DL 경로 | ecommerce.transaction_id |
+| validation | 검증 규칙 | not empty, unique |
+| example | 예시 | "T_20250115_001" |
+
+### Sheet 3: Custom Definitions
+
+| Column | Description | Example |
+|--------|-------------|---------|
+| name | 이름 | User Type |
+| type | 유형 | dimension / metric |
+| scope | 범위 | user / event |
+| parameter | 연계 파라미터 | user_type |
+| values | 가능한 값 | new, returning |
+| description | 설명 | 신규/재방문 사용자 구분 |
+| ga4_index | GA4 인덱스 | - (자동생성) |
+
+### Sheet 4: Tag Configuration
+
+| Column | Description | Example |
+|--------|-------------|---------|
+| tag_name | 태그 명 | GA4 - Event - purchase |
+| tag_type | 태그 유형 | GA4 Event |
+| platform | 플랫폼 | GA4 |
+| trigger | 트리거 명 | DL - purchase |
+| blocking_trigger | 차단 트리거 | Block - Internal |
+| variables | 사용 변수 | DLV - transaction_id, DLV - value |
+| folder | 폴더 | 02. GA4 Events |
+
+### Sheet 5: Trigger Configuration
+
+| Column | Description | Example |
+|--------|-------------|---------|
+| trigger_name | 트리거 명 | DL - purchase |
+| trigger_type | 트리거 유형 | Custom Event |
+| event_name | 이벤트 명 | purchase |
+| conditions | 조건 | - |
+| used_by | 사용 태그 | GA4 - Event - purchase |
+
+### Sheet 6: Variable Configuration
+
+| Column | Description | Example |
+|--------|-------------|---------|
+| variable_name | 변수 명 | DLV - transaction_id |
+| variable_type | 변수 유형 | Data Layer Variable |
+| datalayer_name | DL 변수명 | ecommerce.transaction_id |
+| default_value | 기본값 | undefined |
+| used_by | 사용 태그 | GA4 - Event - purchase |
+
+## Google Sheets Template
+
+### Quick Setup
+1. 새 Google Sheets 생성
+2. 시트 탭 6개 생성 (위 구조대로)
+3. 헤더 행 고정 (View > Freeze > 1 row)
+4. 조건부 서식 적용 (Priority별 색상)
+5. 데이터 유효성 검사 (Dropdown)
+
+### Dropdown Validations
+```
+event_category: ecommerce, engagement, lead_gen, content
+trigger_type: dataLayer, click, pageview, scroll, timer
+priority: P1, P2, P3
+data_type: string, number, boolean, array, object
+scope: event, user, session
+```
+
+### Conditional Formatting
+```
+P1: Red background
+P2: Yellow background
+P3: Green background
+```
+
+## Sample Event Taxonomy
+
+### E-commerce Events
+```csv
+event_name,event_category,trigger_type,trigger_condition,parameters,priority
+view_item_list,ecommerce,dataLayer,"event equals 'view_item_list'","item_list_id, item_list_name, items",P2
+view_item,ecommerce,dataLayer,"event equals 'view_item'","currency, value, items",P1
+add_to_cart,ecommerce,dataLayer,"event equals 'add_to_cart'","currency, value, items",P1
+begin_checkout,ecommerce,dataLayer,"event equals 'begin_checkout'","currency, value, items, coupon",P1
+purchase,ecommerce,dataLayer,"event equals 'purchase'","transaction_id, currency, value, items, shipping, tax",P1
+```
+
+### Lead Gen Events
+```csv
+event_name,event_category,trigger_type,trigger_condition,parameters,priority
+form_start,lead_gen,dataLayer,"event equals 'form_start'","form_id, form_name",P2
+form_submit,lead_gen,dataLayer,"event equals 'form_submit'","form_id, form_name, success",P1
+generate_lead,lead_gen,dataLayer,"event equals 'generate_lead'","currency, value, source",P1
+```
+
+## Naming Convention Reference
+
+→ [naming-conventions.md](naming-conventions.md)
+
+### Quick Reference
+| Type | Pattern | Example |
+|------|---------|---------|
+| Tag | [Platform] - [Type] - [Event] | GA4 - Event - purchase |
+| Trigger | [Type] - [Event/Condition] | DL - purchase |
+| Variable | [Type] - [Name] | DLV - transaction_id |
+
+## Output Delivery
+
+### Format Options
+1. **Google Sheets** (권장): 공유 및 협업 용이
+2. **Excel (.xlsx)**: 오프라인/보안 요구 시
+3. **CSV**: 개발팀 연동 시
+
+### Sharing
+- Viewer 권한: 마케팅팀, 경영진
+- Editor 권한: 분석팀, 개발팀
+- 버전 히스토리 활용
+
+## Next Phase
+
+Event Taxonomy 완료 후 → Phase 5: Implementation Guide
--- a/custom-skills/22-gtm-guardian/desktop/references/phase5-implementation.md
+++ b/custom-skills/22-gtm-guardian/desktop/references/phase5-implementation.md
@@ -0,0 +1,208 @@
+# Phase 5: Implementation Plan & Guide
+
+분석된 웹사이트/앱의 상태와 타입, 비즈니스 목표에 맞는 태그 설정 순서와 전략, 체크리스트 도출.
+
+## Objectives
+
+1. 구현 우선순위 및 순서 결정
+2. 개발팀용 DataLayer 가이드 작성
+3. GTM 컨테이너 설정 가이드
+4. QA 체크리스트 도출
+
+## Implementation Sequence
+
+### Standard Sequence
+```
+1. Base Setup (Week 1)
+   ├── GTM Container 설치
+   ├── GA4 Configuration Tag
+   └── 기본 page_view 확인
+
+2. DataLayer Implementation (Week 1-2)
+   ├── 페이지 데이터 (pageType, userId 등)
+   └── E-commerce / Lead Gen 이벤트
+
+3. Core Events (Week 2)
+   ├── P1 이벤트 태그 설정
+   ├── 트리거 구성
+   └── 변수 설정
+
+4. Platform Tags (Week 2-3)
+   ├── Google Ads Conversion
+   ├── Meta Pixel
+   └── Kakao Pixel
+
+5. QA & Launch (Week 3)
+   ├── Preview 모드 테스트
+   ├── 데이터 검증
+   └── Production 배포
+```
+
+### E-commerce Priority
+```
+P1: purchase → begin_checkout → add_to_cart → view_item
+P2: view_item_list → add_to_wishlist → search
+P3: select_item → scroll → video
+```
+
+### Lead Gen Priority
+```
+P1: generate_lead → form_submit
+P2: form_start → page_view (특정 페이지)
+P3: cta_click → scroll → video
+```
+
+## Developer Guide Template
+
+### DataLayer Implementation Guide
+
+```markdown
+# DataLayer 구현 가이드
+
+## 1. 기본 설정
+
+### GTM 스니펫 이전 dataLayer 초기화
+```html
+<script>
+window.dataLayer = window.dataLayer || [];
+</script>
+<!-- Google Tag Manager -->
+<script>...</script>
+```
+
+### 페이지 로드 시 기본 데이터
+```javascript
+dataLayer.push({
+  'event': 'page_data',
+  'page': {
+    'type': '[page_type]',  // home, category, product, cart, checkout, thankyou
+    'name': '[page_name]',
+    'language': 'ko'
+  },
+  'user': {
+    'status': '[logged_in|logged_out]',
+    'id': '[hashed_user_id]',  // SHA256 해시, 로그인 시에만
+    'type': '[new|returning]'
+  }
+});
+```
+
+## 2. 이벤트별 구현
+
+### [이벤트명]
+**발화 시점**: [설명]
+**필수 파라미터**: [목록]
+
+```javascript
+dataLayer.push({ ecommerce: null });  // E-commerce 이벤트 시 필수
+dataLayer.push({
+  'event': '[event_name]',
+  // 파라미터...
+});
+```
+
+## 3. 테스트 방법
+1. Chrome DevTools Console에서 dataLayer 확인
+2. GTM Preview 모드에서 이벤트 확인
+3. GA4 DebugView에서 수신 확인
+```
+
+## GTM Configuration Guide
+
+### Container Setup Checklist
+
+- [ ] Container ID 확인
+- [ ] Web Container 타입 선택
+- [ ] 환경(Dev/Stg/Prod) 설정
+
+### Built-in Variables 활성화
+
+```
+✅ Page URL, Page Path, Page Hostname, Referrer
+✅ Click Element, Click Classes, Click ID, Click URL, Click Text
+✅ Form Element, Form Classes, Form ID, Form URL, Form Text
+✅ Scroll Depth Threshold, Scroll Depth Units, Scroll Direction
+✅ Video Provider, Video Status, Video URL, Video Title, Video Duration, Video Percent
+```
+
+### Folder Structure
+
+```
+📁 01. Configuration
+📁 02. GA4 Events
+📁 03. Google Ads
+📁 04. Meta Pixel
+📁 05. Kakao Pixel
+📁 06. Utilities
+📁 99. Deprecated
+```
+
+### Tag Setup Order
+
+```
+1. Constants (Measurement IDs, Pixel IDs)
+2. DataLayer Variables
+3. Custom JavaScript Variables
+4. Triggers (Event-based)
+5. Blocking Triggers (Internal traffic)
+6. Configuration Tags
+7. Event Tags
+```
+
+## QA Checklist
+
+→ 상세 체크리스트: [qa-checklist.md](qa-checklist.md)
+
+### Pre-Launch Quick Check
+
+#### DataLayer
+- [ ] dataLayer가 GTM 스니펫 이전에 초기화됨
+- [ ] 페이지 로드 시 기본 데이터 push됨
+- [ ] 숫자 값이 Number 타입으로 전송됨
+- [ ] ecommerce 이벤트 전 null push됨
+
+#### Tags
+- [ ] 모든 P1 이벤트 태그 설정됨
+- [ ] 트리거 조건 정확함
+- [ ] 변수 값 정확히 매핑됨
+
+#### Testing
+- [ ] Preview 모드에서 모든 태그 발화 확인
+- [ ] GA4 DebugView에서 데이터 수신 확인
+- [ ] Network 탭에서 요청 확인
+
+#### Cross-check
+- [ ] 데스크톱 Chrome 테스트
+- [ ] 모바일 Safari 테스트
+- [ ] Internal traffic 필터 작동
+
+## Common Implementation Issues
+
+| Issue | Solution |
+|-------|----------|
+| dataLayer not defined | GTM 스니펫 이전에 초기화 |
+| 숫자가 문자열로 전송 | 따옴표 제거, parseInt/parseFloat |
+| 이벤트 중복 발화 | 트리거 조건 검토, 페이지 상태 확인 |
+| 태그 미발화 | Preview에서 트리거 조건 디버깅 |
+| 데이터 불일치 | DL 변수 경로 확인, 대소문자 확인 |
+
+## Handoff Checklist
+
+### To Development Team
+- [ ] DataLayer 구현 가이드 전달
+- [ ] 이벤트 택소노미 시트 공유
+- [ ] Q&A 세션 완료
+
+### To Marketing Team
+- [ ] 측정 가능한 이벤트 목록 공유
+- [ ] GA4 보고서 접근 권한 확인
+- [ ] 전환 설정 완료 확인
+
+### Documentation
+- [ ] Tagging Plan 최종 버전 저장
+- [ ] GTM 컨테이너 버전 기록
+- [ ] Notion에 모든 문서 업로드
+
+## Next Phase
+
+구현 완료 후 → Phase 6: Progressive Audit
--- a/custom-skills/22-gtm-guardian/desktop/references/platform-mapping.md
+++ b/custom-skills/22-gtm-guardian/desktop/references/platform-mapping.md
@@ -0,0 +1,125 @@
+# Platform Event Mapping Reference
+
+GA4, Google Ads, Meta Pixel, Kakao Pixel 간 이벤트 매핑.
+
+## E-commerce Events
+
+| User Action | GA4 | Meta | Kakao | Google Ads |
+|-------------|-----|------|-------|------------|
+| 상품 목록 조회 | view_item_list | ViewContent | viewContent | - |
+| 상품 상세 조회 | view_item | ViewContent | viewContent | - |
+| 상품 검색 | search | Search | search | - |
+| 장바구니 담기 | add_to_cart | AddToCart | addToCart | - |
+| 위시리스트 | add_to_wishlist | AddToWishlist | addToWishlist | - |
+| 결제 시작 | begin_checkout | InitiateCheckout | beginCheckout | - |
+| 배송정보 입력 | add_shipping_info | - | - | - |
+| 결제정보 입력 | add_payment_info | AddPaymentInfo | addPaymentInfo | - |
+| 구매 완료 | purchase | Purchase | purchase | purchase |
+
+## Lead Gen Events
+
+| User Action | GA4 | Meta | Kakao | Google Ads |
+|-------------|-----|------|-------|------------|
+| 회원가입 | sign_up | CompleteRegistration | completeRegistration | sign_up |
+| 로그인 | login | - | login | - |
+| 리드 생성 | generate_lead | Lead | participation | submit_lead_form |
+
+## Engagement Events
+
+| User Action | GA4 | Meta | Kakao | Google Ads |
+|-------------|-----|------|-------|------------|
+| 페이지 조회 | page_view | PageView | pageView | page_view |
+| 검색 | search | Search | search | - |
+| 공유 | share | - | - | - |
+
+## Parameter Transformation
+
+### GA4 → Meta
+```javascript
+// GA4 items[] → Meta content_ids[]
+const contentIds = items.map(item => item.item_id);
+
+// Meta Purchase
+fbq('track', 'Purchase', {
+  content_ids: contentIds,
+  content_type: 'product',
+  value: ecommerce.value,
+  currency: 'KRW',
+  num_items: items.length
+});
+```
+
+### GA4 → Kakao
+```javascript
+// GA4 items[] → Kakao products[]
+const products = items.map(item => ({
+  id: item.item_id,
+  name: item.item_name,
+  price: item.price,
+  quantity: item.quantity
+}));
+
+// Kakao purchase
+kakaoPixel('PIXEL_ID').purchase({
+  total_price: ecommerce.value,
+  currency: 'KRW',
+  products: products
+});
+```
+
+## GTM Variables
+
+### CJS - Item IDs for Meta
+```javascript
+function() {
+  var items = {{DLV - ecommerce.items}} || [];
+  return items.map(function(item) {
+    return item.item_id;
+  });
+}
+```
+
+### CJS - Products for Kakao
+```javascript
+function() {
+  var items = {{DLV - ecommerce.items}} || [];
+  return items.map(function(item) {
+    return {
+      id: item.item_id,
+      name: item.item_name,
+      price: item.price,
+      quantity: item.quantity
+    };
+  });
+}
+```
+
+## Deduplication
+
+### Event ID Pattern
+```javascript
+var eventId = 'evt_' + Date.now() + '_' + Math.random().toString(36).substr(2, 9);
+
+// Client-side
+fbq('track', 'Purchase', {...}, {eventID: eventId});
+
+// Server-side (CAPI)
+// 동일한 eventId 사용 → Meta 자동 중복 제거
+```
+
+## Platform-specific Notes
+
+### Meta Pixel
+- content_type: 'product' (상품) / 'product_group' (변형)
+- currency: ISO 4217 필수
+- value: 숫자 (소수점 가능)
+
+### Kakao Pixel
+- Server-side 미지원 (Client-only)
+- products[]: 최대 10개 권장
+- total_price: 숫자
+
+### Google Ads
+- Enhanced Conversions 권장
+- transaction_id 필수 (중복 제거용)
+- value: KRW 정수
--- a/custom-skills/22-gtm-guardian/desktop/references/qa-checklist.md
+++ b/custom-skills/22-gtm-guardian/desktop/references/qa-checklist.md
@@ -0,0 +1,149 @@
+# GTM Implementation QA Checklist
+
+태깅 구현 품질 검증 체크리스트.
+
+## 1. Pre-Implementation
+
+### Documentation
+- [ ] Tagging Plan 승인 완료
+- [ ] DataLayer 스키마 개발팀 공유
+- [ ] 이벤트 택소노미 합의 완료
+
+### Access
+- [ ] GTM 컨테이너 접근 권한
+- [ ] GA4 속성 접근 권한
+- [ ] 광고 플랫폼 접근 권한
+
+### Tools
+- [ ] GTM Preview 모드 정상
+- [ ] GA4 DebugView 활성화
+- [ ] Chrome DevTools 준비
+
+## 2. DataLayer Validation
+
+### Base Setup
+- [ ] GTM 스니펫 이전 dataLayer 초기화
+- [ ] 페이지 로드 시 기본 데이터 push
+- [ ] pageType, userId 등 기본 변수 존재
+
+### Data Types
+- [ ] 숫자 값이 Number 타입
+- [ ] 금액에 통화 코드 포함 (KRW)
+- [ ] transaction_id 유니크
+
+### E-commerce
+- [ ] ecommerce: null 선행 push
+- [ ] items[] 배열 구조 정확
+- [ ] 필수 파라미터 완비
+
+### Console Check
+```javascript
+console.log(window.dataLayer);
+dataLayer.filter(e => e.event === 'purchase');
+```
+
+## 3. Tag Firing
+
+### GA4
+| Tag | Trigger | Status |
+|-----|---------|--------|
+| Config | All Pages | [ ] |
+| view_item | Product page | [ ] |
+| add_to_cart | Add button | [ ] |
+| begin_checkout | Checkout start | [ ] |
+| purchase | Thank you | [ ] |
+
+### Google Ads
+| Conversion | Trigger | Status |
+|------------|---------|--------|
+| Purchase | DL - purchase | [ ] |
+| Lead | DL - generate_lead | [ ] |
+
+### Meta Pixel
+| Event | Trigger | Status |
+|-------|---------|--------|
+| PageView | All Pages | [ ] |
+| ViewContent | Product | [ ] |
+| AddToCart | Add | [ ] |
+| Purchase | Thank you | [ ] |
+
+### Kakao Pixel
+| Event | Trigger | Status |
+|-------|---------|--------|
+| pageView | All Pages | [ ] |
+| purchase | Thank you | [ ] |
+
+## 4. Network Validation
+
+### Endpoints
+```
+GA4: google-analytics.com/g/collect
+GAds: googleads.g.doubleclick.net/pagead/conversion/
+Meta: facebook.com/tr/
+```
+
+### Check Points
+- [ ] 요청 전송됨
+- [ ] 파라미터 정확
+- [ ] 응답 성공 (200/204)
+
+## 5. Cross-browser Testing
+
+### Desktop
+- [ ] Chrome
+- [ ] Safari
+- [ ] Firefox
+- [ ] Edge
+
+### Mobile
+- [ ] iOS Safari
+- [ ] iOS Chrome
+- [ ] Android Chrome
+
+## 6. Data Validation (Platform)
+
+### GA4
+- [ ] Realtime 보고서 이벤트 표시
+- [ ] 파라미터 정확히 수집
+- [ ] E-commerce 보고서 정확
+
+### Google Ads
+- [ ] 전환 액션 데이터 유입
+- [ ] 전환 값 정확
+
+### Meta
+- [ ] Events Manager 수신 확인
+- [ ] Event match quality 확인
+
+## 7. Edge Cases
+
+- [ ] 빈 장바구니 결제 시작 처리
+- [ ] 0개 구매 처리
+- [ ] 쿠폰 없는 구매
+- [ ] 게스트 체크아웃
+- [ ] 새로고침 시 중복 방지
+- [ ] 뒤로가기 시 처리
+
+## 8. Performance & Privacy
+
+### Performance
+- [ ] 태그 로딩이 렌더링 차단 안 함
+- [ ] 비동기 로딩
+
+### Privacy
+- [ ] 동의 없이 태그 미발화 (CMP 시)
+- [ ] PII 직접 수집 없음
+
+## Sign-off
+
+| Role | Name | Date | ✓ |
+|------|------|------|---|
+| QA Lead | | | |
+| Analytics Lead | | | |
+| Dev Lead | | | |
+
+## Issues Log
+
+| # | Issue | Severity | Status |
+|---|-------|----------|--------|
+| 1 | | High/Med/Low | Open/Resolved |
--- a/custom-skills/22-gtm-guardian/desktop/references/sgtm-guide.md
+++ b/custom-skills/22-gtm-guardian/desktop/references/sgtm-guide.md
@@ -0,0 +1,113 @@
+# Server-side GTM Guide
+
+sGTM 아키텍처 옵션 및 설정 가이드.
+
+## Why Server-side GTM?
+
+| Benefit | Description |
+|---------|-------------|
+| Data Control | 클라이언트 → 서버 → 벤더 흐름 제어 |
+| Privacy | PII 필터링, 서버에서 처리 |
+| Cookie Duration | 1st-party cookie (최대 2년) |
+| Performance | 클라이언트 JS 감소 |
+| Reliability | Ad blocker 영향 최소화 |
+
+## Architecture Options
+
+### Option 1: GCP Cloud Run
+```
+Browser → Your Domain (1st-party) → GCP Cloud Run → GA4/Ads/Meta
+```
+- **Pros**: 완전한 제어, GCP 통합
+- **Cons**: GCP 전문 지식 필요
+- **Cost**: Low ~$20, Medium ~$100, High $200+/월
+
+### Option 2: Stape.io (Managed)
+```
+Browser → Stape CDN → Stape Server → GA4/Ads/Meta
+```
+- **Pros**: 간편 설정 (10분), 관리형, 한국 리전
+- **Cons**: 월정액, 벤더 종속
+- **Cost**: Starter $20, Business $50, Scale $150/월
+
+### Option 3: Google Tag Gateway
+```
+Browser → Google Gateway → Google Cloud (Managed) → GA4/Ads
+```
+- **Pros**: Google 관리형, 무료(제한적)
+- **Cons**: Google 태그만 지원, 제한된 커스터마이징
+
+## Selection Guide
+
+| Requirement | Recommendation |
+|-------------|----------------|
+| Google 태그만 | Tag Gateway |
+| 빠른 구현 | Stape.io |
+| 완전한 제어 | GCP Cloud Run |
+| Third-party 태그 (Meta 등) | Stape 또는 GCP |
+
+## Client Configuration
+
+### Web Container 설정
+```javascript
+gtag('config', 'G-XXXXXXXXXX', {
+  'server_container_url': 'https://gtm.yourdomain.com'
+});
+```
+
+### GTM GA4 Configuration Tag
+```
+Advanced Settings:
+  Server container URL: https://gtm.yourdomain.com
+```
+
+## Stape Quick Setup
+
+1. **계정 생성**: stape.io
+2. **Container 생성**: Region = Seoul (asia-northeast3)
+3. **Custom Domain 연결**
+   ```
+   DNS: gtm.example.com CNAME [stape-provided-address]
+   ```
+4. **GTM Server Container ID 연결**
+5. **Web Container 수정**: server_container_url 추가
+
+## Server Tags
+
+### GA4 Tag
+```
+Measurement ID: G-XXXXXXXXXX
+Event Name: {{Event Name}}
+Event Parameters: {{Event Data}}
+```
+
+### Google Ads Conversion
+```
+Conversion ID: AW-XXXXXXXXX
+Conversion Label: [Label]
+Enhanced Conversions: Enabled
+```
+
+### Meta Conversions API
+```
+Pixel ID: [ID]
+API Access Token: [Token]
+Event Name: {{Event Name}}
+```
+
+## Testing
+
+1. **Preview Mode**: GTM Server Container → Preview
+2. **Validation**:
+   - Client → Server 요청 도달
+   - Server → Platform 전송 확인
+   - Cookie 설정 확인 (1st-party)
+   - Latency < 200ms
+
+## Common Issues
+
+| Issue | Solution |
+|-------|----------|
+| 요청 미도달 | CORS, Custom domain 확인 |
+| Cookie 미설정 | Same-site 정책, 도메인 확인 |
+| Timeout | 리전 최적화, 스케일링 |
--- a/custom-skills/22-gtm-guardian/desktop/templates/event-taxonomy-template.csv
+++ b/custom-skills/22-gtm-guardian/desktop/templates/event-taxonomy-template.csv
@@ -0,0 +1,25 @@
+event_name,event_category,trigger_type,trigger_condition,parameters,custom_dimensions,custom_metrics,ga4_mapping,meta_mapping,kakao_mapping,gads_mapping,priority,notes
+page_view,engagement,pageview,All Pages,-,-,-,page_view (auto),PageView,pageView,-,P1,자동 수집
+view_item,ecommerce,dataLayer,event equals 'view_item',"items[], value, currency",page_type,-,view_item,ViewContent,viewContent,-,P1,상품 상세 조회
+view_item_list,ecommerce,dataLayer,event equals 'view_item_list',"item_list_id, item_list_name, items[]",-,-,view_item_list,ViewContent,viewContent,-,P2,상품 목록 조회
+select_item,ecommerce,dataLayer,event equals 'select_item',"item_list_id, items[]",-,-,select_item,-,-,-,P3,목록에서 상품 선택
+add_to_cart,ecommerce,dataLayer,event equals 'add_to_cart',"items[], value, currency",-,-,add_to_cart,AddToCart,addToCart,-,P1,장바구니 담기
+remove_from_cart,ecommerce,dataLayer,event equals 'remove_from_cart',"items[], value, currency",-,-,remove_from_cart,-,-,-,P2,장바구니 삭제
+view_cart,ecommerce,dataLayer,event equals 'view_cart',"items[], value, currency",-,-,view_cart,-,-,-,P2,장바구니 조회
+add_to_wishlist,ecommerce,dataLayer,event equals 'add_to_wishlist',"items[], value, currency",-,wishlist_adds,add_to_wishlist,AddToWishlist,addToWishlist,-,P3,위시리스트 추가
+begin_checkout,ecommerce,dataLayer,event equals 'begin_checkout',"items[], value, currency, coupon",-,-,begin_checkout,InitiateCheckout,beginCheckout,-,P1,결제 시작
+add_shipping_info,ecommerce,dataLayer,event equals 'add_shipping_info',"items[], value, currency, shipping_tier",-,-,add_shipping_info,-,-,-,P2,배송정보 입력
+add_payment_info,ecommerce,dataLayer,event equals 'add_payment_info',"items[], value, currency, payment_type",-,-,add_payment_info,AddPaymentInfo,addPaymentInfo,-,P2,결제정보 입력
+purchase,ecommerce,dataLayer,event equals 'purchase',"transaction_id, items[], value, currency, tax, shipping, coupon",payment_method,-,purchase,Purchase,purchase,purchase,P1,구매 완료
+refund,ecommerce,dataLayer,event equals 'refund',"transaction_id, items[], value, currency",-,-,refund,-,-,-,P2,환불
+login,engagement,dataLayer,event equals 'login',method,-,-,login,-,login,-,P2,로그인
+sign_up,engagement,dataLayer,event equals 'sign_up',method,-,-,sign_up,CompleteRegistration,completeRegistration,sign_up,P2,회원가입
+search,engagement,dataLayer,event equals 'search',"search_term, results_count",-,-,search,Search,search,-,P2,검색
+generate_lead,lead_gen,dataLayer,event equals 'generate_lead',"value, currency, lead_source",-,-,generate_lead,Lead,participation,submit_lead_form,P1,리드 생성
+form_start,lead_gen,dataLayer,event equals 'form_start',"form_id, form_name",-,form_starts,custom,-,-,-,P2,폼 시작
+form_submit,lead_gen,dataLayer,event equals 'form_submit',"form_id, form_name, success",-,-,custom,Lead,participation,-,P1,폼 제출
+share,engagement,dataLayer,event equals 'share',"method, content_type, item_id",-,-,share,-,-,-,P3,공유
+cta_click,engagement,click,Click matches CTA selector,"cta_id, cta_text, cta_location",-,-,custom,-,-,-,P3,CTA 클릭
+video_start,engagement,dataLayer,event equals 'video_start',"video_title, video_id, video_duration",-,-,custom,-,-,-,P3,비디오 시작
+video_complete,engagement,dataLayer,event equals 'video_complete',"video_title, video_id",-,-,custom,-,-,-,P3,비디오 완료
+scroll_depth,engagement,scroll,Scroll 90%,percent,-,-,scroll (auto),-,-,-,P3,스크롤 깊이
--- a/custom-skills/22-gtm-guardian/desktop/templates/tagging-plan-template.md
+++ b/custom-skills/22-gtm-guardian/desktop/templates/tagging-plan-template.md
@@ -0,0 +1,147 @@
+# [Project Name] Tagging Plan v1.0
+
+## Document Information
+
+| Field | Value |
+|-------|-------|
+| Project | [프로젝트명] |
+| Client | [클라이언트명] |
+| Website/App | [URL] |
+| Version | 1.0 |
+| Last Updated | YYYY-MM-DD |
+| Author | [작성자] |
+| Status | Draft / Review / Approved |
+
+---
+
+## 1. Executive Summary
+
+### 1.1 Measurement Objectives
+| Priority | Objective | KPI | Target |
+|----------|-----------|-----|--------|
+| P1 | | | |
+| P2 | | | |
+| P3 | | | |
+
+### 1.2 Key Conversions
+| Conversion | Type | Value | Platform |
+|------------|------|-------|----------|
+| | Hard/Soft | | GA4, GAds, Meta |
+
+---
+
+## 2. Event Specification
+
+### 2.1 GA4 Recommended Events
+| Event | Trigger | Required Params | Status |
+|-------|---------|-----------------|--------|
+| page_view | All pages | - | ✅ |
+| view_item | Product page | items[], value, currency | |
+| add_to_cart | Add button | items[], value, currency | |
+| begin_checkout | Checkout start | items[], value, currency | |
+| purchase | Thank you | transaction_id, items[], value, currency | |
+
+### 2.2 Custom Events
+| Event | Purpose | Trigger | Parameters |
+|-------|---------|---------|------------|
+| | | | |
+
+---
+
+## 3. DataLayer Specification
+
+### 3.1 Page Load Data
+```javascript
+dataLayer.push({
+  'event': 'page_data',
+  'page': {
+    'type': '[page_type]',
+    'name': '[page_name]'
+  },
+  'user': {
+    'status': '[logged_in|logged_out]',
+    'id': '[hashed_user_id]'
+  }
+});
+```
+
+### 3.2 E-commerce Events
+→ See datalayer-schema.md
+
+---
+
+## 4. Tag Configuration
+
+### 4.1 GA4 Tags
+| Tag Name | Trigger | Variables |
+|----------|---------|-----------|
+| GA4 - Config - Main | All Pages | Const - GA4 ID |
+| GA4 - Event - [event] | DL - [event] | DLV - ecommerce.* |
+
+### 4.2 Google Ads Tags
+| Tag Name | Conversion ID | Label | Trigger |
+|----------|---------------|-------|---------|
+| | | | |
+
+### 4.3 Meta Pixel Tags
+| Tag Name | Event | Trigger |
+|----------|-------|---------|
+| Meta - PageView | PageView | All Pages |
+| | | |
+
+### 4.4 Kakao Pixel Tags
+| Tag Name | Event | Trigger |
+|----------|-------|---------|
+| | | |
+
+---
+
+## 5. Custom Dimensions & Metrics
+
+### Custom Dimensions
+| Name | Scope | Parameter | Values |
+|------|-------|-----------|--------|
+| | User/Event | | |
+
+### Custom Metrics
+| Name | Unit | Event Source |
+|------|------|--------------|
+| | Count/Currency | |
+
+---
+
+## 6. Platform Mapping
+
+| GA4 Event | Meta | Kakao | Google Ads |
+|-----------|------|-------|------------|
+| view_item | ViewContent | viewContent | - |
+| add_to_cart | AddToCart | addToCart | - |
+| purchase | Purchase | purchase | purchase |
+
+---
+
+## 7. Implementation Timeline
+
+| Phase | Task | Owner | Due | Status |
+|-------|------|-------|-----|--------|
+| 1 | DataLayer 구현 | Dev | | ☐ |
+| 2 | GTM 태그 설정 | Analytics | | ☐ |
+| 3 | QA 테스트 | QA | | ☐ |
+| 4 | 프로덕션 배포 | Dev | | ☐ |
+
+---
+
+## 8. QA Checklist
+→ See qa-checklist.md
+
+---
+
+## Appendix
+
+### A. Naming Conventions
+→ See naming-conventions.md
+
+### B. Change Log
+| Version | Date | Author | Changes |
+|---------|------|--------|---------|
+| 1.0 | | | Initial version |