Quality Gates & Audit Master Guide

Intent

Document the pre-merge checklist: what gates must pass, which audit artefacts to update, and which tests the repo expects, per .github/instructions/64-quality-testing-copilot-instructions.md.

Gates to Run

• Run pnpm run architecture:gate after any structural change (new dependencies, cross-layer imports, new modules); this enforces the dependency cruiser rules described in .github/instructions/61-architectural-governance-copilot-instructions.md.
• Before PR, execute pnpm run lint, pnpm run build -- --noEmit, and the relevant unit suites described in the capability instructions.
• Ensure Husky/lint-staged hooks triggered by git commit pass (eslint and tsc --noEmit per package.json).

Documentation & Audit Tracking

• Update docs/AUDIT-<module>.md whenever you change a capability, event, or critical workflow; note invariants, boundaries, and audit findings as specified in .github/instructions/64-quality-testing-copilot-instructions.md.
• Document requirements/status in requirements.md and tasks.md (status values: not-started, in-progress, completed, blocked) before completion.
• Capture architecture:gate failures’ logs and include them in your notes so reviewers can see what changed since the last passing gate.

Testing Expectations

• Cover every critical path and domain invariant touched by your change with tests (Jasmine + Karma for unit stores/domains, Playwright for happy-path flows).
• Use Playwright with resilient selectors (data-testid, roles) and emulator resets so tests are deterministic (.github/skills/e2e-playwright already describes these patterns).
• When introducing async or signal transitions, do full Arrange-Act-Assert cycles and clean up subscriptions with takeUntilDestroyed() or rxMethod disposal.

When to Apply This Skill

• Anytime you add/modify tests, instructions, or GA/QA tasks that must mention gating commands, auditors, or docs.
• Whenever you touch documentation or pipeline scripts so that audit assets remain in sync with the docs/AUDIT-* expectations.