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>
4.8 KiB
4.8 KiB
name, description
| name | description |
|---|---|
| gtm-guardian | 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 |
| "행동 분석", "KPI", "전환 정의" | 2 | phase2-behaviour.md |
| "태깅 계획", "Tagging Plan" | 3 | phase3-tagging-plan.md |
| "이벤트 택소노미", "명명 규칙" | 4 | phase4-taxonomy.md |
| "구현 가이드", "체크리스트" | 5 | phase5-implementation.md |
| "진단", "감사", "업데이트" | 6 | → Claude Code 권장 |
| "조회 앱", "Lookup" | 7 | → Claude Code 권장 |
Core References
DataLayer & Events
- datalayer-schema.md - GA4 권장 이벤트 기반 DataLayer 스키마
- platform-mapping.md - GA4, Meta, Kakao, Google Ads 이벤트 매핑
- naming-conventions.md - 태그/트리거/변수 네이밍 규칙
Server-side GTM
- sgtm-guide.md - sGTM 아키텍처 및 Stape 설정
Implementation
- qa-checklist.md - 구현 QA 체크리스트
Templates
- tagging-plan-template.md - 태깅 계획서 템플릿
- event-taxonomy-template.csv - 이벤트 택소노미 시트 템플릿
Notion Integration
산출물 저장 대상: GTM Knowledge Base
저장 워크플로우 (MCP)
notion/API-post-search로 대상 페이지/DB 탐색- Phase별 템플릿 적용하여 콘텐츠 구성
notion/API-post-page로 페이지 생성- 상위 페이지에 링크 추가
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
- Phase 순서 준수: 선행 Phase 완료 후 다음 단계
- 문서화 우선: 모든 결정사항 Notion에 기록
- 점진적 구현: 핵심 이벤트 → 확장 이벤트
- 검증 필수: 구현 후 QA 체크리스트 수행
- 버전 관리: 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 검증 |