Commerce Blueprint Expert

commerce-blueprint

Deep expertise in E-commerce domain logic (Cart, Checkout, SKU). Trigger this when building shopping features on top of MVC or ADR.

majiayu000/claude-skill-registry·0installs663starsSecurity

SKILL.md

Full skill instructions

Commerce Blueprint Expert

You are a domain specialist in E-commerce. Your role is to provide the "Business Brain" for shopping components, ensuring reliability in transactions, inventory, and cart state.

🛍️ Domain Logic: The Shopping Cart

When implementing a Cart, do not just build a "Table". Follow these domain rules:

1. Cart Management

Stateless vs Stateful: Determine if the cart is stored in Redis (guest) or Database (logged in).
Merge Logic: Implement a strategy to merge a guest cart into a user cart upon login.
Price Snapshots: Always snapshot the price at the moment an item is added to avoid "Price Changing in Cart" errors.

2. Checkout State Machine

Checkout is not a single action. It is a state machine: DRAFT -> ADDRESS_SET -> SHIPPING_SELECTED -> PAYMENT_PENDING -> COMPLETED / FAILED.

🏗️ Code Blueprints (Vertical Logic)

Cart Item Interface

export interface CartItem {
  sku: string;
  quantity: number;
  unitPrice: number; // Snapshot
  attributes: Record<string, any>; // Color, Size
}

Checkout Guard

async function validateInventory(items: CartItem[]) {
  // Rule: Lock inventory during checkout to avoid overselling.
}

🚀 Workflow (SOP)

Architecture Choice: Decide whether to use mvc-master or adr-scaffold.
Domain Mapping: Define SKU, Inventory, and Order models.
Cart Strategy: Implement the Cart service (Redis/DB).
Service Integration: Use commerce-blueprint to define the complex transition logic between "Cart" and "Order".
Security: Implement Idempotency Keys for payment processing.

🛡️ Best Practices

Inventory Locking: Use pessimistic locking in Atlas for high-concurrency SKU updates.
Tax & Shipping: Encapsulate calculation logic in Domain Services to keep Models clean.
Audit Logs: Every status change in an Order MUST be logged.

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/majiayu000/claude-skill-registry --skill commerce-blueprint

View on GitHub

skills/data/commerce-blueprint/SKILL.md

More Security skills

View all

Security

supabase

Handles the full Supabase workflow from schema changes to deployment, with built-in security guardrails that catch common traps like RLS...

2.7K 308.9K

View

Security

neon-postgres

Comprehensive guides and best practices for Neon Serverless Postgres, covering setup, connection methods, authentication, and platform APIs.

98 216.2K

View

Security

firebase-auth-basics

Guide for setting up and using Firebase Authentication. Use this skill when the user's app requires user sign-in, user management, or secure data access using auth rules.

462 163.8K

View

Security

firebase-security-rules-auditor

A skill to evaluate how secure Firestore security rules are. Use this when Firestore security rules are updated to ensure that the generated rules are extremely secure and robust.

462 127.7K

View

Security

firebase-ai-logic-basics

Official skill for integrating Firebase AI Logic (Gemini API) into web applications. Covers setup, multimodal inference, structured output, and security.

462 125.1K

View

Security

better-auth-best-practices

Complete Better Auth server and client setup with database adapters, session management, plugins, and security configuration.

222 118.2K

View

Security

Deploy and manage projects on Vercel using token-based authentication. Use when working with Vercel CLI using access tokens rather than interactive login — e.g. "deploy to vercel", "set up vercel", "add environment variables to vercel".

31.9K 116.1K

View

Security

cloudflare

Complete Cloudflare platform integration with decision trees for compute, storage, AI, networking, security, and infrastructure-as-code.

3K 110.7K

View

Security

azure-compliance

Run Azure compliance and security audits with azqr plus Key Vault expiration checks. Covers best-practice assessment, resource review, policy/compliance validation, and security posture checks. WHEN: compliance scan, security audit, BEFORE running azqr (compliance cli tool), Azure best practices, Key Vault expiration check, expired certificates, expiring secrets, orphaned resources, compliance assessment.

253 103K

View