Skip to content

QA Playbooks (Grouped)

This page groups QA execution playbooks and service playbooks by domain so QA flows stay consistent and explicit.

QA execution playbooks

1) Local quality gate (fast)

Goal: Validate TypeScript + build + smoke availability.

SOP

  1. npm run lint
  2. npm run build
  3. npm run smoke

Outputs

  • Lint/build success and live docs/MCP availability checks (common/story/qa docs + all 16 MCP PROTOCOL.md pages).

2) Full CI gate (local runner)

Goal: Full lint/test/build/synth/smoke gate.

SOP

  1. CDK_TELEMETRY_OPTOUT=1 npm run ci

3) Deep live gate (extended full gate)

Goal: Periodic full live gate with env-gated suites enabled (OFM workflows + PVM use-cases + ops E2E + USM sweep/API key + MRS AWS SDK).

SOP

  1. RUN_OFM_WORKFLOWS=1 RUN_PVM_USECASES=1 RUN_PVM_E2E_OPS=1 RUN_USM_SWEEP_E2E=1 RUN_USM_APIKEY_E2E=1 MRS_AWS_SDK_TESTS=1 CDK_TELEMETRY_OPTOUT=1 AWS_PROFILE=g3nretailstack AWS_REGION=us-east-1 npm run ci:full

Outputs

  • Full live gate + env-gated suites; record outcomes in QA.md.

4) Super usecase harness

Goal: End-to-end validation for SU1/SU2/SU3.

SOP

  1. AWS_PROFILE=g3nretailstack AWS_REGION=us-east-1 npm run super:bootstrap
  2. RUN_SUPER_USECASES=1 npm run test:super

Outputs

  • Full super-usecase coverage across services with pass/fail/timeout outcomes.

Service playbooks (grouped)

Identity & Access

Org / Facilities / Channels

Records & Catalog

Inventory / Sales / Procurement / Pricing

Customer / Marketing / Loyalty

Accounting & Integrations

Offboarding / Utility