debugging-playbook

Step-by-step methodology for diagnosing and fixing analytics tracking issues.

Content Preview
# Tracking Debug Playbook

Step-by-step methodology for diagnosing and fixing analytics tracking issues.

---

## The Debug Mindset

Analytics bugs are harder than code bugs because:
1. They fail silently — no error thrown, just missing data
2. They often only appear in production
3. They can be caused by timing, consent, ad blockers, or just configuration

Work systematically. Don't guess. Verify at each layer before moving to the next.

---

## The Debug Stack (Bottom-Up)

```
Layer 5: GA4 Rep
How to Use

Recommended: Install to project (local)

mkdir -p .claude/skills
curl -o .claude/skills/debugging-playbook.md \
  https://raw.githubusercontent.com/alirezarezvani/claude-skills/main/marketing-skill/analytics-tracking/references/debugging-playbook.md

Skill is scoped to this project only. Add .claude/skills/ to your .gitignoreif you don't want to commit it.

Alternative: Clone full repo

git clone https://github.com/alirezarezvani/claude-skills

Then reference at marketing-skill/analytics-tracking/references/debugging-playbook.md

Related Skills