From a46364e22a6c6da97fdb60b736e1a16e7680fee4 Mon Sep 17 00:00:00 2001 From: Andrew Yim Date: Sun, 24 May 2026 22:33:30 +0900 Subject: [PATCH] chore(gtm): deprecate dintel-gtm-toolkit, point to DTM Agent MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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) --- .claude/commands/gtm-guardian.md | 65 +++++++-------- .../code/references/phase6-audit.md | 83 +++++++++++-------- 2 files changed, 80 insertions(+), 68 deletions(-) diff --git a/.claude/commands/gtm-guardian.md b/.claude/commands/gtm-guardian.md index d92b32a..2a4529a 100644 --- a/.claude/commands/gtm-guardian.md +++ b/.claude/commands/gtm-guardian.md @@ -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. diff --git a/custom-skills/62-gtm-validator/code/references/phase6-audit.md b/custom-skills/62-gtm-validator/code/references/phase6-audit.md index fd1c26b..2f25f82 100644 --- a/custom-skills/62-gtm-validator/code/references/phase6-audit.md +++ b/custom-skills/62-gtm-validator/code/references/phase6-audit.md @@ -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 +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