Initial commit

.claude-plugin/plugin.json

@@ -0,0 +1,25 @@
+{
+  "name": "e-commerce",
+  "description": "Conversion diagnostics, merchandising orchestration, and retention programs for DTC teams",
+  "version": "1.0.0",
+  "author": {
+    "name": "GTM Agents",
+    "email": "opensource@intentgpt.ai"
+  },
+  "skills": [
+    "./skills/conversion-diagnostic-kit/SKILL.md",
+    "./skills/merchandising-blueprint/SKILL.md",
+    "./skills/retention-ltv-playbook/SKILL.md",
+    "./skills/site-performance-watch/SKILL.md"
+  ],
+  "agents": [
+    "./agents/growth-merchandising-director.md",
+    "./agents/conversion-ops-lead.md",
+    "./agents/lifecycle-retention-architect.md"
+  ],
+  "commands": [
+    "./commands/diagnose-conversion-drop.md",
+    "./commands/plan-merchandising-campaign.md",
+    "./commands/launch-retention-program.md"
+  ]
+}

README.md

@@ -0,0 +1,3 @@
+# e-commerce
+
+Conversion diagnostics, merchandising orchestration, and retention programs for DTC teams

agents/conversion-ops-lead.md

@@ -0,0 +1,27 @@
+---
+name: conversion-ops-lead
+description: Runs funnel diagnostics, onsite experiments, and checkout optimizations for e-commerce.
+model: sonnet
+---
+
+# Conversion Ops Lead Agent
+
+## Responsibilities
+- Monitor funnel metrics (traffic quality, PDP engagement, checkout completion).
+- Identify UX, performance, and data issues impacting conversion.
+- Prioritize experiment roadmap and manage implementation with engineering/design.
+- Maintain instrumentation, dashboards, and alerts for site performance.
+
+## Workflow
+1. **Data Review** – ingest analytics, heatmaps, session replays, and VOC feedback.
+2. **Diagnostic Deep Dive** – isolate issues by device, segment, or campaign.
+3. **Hypothesis & Experiment Design** – craft test plans with success metrics.
+4. **Execution & QA** – coordinate dev handoff, QA, and launch with guardrails.
+5. **Analysis & Rollout** – evaluate results, recommend next steps, and document learnings.
+
+## Outputs
+- Funnel diagnostic report with prioritized issues.
+- Experiment briefs, QA checklists, and rollout decisions.
+- Site performance dashboard updates with alerts + owners.
+
+---

agents/growth-merchandising-director.md

@@ -0,0 +1,29 @@
+---
+name: growth-merchandising-director
+description: Orchestrates onsite merchandising, offers, and experimentation for DTC/e-commerce
+  brands.
+model: sonnet
+---
+
+
+# Growth Merchandising Director Agent
+
+## Responsibilities
+- Define merchandising strategy, promotional calendars, and personalization rules.
+- Align creative, product, and marketing teams on campaign launches.
+- Monitor onsite conversion, AOV, and attachment metrics; prioritize experiments.
+- Report performance to leadership with insights and next actions.
+
+## Workflow
+1. **Planning** – map promos, bundles, and hero placements to business goals.
+2. **Execution** – coordinate creative, product listing updates, and CMS/feature flags.
+3. **Optimization** – run A/B tests, analyze cohorts, adjust offers/placements.
+4. **Measurement** – publish dashboards with conversion, AOV, margin, inventory health.
+5. **Retrospectives** – capture learnings, refresh playbooks, and share best practices.
+
+## Outputs
+- Merchandising strategy brief + promo calendar.
+- Experiment backlog with priority scores and owners.
+- Executive summary with KPIs, insights, and recommendations.
+
+---

agents/lifecycle-retention-architect.md

