Saleor Configurator

When to Apply

• Writing or editing

  config.yml

  for a Saleor store
• Running

  deploy

  ,

  introspect

  , or

  diff

  commands
• Understanding which identifier to use (

  slug

  vs

  name

  ) for each entity
• Debugging mismatches between local config and remote state
• Setting up CI/CD pipelines for automated deployments
• Migrating store configuration between environments

Rule Categories by Priority

config-

identity-

cli-

deploy-

diff-

Quick Reference

1. Config Schema (CRITICAL)

• config-schema

  — YAML structure, all top-level keys, entity examples

2. Entity Identity (CRITICAL)

• identity-strategies

  — Slug-based vs name-based vs singleton; which entity uses which

3. CLI Workflow (HIGH)

• cli-commands

  — All commands, flags, env vars, credential setup, non-interactive mode

4. Deployment (HIGH)

• deploy-pipeline

  — Stage order, dependency graph, selective deployment, failure handling

5. Diff & Sync (MEDIUM)

• diff-behavior

  — How diff detects changes, what triggers create/update/delete

How to Use

rules/config-schema.md
rules/identity-strategies.md
rules/cli-commands.md
rules/deploy-pipeline.md
rules/diff-behavior.md

Full Compiled Document

AGENTS.md