our-claude-skills/custom-skills/22-gtm-guardian/code/CLAUDE.md

GTM Guardian (Code)

GTM 태깅 라이프사이클의 자동화 및 유지보수 단계를 지원하는 Claude Code 스킬.

Code 범위: Phase 6-7 (Progressive Audit, Lookup App), GTM Toolkit 연계

Desktop 스킬에서 Phase 1-5 (분석, 설계, 문서화)를 수행한 후 사용.

Quick Commands

# D.intelligence GTM Toolkit 클론
git clone https://github.com/ourdigital/dintel-gtm-agent.git

# GTM Container 분석
python analyze_container.py GTM-XXXXXX.json --output report.md

# 버전 비교
python diff_versions.py v1.json v2.json --output diff.md

# 미사용 요소 탐지
python find_unused.py container.json --type all

Workflow Overview

Phase	Name	Output	Tools
6	Progressive Audit	진단 리포트, 업데이트	D.intel GTM Toolkit, Python
7	Lookup App	이벤트 조회 앱	Google Apps Script

Phase 6: Progressive Audit

D.intelligence GTM Toolkit Integration

Repository: https://github.com/ourdigital/dintel-gtm-agent

Capabilities

Feature	Description	Use Case
Container Analysis	JSON 파싱, 구조 분석	컨테이너 리뷰
Dependency Mapping	태그↔트리거↔변수 관계	영향도 분석
Version Diff	버전 간 변경사항 비교	변경 추적
Tag Validation	발화 상태 자동 검증	정기 감사

Audit Workflow

1. GTM Container Export
   └── JSON 파일 다운로드 (GTM Admin > Container > Export)

2. D.intel Toolkit Analysis
   ├── python analyze_container.py container.json
   ├── Dependency graph 생성
   └── Issue detection

3. Report Generation
   └── Markdown/HTML 리포트

4. Notion 업로드
   └── MCP 또는 수동 업로드

Audit Schedule

Frequency	Scope	Trigger
Weekly	Tag firing validation	자동 스케줄
Monthly	Full container review	월간 리포트
Quarterly	Architecture review	분기 회의
Ad-hoc	Issue investigation	이슈 발생 시

Phase 7: Lookup App

Google Apps Script 기반 Event Taxonomy 조회 앱 배포.

Architecture

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Google Sheets  │────▶│  Apps Script    │────▶│   Web App       │
│  (Taxonomy DB)  │     │  (Backend)      │     │  (Frontend)     │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Quick Setup

1. Google Sheets에서 Extensions > Apps Script
2. references/phase7-lookup-app.md 코드 참조
3. Deploy > New deployment > Web app

Key References

• phase6-audit.md - 진단 워크플로우, 체크리스트
• phase7-lookup-app.md - Apps Script 코드, 배포 가이드

Shared References

• datalayer-schema.md - DataLayer 스키마
• platform-mapping.md - 플랫폼별 이벤트 매핑
• naming-conventions.md - 네이밍 규칙
• qa-checklist.md - QA 체크리스트

Notion Output

Database: GTM Knowledge Base

Report Properties

Property	Type	Description
Project	Title	프로젝트명
Audit Date	Date	감사 일자
Container ID	Rich Text	GTM-XXXXXX
Status	Select	Healthy / Needs Attention / Critical
Version	Number	컨테이너 버전
Issues Count	Number	발견 이슈 수

Language Guidelines

• 리포트 내용은 한국어로 작성
• 기술 용어는 영어 유지 (GTM, dataLayer, GA4 등)
• 코드와 URL은 변경 없이 유지

Common Tasks

Container 분석 실행

cd dintel-gtm-agent
python analyze_container.py /path/to/GTM-XXXXXX.json \
  --output /path/to/report.md \
  --format markdown

버전 비교

python diff_versions.py \
  /path/to/container_v1.json \
  /path/to/container_v2.json \
  --output diff_report.md

미사용 요소 탐지

python find_unused.py /path/to/container.json \
  --type all \
  --output unused_elements.md

Update Procedures

Minor Update (태그 수정)

1. 변경 필요 태그 식별
2. GTM Preview 모드에서 수정
3. 테스트 완료
4. Publish with version note
5. Notion 문서 업데이트

Major Update (신규 태그 추가)

1. Desktop 스킬로 Phase 3-4 문서 업데이트
2. DataLayer 요구사항 개발팀 전달
3. GTM 태그/트리거/변수 설정
4. QA 체크리스트 수행
5. 단계적 배포

Coding Guidelines

GTM Toolkit 수정 시:

1. Tag Destinations: TAG_DESTINATIONS dict에 플랫폼 추가
2. Event Validation: GA4_EVENT_REQUIREMENTS dict에 요구사항 추가
3. Korean Patterns: 한국 결제 수단 (카카오페이, 네이버페이, 토스) 지원