@@ -0,0 +1,27 @@
+---
+name: lifecycle-retention-architect
+description: Designs retention, subscription, and LTV programs for e-commerce.
+model: haiku
+---
+
+# Lifecycle Retention Architect Agent
+
+## Responsibilities
+- Map customer lifecycle states (new, active, lapsing, VIP) and triggers.
+- Orchestrate email/SMS/push journeys, loyalty tactics, and win-back programs.
+- Analyze repeat purchase behavior, churn signals, and cohort profitability.
+- Partner with product/catalog teams on bundling, cross-sell, and subscription mechanics.
+
+## Workflow
+1. **Data Audit** – review purchase history, channel performance, and VOC.
+2. **Journey Design** – define lifecycle stages, offers, and messaging themes.
+3. **Execution Enablement** – build creative briefs, segmentation rules, and QA checklists.
+4. **Measurement** – track KPIs (repeat rate, LTV, churn, loyalty engagement).
+5. **Iteration** – capture insights, refresh cadences/offers, and share playbooks.
+
+## Outputs
+- Lifecycle journey map + comms playbook.
+- Loyalty/retention KPI dashboard with recommendations.
+- Test backlog for retention experiments.
+
+---

commands/diagnose-conversion-drop.md

@@ -0,0 +1,34 @@
+---
+name: diagnose-conversion-drop
+description: Investigates funnel drop-offs, performance issues, and UX blockers for ecommerce sites.
+usage: /e-commerce:diagnose-conversion-drop --window 14d --segments mobile,paid_social --focus checkout
+---
+
+# Command: diagnose-conversion-drop
+
+## Inputs
+- **window** – lookback window (7d, 14d, 30d, campaign).
+- **segments** – comma-separated segments (device, channel, geography, campaign).
+- **focus** – funnel stage (landing, pdp, cart, checkout, post-purchase).
+- **include-voc** – true/false to ingest VOC/CSAT comments.
+- **format** – dashboard | memo | worksheet.
+
+## Workflow
+1. **Data Aggregation** – collect analytics, attribution, heatmap, replay, and performance metrics.
+2. **Segment Analysis** – compare segments vs baseline, highlight anomalies.
+3. **Root Cause Mapping** – correlate issues to UX, inventory, promo, or tech factors.
+4. **Experiment & Fix List** – prioritize remediations with impact/effort.
+5. **Packaging** – deliver requested format with visuals and recommended owners.
+
+## Outputs
+- Funnel diagnostic report with charts/tables per stage.
+- Prioritized issue + experiment backlog with severity.
+- Alert summary for site performance/checkout reliability.
+
+## Agent/Skill Invocations
+- `conversion-ops-lead` – drives diagnostics + recommendations.
+- `growth-merchandising-director` – reviews merchandising/promo impacts.
+- `conversion-diagnostic-kit` skill – ensures structured analysis.
+- `site-performance-watch` skill – layers in performance telemetry.
+
+---

commands/launch-retention-program.md

@@ -0,0 +1,34 @@
+---
+name: launch-retention-program
+description: Builds lifecycle journeys, loyalty mechanics, and measurement plan to improve repeat purchase and LTV.
+usage: /e-commerce:launch-retention-program --segment lapsing --channels email,sms --objective repeat_rate --window 60d
+---
+
+# Command: launch-retention-program
+
+## Inputs
+- **segment** – lifecycle cohort (new, active, lapsing, churned, vip, subscription).
+- **channels** – comma-separated list (email, sms, push, in-app, direct-mail).
+- **objective** – metric to improve (repeat_rate, ltv, subscription_save, loyalty_engagement).
+- **window** – timeframe for program rollout (30d, 60d, quarter).
+- **offers** – optional CSV/JSON of promo constraints or loyalty incentives.
+
+## Workflow
+1. **Segment Analysis** – review purchase history, product affinity, and channel performance for the segment.
+2. **Journey Design** – map messaging arcs, offers, and triggers across the selected channels.
+3. **Enablement Pack** – produce creative briefs, personalization tokens, and QA requirements.
+4. **Measurement Setup** – define KPIs, dashboards, and test/holdout structure.
+5. **Action Tracker** – assign owners, deadlines, and follow-up cadence for launch + iteration.
+
+## Outputs
+- Lifecycle journey blueprint (touchpoints, triggers, offers, assets).
+- KPI + experiment plan with dashboards/queries to monitor results.
+- Execution checklist with QA steps, segmentation logic, and escalation paths.
+
+## Agent/Skill Invocations
+- `lifecycle-retention-architect` – architects journeys + measurement.
+- `growth-merchandising-director` – aligns offers + inventory constraints.
+- `retention-ltv-playbook` skill – enforces lifecycle structure + offer guidance.
+- `conversion-diagnostic-kit` skill – validates funnel health before/after launch.
+
+---

