@wix/agent-skills 1.0.0

package/skills/wix-manage/references/ecommerce/flow-stock-mover.md

@@ -0,0 +1,308 @@
+---
+name: "Flow: Stock Mover"
+description: Creates discount campaigns to clear slow-moving inventory by targeting products with high stock levels and low sales velocity. Uses deeper discounts proportional to inventory urgency.
+layer: flow
+references:
+  - name: "Guardrail: Discount Conflicts"
+    path: ecommerce/guardrail-discount-conflicts.md
+    load: true
+  - name: "Guardrail: Margin Protection"
+    path: ecommerce/guardrail-margin-protection.md
+    load: true
+  - name: "Setup: Discount Rules"
+    path: ecommerce/setup-discount-rules.md
+    load: true
+---
+# Flow: Stock Mover Clearance
+
+> **Before executing this skill**, read these referenced skills with `ReadFullDocsArticle`:
+> - [Guardrail: Discount Conflicts](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/guardrail-discount-conflicts)
+> - [Guardrail: Margin Protection](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/guardrail-margin-protection)
+> - [Setup: Discount Rules](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/setup-discount-rules)
+
+Creates a discount targeting slow-moving inventory — products with high stock levels and low sales velocity. The discount depth is proportional to how overstocked the product is, with deeper discounts for the most stagnant items. Margin protection guardrails are especially important here since clearance discounts tend to push closer to cost.
+
+## Prerequisites
+
+- Wix Stores installed on the site
+- Products exist in the catalog with inventory (quantity) data
+- Access to `getCatalogAnalytics` and `getProductCatalogData` tools
+- Inventory tracking enabled for target products
+
+## Required APIs
+
+- [Create Discount Rule](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/discounts/discount-rules/create-discount-rule)
+- [Query Discount Rules](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/discounts/discount-rules/query-discount-rules)
+
+---
+
+## Step 1: Gather inventory and sales data
+
+Call `getCatalogAnalytics` and `getProductCatalogData` concurrently to assess stock levels and sales velocity.
+
+**getCatalogAnalytics** call:
+```
+aggregates: sum(quantity), sum(ordersCount), avg(profitMargin)
+```
+
+**getProductCatalogData** call:
+```
+ordered: quantity DESC, ordersCount ASC
+```
+
+This sort order surfaces products with the most stock and the fewest sales first — the primary candidates for clearance.
+
+Save the following values:
+- `total_quantity` — total stock across catalog
+- `total_orders` — total sales across catalog
+- `avg_profit_margin` — average profit margin (sets discount ceiling)
+- Per-product: `quantity`, `ordersCount`, `price`, `name`, `id`, `categoryId`
+
+---
+
+## Step 2: Identify slow-moving products
+
+Calculate the velocity ratio for each product to identify overstocked items:
+
+```
+velocity_ratio = ordersCount / quantity
+```
+
+| Velocity Ratio | Classification | Action |
+|---|---|---|
+| < 0.1 | **Severely overstocked** — fewer than 1 sale per 10 units in stock | High priority for clearance discount |
+| 0.1 - 0.3 | **Moderately overstocked** — slow but not stagnant | Medium priority |
+| 0.3 - 0.7 | **Balanced** — reasonable sell-through rate | Not a clearance candidate |
+| > 0.7 | **Fast-moving** — selling well relative to stock | Do NOT discount — unnecessary margin erosion |
+
+Select products with velocity_ratio < 0.3 as clearance candidates.
+
+If `quantity = 0` for a product, skip it (nothing to clear). If `ordersCount = 0`, the velocity ratio is 0 — this is the most urgent clearance case.
+
+---
+
+## Step 3: Calculate discount depth
+
+Scale the discount based on inventory urgency. Deeper discounts for more overstocked items, constrained by margin:
+
+| Velocity Ratio | Recommended Discount | Rationale |
+|---|---|---|
+| 0 (zero sales) | 20-25% | Maximum urgency — product is not moving at all |
+| < 0.1 | 15-20% | Severely slow — needs aggressive pricing |
+| 0.1 - 0.2 | 10-15% | Moderately slow — moderate discount |
+| 0.2 - 0.3 | 5-10% | Slightly slow — gentle nudge |
+
+**Margin constraint**: Always verify `discount <= avg_profit_margin - 15%` (minMarginPct). Clearance discounts are more likely to violate margin thresholds because they are deliberately deeper.
+
+**Global cap**: Do not exceed 25% unless the merchant explicitly overrides. For clearance, merchants may accept deeper discounts to free up capital and shelf space.
+
+---
+
+## Step 4: Determine discount scope
+
+Select the scope based on the distribution of slow movers:
+
+- **ITEMS** (preferred for clearance): Target specific slow-moving products by ID (max 5 productIds). This is the most precise approach and avoids discounting fast sellers.
+- **CATEGORY**: When multiple slow movers cluster in the same category, target the whole category. This is simpler but may discount some healthy-velocity products in the same category.
+- **SITE**: Rarely appropriate for clearance — avoid discounting the entire catalog to clear a few items.
+
+When selecting ITEMS scope, prioritize the products with the worst velocity ratios (lowest first), up to the max of 5 productIds.
+
+---
+
+## Step 5: Convert category names to GUIDs (if CATEGORY scope)
+
+If scope is CATEGORY, call `getCategoryIds` to convert category names to GUIDs.
+
+- Never use category names as scope IDs — always use the GUID.
+- Exclude the "All Products" system category.
+- Max 3 categoryIds per discount rule.
+
+---
+
+## Step 6: Run guardrail checks
+
+**IMPORTANT: Run both guardrail checks before creating the discount rule. Clearance discounts are the most likely to trigger margin warnings.**
+
+### 6a: Discount Conflicts
+
+1. Query existing active discount rules:
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/discount-rules/query`
+
+**Request**:
+```json
+{
+  "query": {
+    "filter": {
+      "active": true
+    },
+    "paging": {
+      "limit": 100
+    }
+  }
+}
+```
+
+2. Check for scope overlap. Clearance items that already have an active discount would stack — warn the merchant about combined discount depth.
+3. Check for coupon stacking risks. A customer combining a clearance discount with a coupon code could get an unexpectedly deep total discount.
+
+### 6b: Margin Protection
+
+This check is especially critical for clearance:
+
+- Verify `discount_percentage <= avg_profit_margin - 15%` for each candidate product.
+- If the discount would push effective margin below 15%, warn the merchant: "This clearance discount of {discount}% on {product_name} would reduce the effective margin to {remaining_margin}%. The minimum margin threshold is 15%. Proceed?"
+- If margin data is unavailable, apply extra caution — cap at 15% unless the merchant explicitly overrides.
+
+---
+
+## Step 7: Create the discount rule
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/discount-rules`
+
+**Request** — 20% off specific slow-moving products:
+```json
+{
+  "discountRule": {
+    "name": "Clearance - Overstock Items 20% Off",
+    "active": true,
+    "discounts": [
+      {
+        "discount": {
+          "discountType": "PERCENTAGE",
+          "percentage": 20
+        },
+        "scope": {
+          "id": "slow-mover-product-uuid-1",
+          "type": "SPECIFIC_PRODUCTS"
+        }
+      },
+      {
+        "discount": {
+          "discountType": "PERCENTAGE",
+          "percentage": 20
+        },
+        "scope": {
+          "id": "slow-mover-product-uuid-2",
+          "type": "SPECIFIC_PRODUCTS"
+        }
+      },
+      {
+        "discount": {
+          "discountType": "PERCENTAGE",
+          "percentage": 20
+        },
+        "scope": {
+          "id": "slow-mover-product-uuid-3",
+          "type": "SPECIFIC_PRODUCTS"
+        }
+      }
+    ]
+  }
+}
+```
+
+**Response**:
+```json
+{
+  "discountRule": {
+    "id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
+    "revision": "1",
+    "name": "Clearance - Overstock Items 20% Off",
+    "active": true,
+    "discounts": [
+      {
+        "discount": {
+          "discountType": "PERCENTAGE",
+          "percentage": 20
+        },
+        "scope": {
+          "id": "slow-mover-product-uuid-1",
+          "type": "SPECIFIC_PRODUCTS"
+        }
+      },
+      {
+        "discount": {
+          "discountType": "PERCENTAGE",
+          "percentage": 20
+        },
+        "scope": {
+          "id": "slow-mover-product-uuid-2",
+          "type": "SPECIFIC_PRODUCTS"
+        }
+      },
+      {
+        "discount": {
+          "discountType": "PERCENTAGE",
+          "percentage": 20
+        },
+        "scope": {
+          "id": "slow-mover-product-uuid-3",
+          "type": "SPECIFIC_PRODUCTS"
+        }
+      }
+    ]
+  }
+}
+```
+
+**Request** — clearance on an entire category:
+```json
+{
+  "discountRule": {
+    "name": "Clearance - Winter Collection 15% Off",
+    "active": true,
+    "discounts": [
+      {
+        "discount": {
+          "discountType": "PERCENTAGE",
+          "percentage": 15
+        },
+        "scope": {
+          "id": "winter-collection-category-guid",
+          "type": "COLLECTION"
+        }
+      }
+    ]
+  }
+}
+```
+
+Save the returned `id` and `revision` for later management.
+
+---
+
+## Step 8: Verify the rule is active
+
+1. Query discount rules to confirm the new rule exists and is `active: true`
+2. Verify the correct products or category are targeted
+3. Report to the merchant:
+   > "Clearance discount is live: {discount}% off {number_of_products} slow-moving items. These products had a velocity ratio of {avg_velocity}, indicating high stock relative to sales. Monitor inventory levels — once stock clears, consider deactivating the rule."
+
+---
+
+## Branching logic
+
+| Merchant intent | Scope | Discount depth | Notes |
+|---|---|---|---|
+| "Clear out old inventory" | ITEMS — top 5 slowest movers | Velocity-based (15-25%) | Target worst performers |
+| "Clearance sale on winter items" | COLLECTION with category GUID | 15-20% | Category-wide clearance |
+| "Get rid of product X" (specific) | SPECIFIC_PRODUCTS with product UUID | 20-25% (user may override) | Single product clearance |
+| "Move stale stock across the store" | ITEMS — 5 worst velocity products | Velocity-based | Avoid SITE scope for clearance |
+| "25% off these 3 items" (explicit) | SPECIFIC_PRODUCTS | 25% (user override) | Honor explicit request |
+
+## Error Handling
+
+| Error | Cause | Fix |
+|---|---|---|
+| `DISCOUNT_RULE_NOT_FOUND` | Rule ID doesn't exist | Re-query discount rules for current IDs |
+| `REVISION_MISMATCH` | Revision doesn't match | Re-fetch rule for latest revision, then retry |
+| No slow movers found | All products have healthy velocity ratios (> 0.3) | Inform merchant that inventory is balanced; no clearance needed |
+| Margin violation | Discount would push margin below 15% | Reduce discount percentage or get explicit merchant override |
+| Quantity data missing | Products lack inventory tracking | Cannot identify slow movers; ask merchant to enable inventory tracking or specify products manually |
+| Max items exceeded | More than 5 slow-moving products identified | Select the 5 with worst velocity ratios; consider CATEGORY scope if they share a category |
+
+## References
+
+- [Discount Rules API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/discounts/discount-rules/introduction)

