commit 5b43e8250992626bdfcff9318c96a99916353fb2 Author: Zhongwei Li Date: Sat Nov 29 18:30:30 2025 +0800 Initial commit diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json new file mode 100644 index 0000000..659206d --- /dev/null +++ b/.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" + ] +} \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..7294e46 --- /dev/null +++ b/README.md @@ -0,0 +1,3 @@ +# e-commerce + +Conversion diagnostics, merchandising orchestration, and retention programs for DTC teams diff --git a/agents/conversion-ops-lead.md b/agents/conversion-ops-lead.md new file mode 100644 index 0000000..456c058 --- /dev/null +++ b/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. + +--- diff --git a/agents/growth-merchandising-director.md b/agents/growth-merchandising-director.md new file mode 100644 index 0000000..3163017 --- /dev/null +++ b/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. + +--- diff --git a/agents/lifecycle-retention-architect.md b/agents/lifecycle-retention-architect.md new file mode 100644 index 0000000..8928c60 --- /dev/null +++ b/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. + +--- diff --git a/commands/diagnose-conversion-drop.md b/commands/diagnose-conversion-drop.md new file mode 100644 index 0000000..5c0afb1 --- /dev/null +++ b/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. + +--- diff --git a/commands/launch-retention-program.md b/commands/launch-retention-program.md new file mode 100644 index 0000000..a5baf4e --- /dev/null +++ b/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. + +--- diff --git a/commands/plan-merchandising-campaign.md b/commands/plan-merchandising-campaign.md new file mode 100644 index 0000000..443dfbd --- /dev/null +++ b/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. + +--- diff --git a/plugin.lock.json b/plugin.lock.json new file mode 100644 index 0000000..fd04fd6 --- /dev/null +++ b/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": [] + } +} \ No newline at end of file diff --git a/skills/conversion-diagnostic-kit/SKILL.md b/skills/conversion-diagnostic-kit/SKILL.md new file mode 100644 index 0000000..1ef6e82 --- /dev/null +++ b/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. + +--- diff --git a/skills/merchandising-blueprint/SKILL.md b/skills/merchandising-blueprint/SKILL.md new file mode 100644 index 0000000..31cd0fd --- /dev/null +++ b/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. + +--- diff --git a/skills/retention-ltv-playbook/SKILL.md b/skills/retention-ltv-playbook/SKILL.md new file mode 100644 index 0000000..7f4bd34 --- /dev/null +++ b/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. + +--- diff --git a/skills/site-performance-watch/SKILL.md b/skills/site-performance-watch/SKILL.md new file mode 100644 index 0000000..93b3e65 --- /dev/null +++ b/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. + +---