commerce-blueprint
Deep expertise in E-commerce domain logic (Cart, Checkout, SKU). Trigger this when building shopping features on top of MVC or ADR.
How do I install this agent skill?
npx skills add https://github.com/gravito-framework/gravito --skill commerce-blueprintIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides architectural guidance and code templates for e-commerce logic. It contains no executable code, network calls, or suspicious instructions.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
1/1 file flagged
What does this agent skill do?
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-masteroradr-scaffold. - Domain Mapping: Define
SKU,Inventory, andOrdermodels. - Cart Strategy: Implement the Cart service (Redis/DB).
- Service Integration: Use
commerce-blueprintto 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 Servicesto keep Models clean. - Audit Logs: Every status change in an Order MUST be logged.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/gravito-framework/gravito/commerce-blueprint">View commerce-blueprint on skillZs</a>