package/skills/wix-manage/references/ecommerce/flow-upsell-boost.md

@@ -0,0 +1,271 @@
+---
+name: "Flow: Upsell Boost"
+description: Creates a discount campaign to increase average order value by setting minimum subtotal conditions above current AOV. Uses margin-based discount tiers and targets high-margin categories.
+layer: flow
+references:
+  - name: "Guardrail: Discount Conflicts"
+    path: ecommerce/guardrail-discount-conflicts.md
+    load: true
+  - name: "Guardrail: Margin Protection"
+    path: ecommerce/guardrail-margin-protection.md
+    load: true
+  - name: "Setup: Discount Rules"
+    path: ecommerce/setup-discount-rules.md
+    load: true
+---
+# Flow: Upsell Boost Campaign
+
+> **Before executing this skill**, read these referenced skills with `ReadFullDocsArticle`:
+> - [Guardrail: Discount Conflicts](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/guardrail-discount-conflicts)
+> - [Guardrail: Margin Protection](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/guardrail-margin-protection)
+> - [Setup: Discount Rules](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/setup-discount-rules)
+
+Creates a discount that incentivizes customers to spend more per order by setting a minimum subtotal threshold above the store's current AOV. The discount percentage is scaled to the store's average profit margin, and the scope targets high-margin categories or products.
+
+## Prerequisites
+
+- Wix Stores installed on the site
+- Products exist in the catalog with price data
+- Access to `getCatalogAnalytics` and `getProductCatalogData` tools
+- AOV data available from site metrics (revenue / ordersCount)
+
+## Required APIs
+
+- [Create Discount Rule](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/discounts/discount-rules/create-discount-rule)
+- [Query Discount Rules](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/discounts/discount-rules/query-discount-rules)
+
+---
+
+## Step 1: Gather catalog data and site metrics
+
+Call `getCatalogAnalytics` and `getProductCatalogData` concurrently to collect pricing, margin, and product data.
+
+**getCatalogAnalytics** call:
+```
+aggregates: count, quantiles([0.5, 0.75, 0.9], price), avg(profitMargin)
+```
+
+**getProductCatalogData** call:
+```
+ordered: price DESC, ordersCount DESC
+```
+
+Also retrieve site-level AOV from `getSiteData` (AOV = revenue / ordersCount). Run the AOV sanity check: if AOV < price_p25, override with price_p50 as the effective AOV.
+
+Save the following values:
+- `effective_aov` — the validated average order value
+- `avg_profit_margin` — average profit margin across the catalog
+- `price_p50`, `price_p75`, `price_p90` — pricing quantiles
+- Top products by price and order volume
+
+---
+
+## Step 2: Determine margin tier and calculate discount + minSubTotal
+
+Use the average profit margin to select the appropriate discount and threshold tier.
+
+| Margin Tier | Condition | Max Discount | minSubTotal Formula |
+|---|---|---|---|
+| Low margin | `avg_profit_margin < 25%` | 10% | `1.15 x effective_aov` |
+| Medium margin | `25% <= avg_profit_margin <= 50%` | 15% | `1.3 x effective_aov` |
+| High margin | `avg_profit_margin > 50%` | 20% | `1.5 x effective_aov` |
+| No data | Margin data unavailable | 10% | `1.15 x effective_aov` |
+
+Example: If `effective_aov` = $150 and `avg_profit_margin` = 35% (medium), then max discount = 15% and raw minSubTotal = $195.
+
+---
+
+## Step 3: Round minSubTotal (CRITICAL)
+
+**minSubTotal MUST be rounded UP to the nearest $5 increment** (the result mod 5 must equal 0). Always round UP, never down.
+
+| Raw Value | Rounded Value |
+|---|---|
+| $195 | $195 (already divisible by 5) |
+| $217 | $220 |
+| $223 | $225 |
+| $199 | $200 |
+| $172.50 | $175 |
+| $201 | $205 |
+
+Formula: `minSubTotal = ceil(raw_value / 5) * 5`
+
+---
+
+## Step 4: Determine discount scope
+
+Select the scope based on analytics data:
+
+- **CATEGORY** (preferred): When analytics show a clear high-margin category opportunity. Target the category with the highest profit margin that also has sufficient product count.
+- **ITEMS**: When specific high-margin products stand out as upsell candidates (max 5 productIds).
+- **SITE** (fallback): When no single category or product group dominates, apply catalog-wide.
+
+---
+
+## Step 5: Convert category names to GUIDs (if CATEGORY scope)
+
+If scope is CATEGORY, call `getCategoryIds` to convert human-readable category names into GUIDs. **Never output category names directly as scope IDs.**
+
+Exclude the "All Products" system category — it contains every product and would effectively make the discount site-wide.
+
+Max 3 categoryIds per discount rule.
+
+---
+
+## Step 6: Run guardrail checks
+
+**IMPORTANT: Run both guardrail checks before creating the discount rule.**
+
+### 6a: Discount Conflicts
+
+1. Query existing active discount rules:
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/discount-rules/query`
+
+**Request**:
+```json
+{
+  "query": {
+    "filter": {
+      "active": true
+    },
+    "paging": {
+      "limit": 100
+    }
+  }
+}
+```
+
+2. Check for scope overlap, time overlap, and coupon stacking risks with the planned upsell discount.
+3. If conflicts found, present to merchant and get confirmation before proceeding.
+
+### 6b: Margin Protection
+
+Verify that `discount_percentage <= avg_profit_margin - 15%` (minMarginPct). If the discount would push effective margin below 15%, warn the merchant.
+
+The global discount cap is 25%. Do not exceed this unless the merchant explicitly overrides it.
+
+---
+
+## Step 7: Create the discount rule
+
+**Endpoint**: `POST https://www.wixapis.com/ecom/v1/discount-rules`
+
+**Request** — 15% off orders over $195, scoped to a category:
+```json
+{
+  "discountRule": {
+    "name": "Spend $195+, Get 15% Off",
+    "active": true,
+    "discounts": [
+      {
+        "discount": {
+          "discountType": "PERCENTAGE",
+          "percentage": 15
+        },
+        "scope": {
+          "id": "category-guid-here",
+          "type": "COLLECTION"
+        }
+      }
+    ],
+    "conditions": {
+      "subtotalRange": {
+        "from": "195.00"
+      }
+    }
+  }
+}
+```
+
+**Response**:
+```json
+{
+  "discountRule": {
+    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
+    "revision": "1",
+    "name": "Spend $195+, Get 15% Off",
+    "active": true,
+    "discounts": [
+      {
+        "discount": {
+          "discountType": "PERCENTAGE",
+          "percentage": 15
+        },
+        "scope": {
+          "id": "category-guid-here",
+          "type": "COLLECTION"
+        }
+      }
+    ],
+    "conditions": {
+      "subtotalRange": {
+        "from": "195.00"
+      }
+    }
+  }
+}
+```
+
+**Request** — site-wide fallback example:
+```json
+{
+  "discountRule": {
+    "name": "Spend $175+, Get 10% Off Everything",
+    "active": true,
+    "discounts": [
+      {
+        "discount": {
+          "discountType": "PERCENTAGE",
+          "percentage": 10
+        },
+        "scope": {
+          "id": "catalog",
+          "type": "CATALOG"
+        }
+      }
+    ],
+    "conditions": {
+      "subtotalRange": {
+        "from": "175.00"
+      }
+    }
+  }
+}
+```
+
+Save the returned `id` and `revision` for later management.
+
+---
+
+## Step 8: Verify the rule is active
+
+1. Query discount rules to confirm the new rule exists and is `active: true`
+2. Verify the minSubTotal condition is correctly set
+3. Report to the merchant:
+   > "Upsell discount is live: {discount}% off on orders over ${minSubTotal} for {scope description}. This threshold is {percentage}% above your current average order value of ${effective_aov}, designed to incentivize higher spending."
+
+---
+
+## Branching logic
+
+| Merchant intent | Scope | Discount | minSubTotal |
+|---|---|---|---|
+| "Increase average order value" | Determined by analytics (CATEGORY preferred) | Margin-tiered | Calculated from AOV |
+| "Get people to spend more on electronics" | COLLECTION with electronics category GUID | Margin-tiered | Calculated from AOV |
+| "20% off orders over $200" (explicit) | As specified by merchant | 20% (user override) | $200 (user override) |
+| "Reward big spenders" | CATALOG (site-wide) | Margin-tiered | Calculated from AOV |
+
+## Error Handling
+
+| Error | Cause | Fix |
+|---|---|---|
+| `DISCOUNT_RULE_NOT_FOUND` | Rule ID doesn't exist | Re-query discount rules for current IDs |
+| `REVISION_MISMATCH` | Revision doesn't match | Re-fetch rule for latest revision, then retry |
+| AOV unavailable | No revenue or order data | Use price_p50 from catalog analytics as AOV proxy |
+| Margin data unavailable | No profit margin data in catalog | Default to low-margin tier (10% discount, 1.15x AOV) |
+| Category GUID not found | Category name doesn't match any collection | Re-query categories or fall back to SITE scope |
+
+## References
+
+- [Discount Rules API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/discounts/discount-rules/introduction)

