b6a478e1df
## Summary - Add portable installation tool (`install.sh`) for cross-machine setup - Add Claude.ai export files with proper YAML frontmatter - Add multi-agent-guide v2.0 with consolidated framework template - Rename `00-claude-code-setting` → `00-our-settings-audit` (avoid reserved word) - Add YAML frontmatter to 25+ SKILL.md files for Claude Desktop compatibility ## Commits Included - `93f604a` feat: Add portable installation tool for cross-machine setup - `9b84104` feat: Add Claude.ai export for portable skill installation - `f7ab973` fix: Add YAML frontmatter to Claude.ai export files - `3fed49a` feat(multi-agent-guide): Add v2.0 with consolidated framework - `3be26ef` refactor: Rename settings-audit skill and add YAML frontmatter Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
114 lines
4.4 KiB
Markdown
114 lines
4.4 KiB
Markdown
---
|
|
name: gtm-guardian
|
|
description: |
|
|
GTM tagging lifecycle manager: analysis, planning, taxonomy, implementation guide.
|
|
Triggers: GTM strategy, tagging plan, event taxonomy, implementation guide.
|
|
---
|
|
|
|
# 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 검증 |
|