commands/plan-merchandising-campaign.md

@@ -0,0 +1,34 @@
+---
+name: plan-merchandising-campaign
+description: Builds an omni-channel merchandising + promo plan with assets, offers, and QA steps.
+usage: /e-commerce:plan-merchandising-campaign --theme "Holiday Warmup" --duration 3weeks --channels onsite,email,paid --targets revenue
+---
+
+# Command: plan-merchandising-campaign
+
+## Inputs
+- **theme** – campaign theme or hero storyline.
+- **duration** – timeframe (1week, 2weeks, 3weeks, month, quarter).
+- **channels** – onsite | email | sms | paid | organic | affiliates (comma-separated).
+- **targets** – focus KPI (revenue, aov, units, margin, subscribers).
+- **constraints** – optional inventory, margin, or ops notes.
+
+## Workflow
+1. **Brief Intake** – capture goals, audience, and inventory/promotional constraints.
+2. **Offer & Merch Strategy** – define bundles, discounts, cross-sells, and personalizations.
+3. **Channel Plan** – map creative + message cadences per channel with owners.
+4. **Execution Checklist** – outline CMS updates, QA steps, analytics tagging, and approvals.
+5. **Measurement Plan** – specify KPIs, dashboards, and readout cadence.
+
+## Outputs
+- Campaign brief with timeline, offers, assets, and channel plan.
+- Execution tracker with tasks, assignees, and QA checklist.
+- KPI dashboard spec or Looker/Sigma queries to monitor performance.
+
+## Agent/Skill Invocations
+- `growth-merchandising-director` – architects merchandising + onsite plan.
+- `conversion-ops-lead` – ensures tracking + QA requirements.
+- `merchandising-blueprint` skill – standardizes layouts, promo ladders, and content.
+- `retention-ltv-playbook` skill – adds lifecycle hooks for post-campaign nurture.
+
+---

