diff --git a/.claude/commands/gtm-audit.md b/.claude/commands/gtm-audit.md index eb131e8..ab90559 100644 --- a/.claude/commands/gtm-audit.md +++ b/.claude/commands/gtm-audit.md @@ -6,6 +6,20 @@ description: GTM page audit - scan fired tags, gap analysis, tag design from DOM Comprehensive Google Tag Manager audit using Playwright to scan live pages for container health, tag firing, dataLayer events, form tracking, and e-commerce checkout flows. +## MANDATORY: Knowledge Base Read/Write + +**Before starting any audit:** +1. Identify the target client from container ID or URL +2. Read `knowledge-base/accounts//profile.md` — URL patterns, known issues, platform stack, past findings +3. Read `knowledge-base/accounts//*.md` — taxonomy, naming issues to exclude from new findings +4. Skim `knowledge-base/logs//` — past session context + +**After completing audit, write a session log:** +- Write to `knowledge-base/logs//YYYY-MM-DD-.md` +- Include: date, container ID, status, issues found (root causes + specific IDs), lessons learned +- Update `knowledge-base/accounts//profile.md` if you discovered persistent facts +- See `AGENTS.md` for full format template + ## Triggers - "audit GTM", "check dataLayer", "GTM 검사", "scan GTM tags", "audit tags on page", "check tag firing" diff --git a/.claude/commands/gtm-editor.md b/.claude/commands/gtm-editor.md index 0627797..1ebbabf 100644 --- a/.claude/commands/gtm-editor.md +++ b/.claude/commands/gtm-editor.md @@ -22,6 +22,20 @@ Priority reads per task: - "create GTM tag", "generate dataLayer", "modify trigger" - "update variable", "write custom HTML", "manage GTM" +## MANDATORY: Knowledge Base Read/Write + +**Before creating or modifying ANY tags, triggers, or variables:** +1. Identify the target client from container ID +2. Read `knowledge-base/accounts//profile.md` — key variables, URL patterns, platform stack, known issues +3. Read `knowledge-base/accounts//*.md` — taxonomy reveals existing event names and naming conventions +4. Skim `knowledge-base/logs//` — past fixes reveal patterns (e.g., "form POST loses URL params") + +**After completing tag management, write a session log:** +- Write to `knowledge-base/logs//YYYY-MM-DD-.md` +- Include: date, container ID, tags affected (IDs), what was created/modified/deleted, cHTML snippets +- Update `knowledge-base/accounts//profile.md` if you discovered persistent facts +- See `AGENTS.md` for full format template + ## MANDATORY: dataLayer First Workflow 1. **Design dataLayer push FIRST** (match client's tech stack: vanilla JS/React/Vue/PHP) diff --git a/.claude/commands/gtm-validator.md b/.claude/commands/gtm-validator.md index 96ed072..ee031fa 100644 --- a/.claude/commands/gtm-validator.md +++ b/.claude/commands/gtm-validator.md @@ -20,6 +20,20 @@ Priority reads per task: - "validate tags", "QA GTM", "debug GTM" - "naming conventions", "GTM best practice" +## MANDATORY: Knowledge Base Read/Write + +**Before starting any validation or QA:** +1. Identify the target client from container ID or URL +2. Read `knowledge-base/accounts//profile.md` — naming conventions, known issues, platform stack +3. Read `knowledge-base/accounts//*.md` — taxonomy defines expected events; naming fix plans reveal known violations +4. Skim `knowledge-base/logs//` — past QA reveals recurring issues and known false positives + +**After completing validation, write a session log:** +- Write to `knowledge-base/logs//YYYY-MM-DD-.md` +- Include: date, container ID, pass/fail results, broken triggers (IDs), new naming violations +- Update `knowledge-base/accounts//profile.md` if you discovered persistent facts +- See `AGENTS.md` for full format template + ## Validation Modes ### 1. Tag Firing Verification