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>
This commit is contained in:
2025-12-31 19:59:22 +09:00
parent c6ab33726f
commit b859d0a266
22 changed files with 3214 additions and 0 deletions

View File

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