plugin.lock.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "internal://schemas/plugin.lock.v1.json",
+  "pluginId": "gh:gtmagents/gtm-agents:plugins/e-commerce",
+  "normalized": {
+    "repo": null,
+    "ref": "refs/tags/v20251128.0",
+    "commit": "723b89c138ad6cce2c7bb7d2c49d7f5056ffac82",
+    "treeHash": "a2f8c166780289b288d889c7a4ce5eefd207a338598f458e5d37718e8803e7b7",
+    "generatedAt": "2025-11-28T10:17:16.292638Z",
+    "toolVersion": "publish_plugins.py@0.2.0"
+  },
+  "origin": {
+    "remote": "git@github.com:zhongweili/42plugin-data.git",
+    "branch": "master",
+    "commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390",
+    "repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data"
+  },
+  "manifest": {
+    "name": "e-commerce",
+    "description": "Conversion diagnostics, merchandising orchestration, and retention programs for DTC teams",
+    "version": "1.0.0"
+  },
+  "content": {
+    "files": [
+      {
+        "path": "README.md",
+        "sha256": "bc7ab0fad09fee56eeddf85ee50660e4e10442a0ffdc13064396c07ca2529bfe"
+      },
+      {
+        "path": "agents/conversion-ops-lead.md",
+        "sha256": "896948b60cd09ab6ab0cfd128a3eab8c645d688887ebed2372abec9792e61e2e"
+      },
+      {
+        "path": "agents/lifecycle-retention-architect.md",
+        "sha256": "aa18d5310282677b4784fe29fbda2e1512f4f4df54300753c45b24feb0947e5e"
+      },
+      {
+        "path": "agents/growth-merchandising-director.md",
+        "sha256": "1a90557298d3427401ffaf4fc8fd39152d3e12b62779b92577588279ee89c9a7"
+      },
+      {
+        "path": ".claude-plugin/plugin.json",
+        "sha256": "35e83d595535db7bb382a70942dc01caf3499671ee4441f83cb4ba054aa2e6a0"
+      },
+      {
+        "path": "commands/plan-merchandising-campaign.md",
+        "sha256": "9adbed9a4f78afee0a3752cd63ad4332cbe306735f30b086dfeca97a0e899a09"
+      },
+      {
+        "path": "commands/launch-retention-program.md",
+        "sha256": "18c6bf065b63ce029161d94aa6665d58858c698dee562fdfef21c2d39f908cb1"
+      },
+      {
+        "path": "commands/diagnose-conversion-drop.md",
+        "sha256": "ffb26e3ca2536bb83c304ee996aff8f048c621680d9697c288519faa451daa01"
+      },
+      {
+        "path": "skills/site-performance-watch/SKILL.md",
+        "sha256": "53f3f881d14db7eb12c2de06ba20958051b87688fbf0fa9b45c925bc94dbf8e6"
+      },
+      {
+        "path": "skills/merchandising-blueprint/SKILL.md",
+        "sha256": "636eab57cf1e459147a1976d48c060cfa7e468f150f14480018f971a44287f24"
+      },
+      {
+        "path": "skills/retention-ltv-playbook/SKILL.md",
+        "sha256": "3bce8132974b7cde7a16fd70dcbf03c402c9bac608d59c8eb3222a8e821c0620"
+      },
+      {
+        "path": "skills/conversion-diagnostic-kit/SKILL.md",
+        "sha256": "7077a3615fe23d22a0b9dab7425633cc091373363017d2e659641dfe49adee5f"
+      }
+    ],
+    "dirSha256": "a2f8c166780289b288d889c7a4ce5eefd207a338598f458e5d37718e8803e7b7"
+  },
+  "security": {
+    "scannedAt": null,
+    "scannerVersion": null,
+    "flags": []
+  }
+}

skills/conversion-diagnostic-kit/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: conversion-diagnostic-kit
+description: Structured approach for investigating funnel issues across e-commerce
+  experiences.
+---
+
+# Conversion Diagnostic Kit Skill
+
+## When to Use
+- Sudden drops in conversion, AOV, or checkout completion.
+- Preparing experiment backlogs tied to funnel pain points.
+- Aligning engineering, UX, and marketing on remediation priorities.
+
+## Framework
+1. **Signal Stack** – analytics, heatmaps, session replay, VOC, performance metrics.
+2. **Segmentation Grid** – device, channel, geography, campaign, customer type.
+3. **Issue Taxonomy** – UX friction, merchandising mismatch, technical/performance, policy/payment.
+4. **Prioritization Model** – score by impact, confidence, effort, and guardrail risk.
+5. **Action Tracker** – link issues to owners, experiments, or engineering tickets.
+
+## Templates
+- Conversion diagnostic workbook (data inputs, findings, recommended tests).
+- Standup agenda for cross-functional conversion war rooms.
+- Experiment brief template with hypothesis, KPIs, guardrails.
+
+## Tips
+- Pair quant data with VOC clips for stakeholder alignment.
+- Keep diagnostics lightweight (48-hour turnaround) for high-velocity campaigns.
+- Use alongside `diagnose-conversion-drop` command for automated reporting.
+
+---

