chore(gtm): deprecate dintel-gtm-toolkit, point to DTM Agent
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:
@@ -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
|
## Use these instead
|
||||||
- "GTM audit lifecycle", "container analysis"
|
|
||||||
- "GTM 유지보수", "버전 비교"
|
|
||||||
|
|
||||||
## 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
|
```bash
|
||||||
# Clone D.intelligence GTM Toolkit
|
# Active context
|
||||||
git clone https://github.com/ourdigital/dintel-gtm-agent.git
|
dtm status
|
||||||
|
dtm list accounts
|
||||||
|
dtm list containers
|
||||||
|
|
||||||
# Container analysis
|
# Inspect live container
|
||||||
python analyze_container.py GTM-XXXXXX.json --output report.md
|
dtm list tags
|
||||||
|
dtm list triggers
|
||||||
|
dtm list variables
|
||||||
|
|
||||||
# Version comparison
|
# Versions
|
||||||
python diff_versions.py v1.json v2.json --output diff.md
|
dtm list versions
|
||||||
|
dtm version live
|
||||||
# Unused element detection
|
|
||||||
python find_unused.py container.json --type all
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## Phase 6: Progressive Audit
|
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.
|
||||||
|
|
||||||
| 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).
|
|
||||||
|
|
||||||
## Notion Output
|
## Notion Output
|
||||||
- Database: GTM Knowledge Base
|
|
||||||
- Properties: Project, Audit Date, Container ID, Status, Issues Count
|
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.
|
||||||
- Reports in Korean; technical terms in English
|
|
||||||
|
|||||||
@@ -7,7 +7,7 @@
|
|||||||
1. GTM 컨테이너 건강 상태 점검
|
1. GTM 컨테이너 건강 상태 점검
|
||||||
2. 태그 발화 및 데이터 정합성 검증
|
2. 태그 발화 및 데이터 정합성 검증
|
||||||
3. 최신 요구사항 반영 업데이트
|
3. 최신 요구사항 반영 업데이트
|
||||||
4. D.intelligence GTM Toolkit 연계 자동화
|
4. DTM Agent 연계 자동화
|
||||||
|
|
||||||
## Audit Schedule
|
## Audit Schedule
|
||||||
|
|
||||||
@@ -44,56 +44,73 @@
|
|||||||
- [ ] Meta Events Manager 상태
|
- [ ] Meta Events Manager 상태
|
||||||
- [ ] Kakao Pixel 상태
|
- [ ] Kakao Pixel 상태
|
||||||
|
|
||||||
## D.intelligence GTM Toolkit Integration
|
## DTM Agent Integration
|
||||||
|
|
||||||
### Repository
|
> 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.
|
||||||
```
|
|
||||||
https://github.com/ourdigital/dintel-gtm-toolkit
|
|
||||||
```
|
|
||||||
|
|
||||||
### Capabilities
|
### DTM Agent Skills
|
||||||
|
|
||||||
| Feature | Description | Use Case |
|
| Capability | Skill | Replaces |
|
||||||
|---------|-------------|----------|
|
|------------|-------|----------|
|
||||||
| Container Analysis | JSON 파싱, 구조 분석 | 컨테이너 리뷰 |
|
| Tag CRUD | `dtm-tags` | `analyze_container.py` (tags section) |
|
||||||
| Dependency Mapping | 태그↔트리거↔변수 관계 | 영향도 분석 |
|
| Trigger CRUD | `dtm-triggers` | `analyze_container.py` (triggers section) |
|
||||||
| Version Diff | 버전 간 변경사항 비교 | 변경 추적 |
|
| Variable CRUD | `dtm-variables` | `analyze_container.py` (variables section) |
|
||||||
| Tag Validation | 발화 상태 자동 검증 | 정기 감사 |
|
| 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
|
### Integration Workflow
|
||||||
|
|
||||||
```
|
```
|
||||||
1. GTM Container Export
|
1. Active container selection
|
||||||
└── JSON 파일 다운로드
|
└── /dtm-set (or dtm set account/container)
|
||||||
|
|
||||||
2. D.intel Toolkit Analysis
|
2. Live container analysis
|
||||||
├── python analyze_container.py container.json
|
├── /dtm-tags, /dtm-triggers, /dtm-variables (list / inspect)
|
||||||
├── Dependency graph 생성
|
├── /dtm-lookup (dependency graph, unused resources)
|
||||||
└── Issue detection
|
└── /dtm-debug (configuration + performance grading)
|
||||||
|
|
||||||
3. Report Generation
|
3. Page-level audit
|
||||||
└── Markdown/HTML 리포트
|
└── /dtm-audit (Chrome DevTools MCP — fired tags vs. configured)
|
||||||
|
|
||||||
4. GTM Guardian Update
|
4. Validation (this skill)
|
||||||
└── Notion에 리포트 저장
|
└── /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
|
```bash
|
||||||
# Container 분석
|
# Container status & active context
|
||||||
python analyze_container.py GTM-XXXXXX.json --output report.md
|
dtm status
|
||||||
|
dtm list accounts
|
||||||
|
dtm list containers
|
||||||
|
|
||||||
# 버전 비교
|
# Tags / triggers / variables
|
||||||
python diff_versions.py v1.json v2.json --output diff.md
|
dtm list tags
|
||||||
|
dtm get tag <TAG_ID>
|
||||||
|
dtm list triggers
|
||||||
|
dtm list variables
|
||||||
|
|
||||||
# 태그 검증
|
# Version management
|
||||||
python validate_tags.py container.json --events events.csv
|
dtm list versions
|
||||||
|
dtm version live
|
||||||
# 미사용 요소 탐지
|
dtm create version --notes "Audit checkpoint"
|
||||||
python find_unused.py container.json --type all
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
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
|
## Audit Report Template
|
||||||
|
|
||||||
```markdown
|
```markdown
|
||||||
|
|||||||
Reference in New Issue
Block a user