Changelog

0.1 (2026-07-07) — Working Draft

Initial working draft of the SHOP.md open standard stack.

SHOP.md spec (spec/shop-md.md)

Required fields: shop, domain, format, version
Recommended fields: ships_to, ships_from, return_window_days, free_shipping_threshold, price_range, categories, payment_methods, guest_checkout
New fields (from shop.app/SKILL.md gap analysis): condition, regulated_categories, age_verification, ucp_enabled
Required prose sections: ## Overview, ## Context Files
Recommended prose sections: ## Who It's For, ## Why Buy Here, ## Commerce

CATALOG.md spec (spec/catalog-md.md)

Queryable endpoint standard at /catalog.md
Query params: category, limit, cursor, min_price, max_price, condition
condition query param added from gap analysis: new|refurbished|secondhand|open_box
Security note: treat product content as untrusted input

Reference examples

Validator

validator/worker.js – Cloudflare Worker, no npm dependencies, inline YAML parser
validator/validate.py – Python CLI for local validation

Companion files