mcpField
S
saleor-core

saleor-core

github.com/saleorDevelopment2415 installsUpdated 13w ago
Repository

About saleor-core

saleor-core is a behavior reference derived from Saleor source code for developers building or debugging discount, promotion, and stock features. It documents internal rules that public API references may not fully cover, with source references and known gotchas.

Key features

  1. 01Discount precedence and stacking rules
  2. 02Order discount allocation logic
  3. 03Stock availability mode guidance
  4. 04Dashboard gotchas and anti-patterns
  5. 05Source-level rule references

Use cases

  1. 01Investigate vouchers or promotions that do not apply
  2. 02Reconstruct line-level order discount allocation
  3. 03Diagnose product stock availability issues

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/saleor/agent-skills --skill saleor-core

After installing, type/saleor-corein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

README.md
rules/
discount-precedence.md
order-discount-allocation.md
stock-availability-modes.md

Details

From the project README

Saleor Core

Backend behavior reference derived from the Saleor core source code. Covers internal mechanics that aren't fully documented in the public API reference — discount precedence, stock availability modes, denormalized fields, and known Dashboard gotchas.

When to Apply

  • Building or debugging discount/promotion UI in the Dashboard
  • Investigating why a voucher or promotion isn't applying
  • Understanding order-level vs line-level discount precedence
  • Working with OrderDiscount / OrderLineDiscount objects
  • Debugging unit_discount_value on OrderLine
  • Deciding whether discounts stack or suppress each other
  • Building price-explanation / waterfall tooling on confirmed orders
  • Reconstructing how an order-level discount distributed across lines
  • Handling free-gift order lines (OrderLine.isGift = true)
  • Working on stock availability, shipping zones, warehouses, or Shop.useLegacyShippingZoneStockAvailability
  • Debugging why PRODUCT_VARIANT_*_IN_CHANNEL webhooks aren't firing
  • Building diagnostic / "doctor" tooling that explains availability problems
  • Auditing Dashboard copy that uses "available" / "in stock" / "purchasable"

Rule Categories

PriorityCategoryImpactPrefix
1DiscountsCRITICALdiscount-
2StockCRITICALstock-

Quick Reference

1. Discounts (CRITICAL)
  • discount-precedence — Full precedence hierarchy, stacking rules, manual vs voucher vs promotion interactions, denormalized field semantics, known Dashboard bug
  • order-discount-allocation — Two-pass calculation of order-level discounts (Pass A collapses records into a single subtotal_discount; Pass B distributes proportionally across lines with last-line absorbing rounding), what the API exposes (per-line totals, per-record-at-order amounts) and what it doesn't (per-record-per-line decomposition), gift-line shape gotcha (ORDER_PROMOTION on OrderLine.discounts[] when isGift = true), reconstruction guidance for consumers
2. Stock (CRITICAL)
  • stock-availability-modes — Shop.useLegacyShippingZoneStockAvailability (3.23+), purchasability vs shippability, server queryset dispatch, mode-conditional webhooks, Dashboard UI / copy / severity rules, migration footguns, test fixtures

How to Use

Read individual rule files for detailed explanations and source-level evidence:

rules/discount-precedence.md
rules/order-discount-allocation.md
rules/stock-availability-modes.md

Each rule file contains:

  • Precedence hierarchy or computation rules
  • Source code references from saleor/ with function names and file paths
  • Anti-patterns and known bugs

Comments

Markdown supported