---
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 검증 |
