ourdigital/our-claude-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(gtm): deprecate dintel-gtm-toolkit, point to DTM Agent

Browse Source 
The `dintel-gtm-toolkit` Python scripts (analyze_container.py,
diff_versions.py, validate_tags.py, find_unused.py) have been
replaced by the DTM Agent skill set, which operates on live
containers via the GTM API instead of exported JSON.

- .claude/commands/gtm-guardian.md: rewrite as a deprecation
  pointer with old→new mapping for every script/phase
  (Phase 6 → /dtm-audit + /dtm-debug, Phase 7 → /dtm-taxonomy +
  /dtm-lookup, etc.).
- custom-skills/62-gtm-validator/code/references/phase6-audit.md:
  replace "D.intelligence GTM Toolkit Integration" section with
  DTM Agent skill map, live-container workflow, and dtm CLI
  examples; update objective #4.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Andrew Yim
2026-05-24 22:33:30 +09:00
parent 8189473008
commit a46364e22a
2 changed files with 80 additions and 68 deletions
Download Patch File Download Diff File Expand all files Collapse all files

65
.claude/commands/gtm-guardian.md
View File

@@ -1,49 +1,44 @@
---
description: GTM lifecycle automation - progressive audit, version comparison, and lookup app
description: Deprecated alias for DTM Agent skills — redirects to /dtm-audit, /dtm-lookup, /dtm-version, and /gtm-validator
---
# GTM Guardian
# GTM Guardian (Deprecated)
GTM tagging lifecycle automation: progressive audit (Phase 6) and event lookup app (Phase 7).
> **The `gtm-guardian` workflow and the `dintel-gtm-toolkit` Python scripts are deprecated.** All GTM lifecycle automation now lives in the **DTM Agent** skill set, which operates on live containers via the Google Tag Manager API instead of exported JSON.
## Triggers
- "GTM audit lifecycle", "container analysis"
- "GTM 유지보수", "버전 비교"
## Use these instead
## Quick Commands
| Old (gtm-guardian / dintel-gtm-toolkit) | New (DTM Agent skill) |
|---|---|
| `analyze_container.py` — container structure analysis | `/dtm-tags`, `/dtm-triggers`, `/dtm-variables`, `/dtm-lookup` |
| `find_unused.py` — unused element detection | `/dtm-lookup` (unused resource detection) |
| `diff_versions.py` — version comparison | `/dtm-version` (list, create, compare versions) |
| `validate_tags.py` — tag firing verification | `/gtm-validator` (live page QA via Chrome DevTools MCP) |
| Phase 6 — Progressive Audit | `/dtm-audit` (page audit, tracking coverage, gap analysis) + `/dtm-debug` (A–D grading) |
| Phase 7 — Event Taxonomy Lookup App | `/dtm-taxonomy` (classify events, validate naming, export docs) + `/dtm-lookup` (universal search, dependency graph) |
| Container/account switching | `/dtm-set` |
| Status & health check | `/dtm-status` |
## Quick Reference
```bash
# Clone D.intelligence GTM Toolkit
git clone https://github.com/ourdigital/dintel-gtm-agent.git
# Active context
dtm status
dtm list accounts
dtm list containers
# Container analysis
python analyze_container.py GTM-XXXXXX.json --output report.md
# Inspect live container
dtm list tags
dtm list triggers
dtm list variables
# Version comparison
python diff_versions.py v1.json v2.json --output diff.md
# Unused element detection
python find_unused.py container.json --type all
# Versions
dtm list versions
dtm version live
```
## Phase 6: Progressive Audit
| Feature | Description |
|---------|-------------|
| Container Analysis | JSON parsing, structure analysis |
| Dependency Mapping | Tag-trigger-variable relationships |
| Version Diff | Change tracking between versions |
| Tag Validation | Automatic firing state verification |
### Audit Schedule
- Weekly: Tag firing validation
- Monthly: Full container review
- Quarterly: Architecture review
## Phase 7: Lookup App
Google Apps Script-based Event Taxonomy lookup app (Google Sheets -> Apps Script -> Web App).
For full workflows, invoke the skill directly (e.g. `/dtm-audit`, `/gtm-validator`) — each skill bundles the right tool sequence, output formatting, and Notion reporting via the `notion-writer` skill.
## Notion Output
- Database: GTM Knowledge Base
- Properties: Project, Audit Date, Container ID, Status, Issues Count
- Reports in Korean; technical terms in English
Unchanged — DTM Agent skills still write to the **GTM Knowledge Base** database (properties: Project, Audit Date, Container ID, Status, Issues Count). Reports remain in Korean with English technical terms.

83
custom-skills/62-gtm-validator/code/references/phase6-audit.md
View File

@@ -7,7 +7,7 @@
1. GTM 컨테이너 건강 상태 점검
2. 태그 발화 및 데이터 정합성 검증
3. 최신 요구사항 반영 업데이트
4. D.intelligence GTM Toolkit 연계 자동화
4. DTM Agent 연계 자동화
## Audit Schedule
@@ -44,56 +44,73 @@
- [ ] Meta Events Manager 상태
- [ ] Kakao Pixel 상태
## D.intelligence GTM Toolkit Integration
## DTM Agent Integration
### Repository
```
https://github.com/ourdigital/dintel-gtm-toolkit
```
> 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.
### Capabilities
### DTM Agent Skills
| Feature | Description | Use Case |
|---------|-------------|----------|
| Container Analysis | JSON 파싱, 구조 분석 | 컨테이너 리뷰 |
| Dependency Mapping | 태그↔트리거↔변수 관계 | 영향도 분석 |
| Version Diff | 버전 간 변경사항 비교 | 변경 추적 |
| Tag Validation | 발화 상태 자동 검증 | 정기 감사 |
| 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. GTM Container Export
└── JSON 파일 다운로드
1. Active container selection
└── /dtm-set (or dtm set account/container)
2. D.intel Toolkit Analysis
├── python analyze_container.py container.json
├── Dependency graph 생성
└── Issue detection
2. Live container analysis
├── /dtm-tags, /dtm-triggers, /dtm-variables (list / inspect)
├── /dtm-lookup (dependency graph, unused resources)
└── /dtm-debug (configuration + performance grading)
3. Report Generation
└── Markdown/HTML 리포트
3. Page-level audit
└── /dtm-audit (Chrome DevTools MCP — fired tags vs. configured)
4. GTM Guardian Update
└── Notion에 리포트 저장
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 Toolkit Commands
### Sample DTM Agent Commands
```bash
# Container 분석
python analyze_container.py GTM-XXXXXX.json --output report.md
# Container status & active context
dtm status
dtm list accounts
dtm list containers
# 버전 비교
python diff_versions.py v1.json v2.json --output diff.md
# Tags / triggers / variables
dtm list tags
dtm get tag <TAG_ID>
dtm list triggers
dtm list variables
# 태그 검증
python validate_tags.py container.json --events events.csv
# 미사용 요소 탐지
python find_unused.py container.json --type all
# 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
```markdown