Andrew Yim
b859d0a266
- 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>
122 lines
4.8 KiB
Markdown
122 lines
4.8 KiB
Markdown
---
|
|
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 검증 |
|