Ecommerce

---

name: Ecommerce slug: ecommerce version: 1.0.0 description: Build and operate online stores with payment security, inventory management, marketplace integration, and conversion optimization. metadata: {"clawdbot":{"emoji":"🛒","requires":{"bins":[]},"os":["linux","darwin","win32"]}}

---

Quick Reference

| Topic | File | |-------|------| | Code traps that break production | code-traps.md | | Platform comparison (costs, features) | platforms.md | | Operations (stock, shipping, returns) | operations.md | | Growth (CRO, upsells, LTV, benchmarks) | growth.md |

Critical Code Traps

These break production and cost real money. See code-traps.md for full patterns.

1. Payment idempotency — Store payment_intent_id, check before processing. Webhooks retry. 2. Inventory race conditions — UPDATE ... WHERE stock > 0 with rowsAffected check, not read-then-write. 3. Frontend price trust — Backend recalculates everything. Never trust client totals. 4. Webhook signatures — Verify stripe-signature or equivalent. Reject unsigned requests. 5. Stock validation timing — Verify at payment moment, not just add-to-cart.

Core Rules

When Building Stores

Calculate ALL prices server-side — discounts, shipping, taxes, totals

Queue transactional emails — never inline in checkout flow

Add structured data (Schema.org Product) and canonical URLs from day one

Implement webhook signature verification before going live

When Operating Stores

Monitor stock thresholds, not just zero — alert at reorder point

Track orders stuck in "processing" >24h — detect before customer complains

Log payment failures with context — card decline reasons matter for recovery

When Optimizing

Checkout recovery: 1h, 24h, 72h sequence — discount on email 3, not 1

Free shipping threshold: current AOV + 20-30%

Mobile: sticky add-to-cart, Apple Pay/Google Pay, LCP <2.5s

Platform Decision Tree

Budget <€500/mo, <100 SKUs: Shopify Basic or WooCommerce self-hosted

Multi-marketplace: Dedicated sync tool (not manual updates)

>1000 SKUs or ERP: WooCommerce/custom with PIM integration

For Spain-specific costs (IVA, OSS, carriers), see platforms.md.

Scope

This skill helps with:

Store architecture and payment integration

Inventory and order management logic

Marketplace listing optimization

Conversion rate tactics with benchmarks

Legal/fiscal guidance for EU/Spain ecommerce

This skill does NOT:

Connect to live store APIs (explain how, not execute)

Store business data or credentials

Make purchasing or pricing decisions autonomously