our-claude-skills/custom-skills/62-gtm-validator/code/references/phase6-audit.md

Phase 6: Progressive Audit & Update

설정된 GTM Container에 대한 주기적 진단, 유효성 검증, 마이너 업데이트 및 태그 추가.

Objectives

1. GTM 컨테이너 건강 상태 점검
2. 태그 발화 및 데이터 정합성 검증
3. 최신 요구사항 반영 업데이트
4. DTM Agent 연계 자동화

Audit Schedule

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

Audit Checklist

1. Container Health Check

• 버전 히스토리 확인 (최근 변경사항)
• 미사용 태그/트리거/변수 식별
• 명명 규칙 준수 여부
• 폴더 구조 정리 상태

2. Tag Firing Validation

• 모든 P1 태그 정상 발화
• 트리거 조건 정확성
• 변수 값 정확성
• 차단 트리거 작동

3. Data Quality

• GA4 Realtime 데이터 확인
• 전환 데이터 정합성
• 파라미터 값 검증
• 이상치 탐지

4. Platform Sync

• GA4 ↔ GTM 동기화
• Google Ads 전환 데이터
• Meta Events Manager 상태
• Kakao Pixel 상태

DTM Agent Integration

The legacy dintel-gtm-toolkit (Python scripts operating on exported container JSON) is deprecated. All container operations now go through the DTM Agent — a set of Claude Code skills backed by the dtm CLI and the Google Tag Manager API, operating on live containers instead of exported JSON.

DTM Agent Skills

Capability	Skill	Replaces
Tag CRUD	dtm-tags	analyze_container.py (tags section)
Trigger CRUD	dtm-triggers	analyze_container.py (triggers section)
Variable CRUD	dtm-variables	analyze_container.py (variables section)
Dependency graph & unused detection	dtm-lookup	find_unused.py
Version management & diff	dtm-version	diff_versions.py
Container diagnostics (A–D grading)	dtm-debug	Container health check
Page audit (tracking coverage)	dtm-audit	Tag firing gap analysis
Live tag-firing QA	gtm-validator (this skill)	validate_tags.py
Event taxonomy classification	dtm-taxonomy	Naming-convention review
Schema.org JSON-LD	dtm-schema	n/a (new capability)
Active account/container switch	dtm-set	n/a
Status check	dtm-status	n/a

Integration Workflow

1. Active container selection
   └── /dtm-set  (or dtm set account/container)

2. Live container analysis
   ├── /dtm-tags, /dtm-triggers, /dtm-variables  (list / inspect)
   ├── /dtm-lookup  (dependency graph, unused resources)
   └── /dtm-debug   (configuration + performance grading)

3. Page-level audit
   └── /dtm-audit   (Chrome DevTools MCP — fired tags vs. configured)

4. Validation (this skill)
   └── /gtm-validator  (live page QA, trigger conditions, naming, cross-platform)

5. Versioning & rollout
   └── /dtm-version  (create version, compare, publish)

6. Report distribution
   └── Notion via notion-writer skill (see CLAUDE.md routing rules)

Sample DTM Agent Commands

# Container status & active context
dtm status
dtm list accounts
dtm list containers

# Tags / triggers / variables
dtm list tags
dtm get tag <TAG_ID>
dtm list triggers
dtm list variables

# Version management
dtm list versions
dtm version live
dtm create version --notes "Audit checkpoint"

Most workflows should invoke the skill (e.g. /dtm-audit, /dtm-lookup, /gtm-validator) rather than raw CLI calls — the skills bundle the right tool sequence, output formatting, and Notion reporting.

Audit Report Template

# GTM Audit Report

## Summary
- **Container**: GTM-XXXXXX
- **Audit Date**: YYYY-MM-DD
- **Version Reviewed**: XX
- **Overall Status**: ✅ Healthy / ⚠️ Needs Attention / ❌ Critical

## Findings

### ✅ Passing
- [항목]

### ⚠️ Warnings
| Issue | Impact | Recommendation |
|-------|--------|----------------|

### ❌ Critical
| Issue | Impact | Action Required |
|-------|--------|-----------------|

## Tag Firing Status

| Tag | Expected | Actual | Status |
|-----|----------|--------|--------|
| GA4 - Event - purchase | Thank You | Thank You | ✅ |

## Data Quality Check

| Metric | Expected | Actual | Variance |
|--------|----------|--------|----------|
| Daily Purchases | ~50 | 48 | -4% |

## Recommendations
1. 
2. 

## Next Steps
- [ ] 
- [ ] 

## Appendix
- Container JSON snapshot
- D.intel Toolkit output

Update Procedures

Minor Update (태그 수정)

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

Major Update (신규 태그 추가)

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

Emergency Fix

1. 이슈 원인 파악
2. 최소 변경으로 수정
3. Publish (emergency version note)
4. 근본 원인 분석
5. 영구 수정 계획

Versioning Best Practices

Version Naming

v[Major].[Minor] - [Description]
예: v12.1 - Added form_submit event

Version Notes Template

## Changes
- Added: [새로 추가된 항목]
- Modified: [수정된 항목]
- Removed: [삭제된 항목]

## Reason
[변경 이유]

## Testing
- [테스트 항목 및 결과]

## Rollback Plan
[롤백 필요 시 절차]

Monitoring Setup

GA4 Alerts

• 일일 전환 수 급감 (>30%)
• 세션 수 급감 (>50%)
• 이벤트 수집 오류

Custom Monitoring

• DataLayer 오류 로깅
• Tag Manager 오류 추적
• 서버 사이드 태그 상태 (sGTM 시)

Next Phase

주기적 감사 완료 후 → Phase 7: Lookup App (필요 시)