qa-skills 3.0.0 → 3.1.0

package/dist/scaffold.js

@@ -1,182 +0,0 @@
-import path from 'node:path';
-import fs from 'fs-extra';
-export const SKILL_OUTPUT_MAP = {
-    'requirements-generator': { dirs: ['docs/requirements'], pattern: 'REQ-{feature}.md' },
-    'spec-writer': { dirs: ['docs/specs'], pattern: 'SPEC-{feature}.md' },
-    'plan-creator': { dirs: ['docs/plans'], pattern: '{plan-type}-plan.md' },
-    'test-strategy': { dirs: ['docs/plans'], pattern: 'test-strategy.md' },
-    'discovery-interview': { dirs: ['docs/briefs'], pattern: 'brief-{project}.md' },
-    'bug-ticket-creator': { dirs: ['docs/bug-tickets'], pattern: 'BUG-{id}.md' },
-    'diagram-generator': { dirs: ['docs/diagrams'], pattern: '{type}-{name}.md' },
-    'nfr-analyst': { dirs: ['docs/nfr'], pattern: 'NFR-{feature}.md' },
-    'api-contract-curator': { dirs: ['docs/api-contracts'], pattern: '{service}.openapi.yaml' },
-    'test-doc-compiler': { dirs: ['docs/compiled'], pattern: '{doc-type}-{date}.md' },
-    'testcase-from-docs': { dirs: ['test-cases/from-docs'], pattern: 'TC-{feature}.md' },
-    'testcase-from-ui': { dirs: ['test-cases/from-ui'], pattern: 'TC-UI-{page}.md' },
-    'manual-test-designer': { dirs: ['test-cases/manual'], pattern: 'MTC-{feature}.md' },
-    'jest-writer': { dirs: ['tests/unit'], pattern: '{name}.test.ts' },
-    'vitest-writer': { dirs: ['tests/unit'], pattern: '{name}.test.ts' },
-    'pytest-writer': { dirs: ['tests/unit'], pattern: 'test_{name}.py' },
-    'junit5-writer': { dirs: ['tests/unit'], pattern: '{Name}Test.java' },
-    'playwright-ts-writer': { dirs: ['tests/e2e'], pattern: '{name}.spec.ts' },
-    'playwright-py-writer': { dirs: ['tests/e2e'], pattern: 'test_{name}.py' },
-    'cypress-writer': { dirs: ['tests/e2e'], pattern: '{name}.cy.ts' },
-    'selenium-py-writer': { dirs: ['tests/e2e'], pattern: 'test_{name}.py' },
-    'selenium-java-writer': { dirs: ['tests/e2e'], pattern: '{Name}Test.java' },
-    'webdriverio-writer': { dirs: ['tests/e2e'], pattern: '{name}.e2e.ts' },
-    'codeceptjs-writer': { dirs: ['tests/e2e'], pattern: '{name}.test.ts' },
-    'robot-framework-writer': { dirs: ['tests/e2e'], pattern: '{name}.robot' },
-    'supertest-writer': { dirs: ['tests/api', 'tests/integration'], pattern: '{name}.test.ts' },
-    'httpx-writer': { dirs: ['tests/api', 'tests/integration'], pattern: 'test_{name}.py' },
-    'rest-assured-writer': { dirs: ['tests/api', 'tests/integration'], pattern: '{Name}ApiTest.java' },
-    'spring-test-writer': { dirs: ['tests/integration'], pattern: '{Name}IntegrationTest.java' },
-    'k6-writer': { dirs: ['tests/performance'], pattern: '{name}.k6.js' },
-    'locust-writer': { dirs: ['tests/performance'], pattern: 'locustfile_{name}.py' },
-    'jmeter-writer': { dirs: ['tests/performance'], pattern: '{name}.jmx' },
-    'security-test-writer': { dirs: ['tests/security'], pattern: '{name}.security.ts' },
-    'accessibility-test-writer': { dirs: ['tests/accessibility'], pattern: '{name}.a11y.ts' },
-    'visual-regression-writer': { dirs: ['tests/visual'], pattern: '{name}.visual.ts' },
-    'mobile-test-writer': { dirs: ['tests/mobile'], pattern: '{name}.mobile.ts' },
-    'pact-writer': { dirs: ['tests/contracts'], pattern: '{consumer}-{provider}.pact.ts' },
-    'test-reporter': { dirs: ['reports/test-runs'], pattern: 'report-{date}.md' },
-    'coverage-analyzer': { dirs: ['reports/coverage'], pattern: 'coverage-{date}.md' },
-    'risk-analyzer': { dirs: ['reports/risk'], pattern: 'risk-{feature}.md' },
-    'spec-auditor': { dirs: ['reports/audit'], pattern: 'audit-{date}.md' },
-    'flaky-detector': { dirs: ['reports/flaky'], pattern: 'flaky-{date}.md' },
-    'test-reviewer': { dirs: ['reports/reviews'], pattern: 'review-{file}.md' },
-    'changelog-analyzer': { dirs: ['reports/changelog'], pattern: 'changelog-{date}.md' },
-    'data-factory': { dirs: ['data/fixtures'], pattern: '{entity}.fixture.ts' },
-};
-/**
- * Generate the qa-project-structure.mdc rule content for only the installed skills.
- */
-export function generateStructureRule(installedSkillIds) {
-    const rows = [];
-    for (const id of installedSkillIds) {
-        const mapping = SKILL_OUTPUT_MAP[id];
-        if (!mapping)
-            continue;
-        const skillName = id.startsWith('qa-') ? id : `qa-${id}`;
-        for (const dir of mapping.dirs) {
-            rows.push(`| ${skillName} | \`${dir}/\` | \`${mapping.pattern}\` |`);
-        }
-    }
-    if (rows.length === 0)
-        return '';
-    return `---
-description: QA project artifact routing — maps each skill to its output directory
-globs: "**"
-alwaysApply: true
----
-
-# QA Project Structure
-
-When generating QA artifacts, save outputs to these project-relative directories.
-Create the directory on first use if it does not exist.
-
-| Skill | Output Directory | File Pattern |
-|-------|-----------------|--------------|
-${rows.join('\n')}
-
-## Conventions
-
-- All paths are relative to the project root.
-- Create directories on-demand when producing the first artifact — do NOT pre-create empty folders.
-- Test writers follow framework conventions for file naming within their output directory.
-- Reports include a date stamp in the filename for traceability.
-- Diagrams are saved as Mermaid-in-Markdown files.
-`;
-}
-/**
- * Check whether a given path prefix is covered by the project's .gitignore.
- */
-export async function isGitignored(targetDir, dirPrefix) {
-    const gitignorePath = path.join(targetDir, '.gitignore');
-    if (!(await fs.pathExists(gitignorePath)))
-        return false;
-    const content = await fs.readFile(gitignorePath, 'utf-8');
-    const lines = content.split('\n').map((l) => l.trim()).filter((l) => l && !l.startsWith('#'));
-    const normalized = dirPrefix.replace(/\\/g, '/').replace(/\/$/, '');
-    const segment = normalized.split('/')[0];
-    for (const pattern of lines) {
-        const clean = pattern.replace(/\/$/, '');
-        if (clean === segment || clean === `${segment}/` || clean === `.${segment}` || clean === `.${segment}/`) {
-            return true;
-        }
-        if (clean === normalized || clean === `${normalized}/`) {
-            return true;
-        }
-    }
-    return false;
-}
-/**
- * Generate a portable AGENTS.md section with the project structure convention.
- * This file lives at the project root and is always committed to git.
- */
-export function generateAgentsMdSection(installedSkillIds) {
-    const rows = [];
-    for (const id of installedSkillIds) {
-        const mapping = SKILL_OUTPUT_MAP[id];
-        if (!mapping)
-            continue;
-        const skillName = id.startsWith('qa-') ? id : `qa-${id}`;
-        for (const dir of mapping.dirs) {
-            rows.push(`| ${skillName} | \`${dir}/\` | \`${mapping.pattern}\` |`);
-        }
-    }
-    if (rows.length === 0)
-        return '';
-    return `# QA Project Structure
-
-When generating QA artifacts, save outputs to these project-relative directories.
-Create the directory on first use if it does not exist.
-
-| Skill | Output Directory | File Pattern |
-|-------|-----------------|--------------|
-${rows.join('\n')}
-
-## Conventions
-
-- All paths are relative to the project root.
-- Create directories on-demand — do NOT pre-create empty folders.
-- Test writers follow framework conventions for file naming within their output directory.
-- Reports include a date stamp in the filename for traceability.
-`;
-}
-/**
- * Write the structure rule to the appropriate agent rules directory.
- */
-export async function writeStructureRule(targetDir, rulesPath, installedSkillIds) {
-    const content = generateStructureRule(installedSkillIds);
-    if (!content)
-        return false;
-    const ruleFile = path.join(targetDir, rulesPath, 'qa-project-structure.mdc');
-    await fs.ensureDir(path.dirname(ruleFile));
-    await fs.writeFile(ruleFile, content, 'utf-8');
-    return true;
-}
-/**
- * Write or append the structure convention to AGENTS.md at the project root.
- * This is the gitignore-safe fallback — AGENTS.md is always committed.
- */
-export async function writeAgentsMd(targetDir, installedSkillIds) {
-    const section = generateAgentsMdSection(installedSkillIds);
-    if (!section)
-        return false;
-    const agentsFile = path.join(targetDir, 'AGENTS.md');
-    if (await fs.pathExists(agentsFile)) {
-        const existing = await fs.readFile(agentsFile, 'utf-8');
-        if (existing.includes('# QA Project Structure')) {
-            const replaced = existing.replace(/# QA Project Structure[\s\S]*?(?=\n# |\n---|\Z)/, section);
-            await fs.writeFile(agentsFile, replaced, 'utf-8');
-        }
-        else {
-            await fs.writeFile(agentsFile, existing.trimEnd() + '\n\n' + section, 'utf-8');
-        }
-    }
-    else {
-        await fs.writeFile(agentsFile, section, 'utf-8');
-    }
-    return true;
-}
-//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"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"}

package/skills/qa-accessibility-test-writer/SKILL.md

@@ -1,127 +0,0 @@
----
-name: qa-accessibility-test-writer
-description: Generate accessibility tests for WCAG 2.2 compliance using axe-core, Pa11y, and Lighthouse with automated checks for ARIA patterns, keyboard navigation, color contrast, and screen reader support.
-output_dir: tests/accessibility
----
-
-# QA Accessibility Test Writer
-
-## Purpose
-
-Write accessibility tests ensuring WCAG 2.2 compliance. Transform NFR accessibility criteria (from qa-nfr-analyst) and application context into executable accessibility test scripts using axe-core, Pa11y, and Lighthouse. Support automated checks for ARIA patterns, keyboard navigation, focus management, color contrast, text alternatives, semantic HTML, form labels, skip links, responsive text sizing, and screen reader compatibility.
-
-## Trigger Phrases
-
-- "Write accessibility tests for [app/page]"
-- "Generate WCAG 2.2 compliance tests"
-- "Create axe-core tests for [framework]"
-- "Accessibility tests for keyboard navigation"
-- "ARIA and color contrast tests"
-- "Pa11y/Lighthouse accessibility audit setup"
-- "Screen reader compatibility tests"
-- "Accessibility test scripts from NFR analysis"
-
-## WCAG 2.2 Levels
-
-| Level | Description | Typical Use |
-|-------|--------------|-------------|
-| **A** | Minimum; required for basic accessibility | Legal baseline |
-| **AA** | Standard target; addresses major barriers | Most projects |
-| **AAA** | Enhanced; highest conformance | Specialized contexts |
-
-See `references/wcag-tests.md` for test scenarios per success criteria with code examples.
-
-## Tools
-
-| Tool | Purpose |
-|------|---------|
-| **axe-core** | Programmatic WCAG checks; integrates with Playwright, Cypress, Jest |
-| **Pa11y** | CLI + Node API; batch page audits, CI integration |
-| **Lighthouse** | Chrome DevTools Protocol; full accessibility audit with scores |
-
-## Test Categories
-
-| Category | Techniques | Tools |
-|----------|-------------|-------|
-| **ARIA patterns** | Roles, states, properties, live regions | axe-core |
-| **Keyboard navigation** | Tab order, focus traps, shortcuts | Playwright/Cypress |
-| **Focus management** | Visible focus, focus order, skip links | axe-core, custom |
-| **Color contrast** | 4.5:1 (normal), 3:1 (large) | axe-core, Lighthouse |
-| **Text alternatives** | Alt text, aria-label, captions | axe-core |
-| **Semantic HTML** | Headings, landmarks, lists | axe-core |
-| **Form labels** | Labels, error identification, autocomplete | axe-core, custom |
-| **Skip links** | Bypass blocks (2.4.1) | axe-core, custom |
-| **Responsive text sizing** | 200% resize, reflow | Lighthouse, custom |
-| **Screen reader compatibility** | Name, role, value (4.1.2) | axe-core, manual |
-
-## Workflow
-
-1. **Read NFR analysis** — From qa-nfr-analyst; extract WCAG criteria and target level (A/AA/AAA)
-2. **Map WCAG success criteria** — Align requirements to testable checkpoints (see `references/wcag-tests.md`)
-3. **Generate accessibility test scripts** — Playwright + @axe-core/playwright, Cypress + cypress-axe, Jest + jest-axe
-4. **Configure tools** — axe-core rules, Pa11y config, Lighthouse thresholds
-5. **Run audits** — Execute tests; produce audit reports and WCAG compliance matrix
-
-## Integration
-
-| Framework | Package | Usage |
-|-----------|---------|-------|
-| **Playwright** | @axe-core/playwright | `await expect(page).toPassAxe()` or `axe.run(page)` |
-| **Cypress** | cypress-axe | `cy.injectAxe(); cy.checkA11y()` |
-| **Jest** | jest-axe | `expect(container).toHaveNoViolations()` (React Testing Library) |
-
-See `references/axe-core-patterns.md` for integration patterns and examples.
-
-## Output
-
-- **Accessibility test scripts** — `tests/accessibility/` or `e2e/a11y/` with TS/JS files
-- **Audit reports** — JSON/HTML summaries of violations, impact, remediation
-- **WCAG compliance matrix** — Mapping of success criteria to pass/fail status
-
-## References
-
-- `references/wcag-tests.md` — WCAG 2.2 test scenarios per success criteria with code examples
-- `references/axe-core-patterns.md` — axe-core integration patterns for Playwright, Cypress, Jest
-- `references/best-practices.md` — Automated vs manual, screen reader testing, keyboard testing
-
-## Scope
-
-**Can do (autonomous):**
-- Generate accessibility test scripts from NFR analysis or WCAG criteria
-- Create axe-core/Pa11y/Lighthouse configurations
-- Write Playwright, Cypress, or Jest accessibility tests
-- Map WCAG 2.2 success criteria to test cases
-- Call qa-nfr-analyst for WCAG criteria when needed
-- Use qa-diagram-generator for accessibility flow diagrams
-
-**Cannot do (requires confirmation):**
-- Add dependencies not in package.json
-- Override project accessibility target level (A/AA/AAA)
-- Change WCAG conformance scope without approval
-
-**Will not do (out of scope):**
-- Execute tests (user runs them)
-- Perform manual screen reader testing (provide guidance only)
-- Implement accessibility fixes in application code
-
-## Quality Checklist
-
-- [ ] Tests cover WCAG 2.2 criteria relevant to the application
-- [ ] Target level (A/AA/AAA) specified and rules configured accordingly
-- [ ] axe-core rules/tags aligned with WCAG level (wcag2a, wcag2aa, wcag2aaa)
-- [ ] Keyboard navigation tests for interactive components
-- [ ] Focus visible and focus order verified where applicable
-- [ ] File naming follows `*.a11y.spec.ts` or `test_*_accessibility.ts`
-- [ ] References to WCAG success criterion IDs where applicable
-- [ ] Audit report includes impact, description, and remediation guidance
-
-## Troubleshooting
-
-| Symptom | Likely Cause | Fix |
-|---------|--------------|-----|
-| axe-core reports no violations but page is inaccessible | Dynamic content not loaded, shadow DOM | Wait for content; use `include` for shadow roots |
-| False positives (decorative images) | axe flags alt="" on img | Use `aria-hidden="true"` or `role="presentation"` for decorative |
-| Pa11y timeout | Slow page load, SPA | Increase timeout; wait for network idle |
-| Lighthouse score inconsistent | Network variance, animations | Run multiple times; use median; disable animations |
-| Keyboard test fails (focus not visible) | Custom focus styles missing | Add `:focus-visible` styles; verify in test |
-| cypress-axe "injectAxe" fails | Page not ready | Call `cy.injectAxe()` after `cy.visit` and content load |

package/skills/qa-accessibility-test-writer/references/axe-core-patterns.md

@@ -1,349 +0,0 @@
-# axe-core Integration Patterns
-
-Integration patterns for axe-core with Playwright, Cypress, and Jest. Use with qa-accessibility-test-writer when generating accessibility tests.
-
----
-
-## Playwright + @axe-core/playwright
-
-### Installation
-
-```bash
-npm install -D @axe-core/playwright
-```
-
-### Basic Usage
-
-```typescript
-import { test, expect } from '@playwright/test';
-import AxeBuilder from '@axe-core/playwright';
-
-test('page has no accessibility violations', async ({ page }) => {
-  await page.goto('/');
-  const results = await new AxeBuilder({ page }).analyze();
-
-  expect(results.violations).toEqual([]);
-});
-```
-
-### With WCAG Tags
-
-```typescript
-test('meets WCAG 2.2 AA', async ({ page }) => {
-  await page.goto('/dashboard');
-  const results = await new AxeBuilder({ page })
-    .withTags(['wcag2a', 'wcag2aa'])
-    .analyze();
-
-  expect(results.violations).toEqual([]);
-});
-```
-
-### Scoped to Selector
-
-```typescript
-test('main content is accessible', async ({ page }) => {
-  await page.goto('/');
-  const results = await new AxeBuilder({ page })
-    .include('main')
-    .exclude('.ad-banner')
-    .analyze();
-
-  expect(results.violations).toEqual([]);
-});
-```
-
-### Disable Specific Rules
-
-```typescript
-test('page accessible excluding color-contrast', async ({ page }) => {
-  await page.goto('/');
-  const results = await new AxeBuilder({ page })
-    .disableRules(['color-contrast'])
-    .analyze();
-
-  expect(results.violations).toEqual([]);
-});
-```
-
-### Shadow DOM
-
-```typescript
-test('component with shadow DOM', async ({ page }) => {
-  await page.goto('/web-components');
-  const results = await new AxeBuilder({ page })
-    .include(['#app', ['#shadow-host', '#shadow-root']])
-    .analyze();
-
-  expect(results.violations).toEqual([]);
-});
-```
-
-### Assert with toPassAxe (if available)
-
-```typescript
-import { expect } from '@playwright/test';
-import { toPassAxe } from 'axe-playwright';
-
-test.extend({ toPassAxe })('page passes axe', async ({ page, toPassAxe }) => {
-  await page.goto('/');
-  await expect(page).toPassAxe();
-});
-```
-
----
-
-## Cypress + cypress-axe
-
-### Installation
-
-```bash
-npm install -D cypress-axe axe-core
-```
-
-### Configuration (cypress/support/e2e.ts)
-
-```typescript
-import 'cypress-axe';
-```
-
-### Basic Usage
-
-```typescript
-describe('Accessibility', () => {
-  beforeEach(() => {
-    cy.visit('/');
-    cy.injectAxe();
-  });
-
-  it('has no violations', () => {
-    cy.checkA11y();
-  });
-
-  it('main content has no violations', () => {
-    cy.checkA11y('main');
-  });
-});
-```
-
-### With WCAG Tags
-
-```typescript
-it('meets WCAG 2.2 AA', () => {
-  cy.checkA11y(null, {
-    runOnly: {
-      type: 'tag',
-      values: ['wcag2a', 'wcag2aa'],
-    },
-  });
-});
-```
-
-### With Specific Rules
-
-```typescript
-it('checks critical rules only', () => {
-  cy.checkA11y(null, {
-    runOnly: {
-      type: 'rule',
-      values: ['color-contrast', 'label', 'button-name', 'image-alt'],
-    },
-  });
-});
-```
-
-### Exclude Elements
-
-```typescript
-it('excludes third-party widget', () => {
-  cy.checkA11y(null, {
-    exclude: [['.third-party-widget']],
-  });
-});
-```
-
-### Custom Violation Callback
-
-```typescript
-it('logs violations', () => {
-  cy.checkA11y(null, null, (violations) => {
-    violations.forEach((v) => {
-      cy.task('log', `${v.id}: ${v.help}`);
-    });
-  });
-});
-```
-
-### Wait for Dynamic Content
-
-```typescript
-it('checks after content loads', () => {
-  cy.get('[data-cy="dynamic-content"]').should('be.visible');
-  cy.injectAxe();
-  cy.checkA11y();
-});
-```
-
----
-
-## Jest + jest-axe
-
-### Installation
-
-```bash
-npm install -D jest-axe @testing-library/react @testing-library/dom
-```
-
-### Basic Usage (React Testing Library)
-
-```typescript
-import { render, screen } from '@testing-library/react';
-import { axe, toHaveNoViolations } from 'jest-axe';
-import { Button } from './Button';
-
-expect.extend(toHaveNoViolations);
-
-test('Button has no accessibility violations', async () => {
-  const { container } = render(<Button>Click me</Button>);
-  const results = await axe(container);
-  expect(results).toHaveNoViolations();
-});
-```
-
-### With Options
-
-```typescript
-test('Button meets WCAG AA', async () => {
-  const { container } = render(<Button>Click me</Button>);
-  const results = await axe(container, {
-    runOnly: {
-      type: 'tag',
-      values: ['wcag2a', 'wcag2aa'],
-    },
-  });
-  expect(results).toHaveNoViolations();
-});
-```
-
-### Scoped to Element
-
-```typescript
-test('form is accessible', async () => {
-  const { container } = render(<SignupForm />);
-  const form = container.querySelector('form');
-  const results = await axe(form!);
-  expect(results).toHaveNoViolations();
-});
-```
-
-### Disable Rules
-
-```typescript
-test('component without color-contrast check', async () => {
-  const { container } = render(<Chart />);
-  const results = await axe(container, {
-    rules: { 'color-contrast': { enabled: false } },
-  });
-  expect(results).toHaveNoViolations();
-});
-```
-
----
-
-## Pa11y (CLI + Node API)
-
-### CLI
-
-```bash
-npm install -g pa11y
-
-pa11y https://example.com
-pa11y https://example.com --standard WCAG2AA
-pa11y https://example.com --include-notices --include-warnings
-```
-
-### Node API
-
-```typescript
-import pa11y from 'pa11y';
-
-const results = await pa11y('https://example.com', {
-  standard: 'WCAG2AA',
-  includeWarnings: true,
-  runners: ['axe'],
-});
-
-console.log(results.issues);
-```
-
-### With Puppeteer (for SPAs)
-
-```typescript
-import pa11y from 'pa11y';
-import puppeteer from 'puppeteer';
-
-const browser = await puppeteer.launch();
-const page = await browser.newPage();
-await page.goto('https://example.com', { waitUntil: 'networkidle0' });
-
-const results = await pa11y(await page.content(), {
-  standard: 'WCAG2AA',
-  page,
-});
-
-await browser.close();
-```
-
----
-
-## Lighthouse (Chrome DevTools Protocol)
-
-### Playwright Integration
-
-```typescript
-import { test } from '@playwright/test';
-import { playAudit } from 'playwright-lighthouse';
-
-test('Lighthouse accessibility score', async ({ page }) => {
-  await page.goto('/');
-  await playAudit({
-    page,
-    thresholds: {
-      performance: 80,
-      accessibility: 90,
-      'best-practices': 80,
-      seo: 80,
-    },
-    port: 9222,
-  });
-});
-```
-
-### Lighthouse CLI
-
-```bash
-npx lighthouse https://example.com --only-categories=accessibility --output=json
-```
-
----
-
-## Rule Tags Reference
-
-| Tag | Description |
-|-----|-------------|
-| `wcag2a` | WCAG 2.2 Level A |
-| `wcag2aa` | WCAG 2.2 Level AA |
-| `wcag2aaa` | WCAG 2.2 Level AAA |
-| `best-practice` | Best practice recommendations |
-| `ACT` | W3C ACT rules |
-| `section508` | Section 508 |
-
----
-
-## References
-
-- [axe-core GitHub](https://github.com/dequelabs/axe-core)
-- [@axe-core/playwright](https://github.com/dequelabs/axe-core-npm/tree/develop/packages/playwright)
-- [cypress-axe](https://github.com/component-driven/cypress-axe)
-- [jest-axe](https://github.com/nickcolley/jest-axe)
-- [Pa11y](https://pa11y.org/)