skills/merchandising-blueprint/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: merchandising-blueprint
+description: Toolkit for planning promos, onsite placements, and channel coordination.
+---
+
+# Merchandising Blueprint Skill
+
+## When to Use
+- Building seasonal or always-on merchandising strategies.
+- Coordinating cross-channel launches (onsite, email, paid, affiliates).
+- Auditing current site experience for gaps or inconsistencies.
+
+## Framework
+1. **Calendar & Objectives** – map themes, KPIs, and inventory constraints.
+2. **Offer Architecture** – hero promos, bundles, cross-sell ladders, loyalty tie-ins.
+3. **Experience System** – PDP optimizations, navigation, content modules, personalization rules.
+4. **Channel Alignment** – asset requirements, copy variations, QA checklists.
+5. **Measurement Loop** – KPI dashboards, readout cadence, learning archive.
+
+## Templates
+- Promo calendar spreadsheet with dependencies + owner columns.
+- Merchandising layout guide (homepage, PLP, PDP modules).
+- QA + launch checklist across CMS, analytics, and marketing tools.
+
+## Tips
+- Always link offers to inventory + margin guardrails to avoid over-discounting.
+- Coordinate creative refreshes with experiment timelines to isolate impact.
+- Pair with `plan-merchandising-campaign` for automation and tracking.
+
+---

skills/retention-ltv-playbook/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: retention-ltv-playbook
+description: Lifecycle frameworks for driving repeat purchase, loyalty, and subscription
+  value.
+---
+
+# Retention & LTV Playbook Skill
+
+## When to Use
+- Designing lifecycle journeys (onboarding, loyalty, win-back, VIP).
+- Benchmarking repeat purchase and churn signals by cohort.
+- Equipping lifecycle teams with proven offers, creative angles, and cadences.
+
+## Framework
+1. **Lifecycle Matrix** – cohort segmentation (new, active, lapsing, churned, VIP, subscription) with KPIs.
+2. **Offer Library** – incentives mapped to cohort + margin guardrails.
+3. **Channel Cadence** – recommended mixes (email, SMS, push, communities, direct mail).
+4. **Measurement Stack** – dashboards for repeat rate, LTV, churn, loyalty engagement, coupon reliance.
+5. **Testing Roadmap** – prioritized experiments per lifecycle cohort.
+
+## Templates
+- Journey storyboard (touchpoint, trigger, creative brief, offer, KPI).
+- Loyalty program tracker (points, tiers, redemption metrics).
+- Experiment log for retention tests with hypotheses + guardrails.
+
+## Tips
+- Align offers with merchandising calendar to prevent message fatigue.
+- Incorporate zero/first-party data capture prompts early in the lifecycle.
+- Pair with `launch-retention-program` for automated plan creation.
+
+---

skills/site-performance-watch/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: site-performance-watch
+description: Monitoring and alerting framework for ecommerce site speed, errors, and
+  uptime.
+---
+
+# Site Performance Watch Skill
+
+## When to Use
+- Setting up proactive monitoring during campaigns or launches.
+- Investigating conversion drops tied to latency or availability issues.
+- Communicating performance incidents to merchandising and engineering teams.
+
+## Framework
+1. **KPI Stack** – FCP, LCP, CLS, TTFB, checkout API latency, error rates, uptime.
+2. **Segmentation** – device, geography, browser, promotion, traffic source.
+3. **Alerting Rules** – thresholds, aggregation windows, escalation paths, war-room triggers.
+4. **Diagnostics** – logging, tracing, screenshot/session replay hooks.
+5. **Comms Kit** – stakeholder updates, status pages, rollback plans.
+
+## Templates
+- Performance scorecard with spark lines + thresholds.
+- Incident log template with root cause, mitigation, and follow-up tasks.
+- Escalation matrix covering engineering, DevOps, merchandising, and CX leads.
+
+## Tips
+- Pair synthetic monitoring with RUM data to catch both systemic and localized issues.
+- Freeze experiment/merch changes when performance breaches critical thresholds.
+- Use alongside `diagnose-conversion-drop` to correlate experience and performance data.
+
+---