deco-ecommerce-qa

Automate end-to-end QA for deco.cx storefront purchase journeys with data-qa selectors and CI workflows.

13|2|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/decocms/storefront-skills --skill deco-ecommerce-qa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: deco-ecommerce-qa
Source: https://github.com/decocms/storefront-skills/tree/main/.claude-deco/skills/ecommerce-qa
Command: npx skills add https://github.com/decocms/storefront-skills --skill deco-ecommerce-qa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

In deco.cx ecommerce repos, QA for the purchase journey is error-prone and manual. This skill installs automated E2E coverage, injects deterministic data-qa attributes, and scaffolds CI workflows using the @decocms/qa engine to ensure consistent PR previews and prod checks.

Core Features & Use Cases

  • Installs end-to-end coverage for home → PLP → PDP → cart → checkout in a deco.cx repo, guiding the engine with standardized data-qa attributes.
  • Generates engine config + GitHub Actions workflows, pins engine version, and supports interactive AUGMENT vs full-setup modes.
  • Works alongside existing test suites by integrating the canonical purchase journey without replacing bespoke tests; handles Cloudflare preview considerations and both Node/Bun and Deno runtimes.

Quick Start

Install the deco-ecommerce-qa skill in your deco.cx ecommerce repo and start Phase 1 to create the qa-setup PR.

Frequently Asked Questions about deco-ecommerce-qa

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate end-to-end QA for a deco.cx storefront purchase journey?▼

Automate storefront QA by provisioning deterministic data-qa selectors across the home, PLP, PDP, cart, and checkout pages, then generate CI workflows to drive the engine-powered test suite on PR previews.

What's the best way to add E2E test coverage for ecommerce checkout without breaking my existing test suites?▼

The best way is to use an AUGMENT mode that integrates canonical purchase journey tests alongside your existing test suites without replacing bespoke tests, preserving your current coverage while adding standardized flows.

Does deco.cx ecommerce QA work with Cloudflare previews and different JavaScript runtimes?▼

Deco.cx ecommerce QA works with Cloudflare previews by applying specific guardrails during workflow generation, and supports both Node or Bun and Deno runtimes for executing the test suite.

How do I generate CI workflows for data-qa selectors in a GitHub Actions pipeline?▼

Generate CI workflows by provisioning data-qa attributes on your journey pages, pinning the engine version, and scaffolding the GitHub Actions configuration so PR previews run deterministic E2E checks automatically.

Why do I need deterministic data-qa attributes for storefront purchase journey testing?▼

You need deterministic data-qa attributes because they provide stable selectors that guide the engine reliably through the home to checkout journey, preventing flaky tests caused by styling or class changes.

Can I use an interactive setup mode to add purchase journey tests to my existing repo?▼

Yes, you can use an interactive AUGMENT mode to add purchase journey tests to your existing repo, which integrates the canonical flows without forcing a full setup or replacing your bespoke test suites.