Skip to content

feat(ecommerce): add cart abandonment analysis flow skill#290

Open
itayhewix wants to merge 2 commits into
mainfrom
feat/dev3-ecom-recommendation-skill
Open

feat(ecommerce): add cart abandonment analysis flow skill#290
itayhewix wants to merge 2 commits into
mainfrom
feat/dev3-ecom-recommendation-skill

Conversation

@itayhewix

@itayhewix itayhewix commented May 26, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds flow-cart-abandonment-analysis.md — a new L4 flow skill covering all abandoned cart performance questions. Removes the now-redundant goal-reduce-cart-abandonment.md and wires the entry point directly to the flow.

Changes

New: flow-cart-abandonment-analysis.md

Handles all AC performance intents: rate, root causes, recovery automation, funnel analysis.

Data sources (3-tier priority: API → Profile → DWH)

  • Profile fields (pre-fetched in Step 3): ecom_number_cart_that_were_abandoned_last_30_days, ecom_usd_sum_of_carts_that_were_abandoned_last_30_days, activate_abandoned_cart_automation
  • GetAbandonedCartsBenchmarks API call for industry benchmarks at runtime
  • DWH reference queries saved as DEBUG REFERENCE ONLY for future data-to-production wiring (see below)

Root cause diagnosis (5 causes)

  • A: Shipping cost surprise
  • B: Shipping coverage gap
  • C: No recovery automation (Profile signal)
  • D: High shipping rates
  • E: Checkout friction — now uses checkout_churn_pct > 80% as a strong signal; cart_churn_pct > 60% identifies pre-checkout drop (different problem)

Recommendations: domain abandoned_cart_recovery, action activate_abandoned_cart_recovery

KPIs + measurement plan included in the flow

DWH reference queries (validated 2026-05-26)

  • prod.ecom.abandoned_cart_dim (Tier 1) — per-site recovery rate, recoverable count, avg cart value
    • Sample: Fishing 15.8% recovery, Cannabis 40.6%, Lighting 13.6%, Sneakers 7.4%
  • prod.ecom.abandoned_cart_enrichments_monthly — cart vs checkout churn split
    • Sample: Fishing 99% checkout churn, Cannabis 69% cart churn, Sneakers 96% checkout churn
  • Future runtime path: com.wixpress.datatoproduction.data-to-production

Removed: goal-reduce-cart-abandonment.md

Content absorbed into the flow. Removing this eliminates a redundant loading hop (R → goal → flow → now R → flow directly). The goal layer is justified when multiple flows exist under a goal; for cart abandonment there is currently only one flow.

Updated: recommend-ecommerce-strategy.md

  • Step 3: adds 3 new Profile fields for abandoned cart data
  • Step 4b: ABANDONED_CART domain now loads the flow directly
  • Step 6: ABANDONED_CART section delegates to the flow

Updated: skill-graph.md and documentation.yaml

Test plan

  • Load flow via ReadFullDocsArticle — verify no 404
  • Trigger ABANDONED_CART domain — confirm entry point loads flow-cart-abandonment-analysis directly (no goal hop)
  • Verify 3 new Profile fields return data on a site with abandoned carts
  • Confirm GetAbandonedCartsBenchmarks returns benchmark rates
  • Check that goal-reduce-cart-abandonment URL now 404s (deleted)
  • Run DWH reference queries against a test MSID and compare output to Profile field values

🤖 Generated with Claude Code

Adds flow-cart-abandonment-analysis.md — a new L4 flow skill that handles
all abandoned cart performance questions (rate, root causes, recovery).

- New flow: calculates abandonment rate from Profile data, fetches industry
  benchmarks via GetAbandonedCartsBenchmarks, diagnoses 5 root causes
  (shipping cost surprise, coverage gap, no recovery automation, high rates,
  checkout friction), generates recommendations (domain: abandoned_cart_recovery)
- Adds 3 abandoned-cart Profile fields to Step 3 of the entry point:
  ecom_number_cart_that_were_abandoned_last_30_days,
  ecom_usd_sum_of_carts_that_were_abandoned_last_30_days,
  activate_abandoned_cart_automation
- Removes goal-reduce-cart-abandonment.md — redundant now that the flow
  handles all logic; entry point loads the flow directly for ABANDONED_CART
- Updates skill-graph.md, documentation.yaml, and entry point routing

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions

github-actions Bot commented May 26, 2026

Copy link
Copy Markdown
Contributor

⚠️ Skill Evaluation: Warning

Pass rate: 28.57142857142857%
Run ID: fc579e08-4907-42f6-93b5-3434d3758f91

…o cart abandonment flow

- Adds debug reference SQL for prod.ecom.abandoned_cart_dim and
  abandoned_cart_enrichments_monthly, validated against 4 test sites
- Documents future data-to-production API wiring (com.wixpress.datatoproduction)
- Adds cart vs checkout churn signals to root cause E diagnosis:
  checkout_churn_pct > 80% = checkout friction; cart_churn_pct > 60% = pre-checkout drop
- Includes sample query output from 2026-05-26 for QA reference

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant