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 ​