package/skills/wix-manage/references/ecommerce/goal-clear-inventory.md

@@ -0,0 +1,118 @@
+---
+name: "Goal: Clear Inventory"
+description: Maps the STOCK_MOVER business goal to inventory turnover KPIs and clearance discount flows.
+layer: goal
+references:
+  - name: "Flow: Stock Mover"
+    path: ecommerce/flow-stock-mover.md
+    load: true
+  - name: "Guardrail: Margin Protection"
+    path: ecommerce/guardrail-margin-protection.md
+    load: false
+---
+# Goal: Clear Slow-Moving Inventory
+
+> **Before executing this skill**, read these referenced skills with `ReadFullDocsArticle`:
+> - [Flow: Stock Mover](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/flow-stock-mover)
+>
+> **Related skills** (read with `ReadFullDocsArticle` if needed):
+> - [Guardrail: Margin Protection](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/guardrail-margin-protection)
+
+Automate clearance discounts for products with high stock levels and low sales velocity, converting stagnant inventory into revenue before it becomes a carrying cost liability.
+
+---
+
+## Business Goal
+
+**Goal ID:** `STOCK_MOVER`
+
+The merchant wants to reduce excess inventory for products that are not selling at an acceptable rate. This is achieved by creating targeted discounts on slow-moving products, with discount depth proportional to how overstocked the product is relative to its sales velocity.
+
+---
+
+## KPIs
+
+| KPI | Definition | How to measure |
+|---|---|---|
+| Inventory turnover ratio | ordersCount / quantity for each product | `getProductCatalogData` — compare ordersCount to current quantity |
+| Days of supply | Current stock / average daily sales rate | Estimate from ordersCount over the product's listing period |
+| Clearance conversion rate | Units sold during clearance / units available at start | Track stock levels before and after campaign |
+| Revenue recovered | Revenue from clearance sales that would not have occurred organically | Compare sales velocity before and during campaign |
+
+---
+
+## Triggers
+
+Activate this goal when the merchant expresses any of the following intents:
+
+- "clear inventory"
+- "stock mover"
+- "clearance sale"
+- "old inventory"
+- "overstocked"
+- "slow sellers"
+- "dead stock"
+- "excess stock"
+- "move old products"
+- Any request mentioning inventory levels, stock clearance, or product velocity
+
+---
+
+## Recommended Actions
+
+### Primary: Flow: Stock Mover Clearance
+
+The sole action for this goal. Identifies slow-moving products using the velocity ratio (ordersCount / quantity) and creates targeted discounts with depth proportional to inventory urgency.
+
+**When to use:** Whenever the merchant wants to reduce stock levels for underperforming products.
+
+**Key mechanics:**
+- Velocity analysis: products with low ordersCount relative to quantity are clearance candidates
+- Discount depth scales with overstock severity (deeper discounts for more stagnant items)
+- Scope is typically ITEMS (specific slow-moving products) or CATEGORY (if an entire category is underperforming)
+- Margin protection is critical — clearance discounts push closer to cost, so the guardrail must verify effective margin stays above 15%
+
+**Product selection criteria:**
+- High quantity + low ordersCount = primary candidates
+- Products with 0 orders in 30+ days = urgent candidates
+- Products approaching seasonal irrelevance = time-sensitive candidates
+
+---
+
+## Measurement Plan
+
+### Before campaign launch
+
+1. Record baseline stock levels for all targeted products
+2. Record current sales velocity (ordersCount over last 30 days)
+3. Calculate starting inventory turnover ratio per product
+
+### During campaign (weekly check-ins)
+
+1. Track units sold per clearance product
+2. Monitor margin impact — clearance discounts erode margins faster than other campaigns
+3. Check if discount depth needs adjustment:
+   - Products still not moving after 7 days — consider deepening discount
+   - Products clearing too fast — margin may be too generous
+
+### After campaign (30-day assessment)
+
+1. Calculate clearance rate: `units_sold / starting_stock * 100`
+2. Compare inventory turnover ratio before and after
+3. Calculate revenue recovered from products that had near-zero velocity
+4. Assess carrying cost savings from reduced inventory
+5. Target benchmarks:
+   - Clearance rate > 50% = successful
+   - Clearance rate < 20% = discount may have been too conservative or products are truly unsellable
+
+---
+
+## Decision Matrix
+
+| Scenario | Approach | Rationale |
+|---|---|---|
+| Few specific slow products | ITEMS scope, targeted discounts | Surgical clearance avoids discounting healthy inventory |
+| Entire category underperforming | CATEGORY scope | Broader clearance when the problem is category-wide |
+| Products near zero velocity | Deeper discounts (up to margin floor) | Aggressive clearance justified for truly stagnant stock |
+| Seasonal items approaching end of season | Time-limited clearance with urgency | Combine with end date to create customer urgency |
+| Merchant specifies products or percentages | Honor merchant input | User overrides always take priority |