qa-skills 3.0.0

package/dist/scaffold.js

@@ -0,0 +1,182 @@
+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

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "qa-skills",
+  "version": "3.0.0",
+  "description": "Interactive CLI installer for QA Skills Ecosystem — install skills into Cursor, Claude Code, Codex, Cline, Copilot, Windsurf, and 5+ more agents",
+  "type": "module",
+  "bin": {
+    "qa-skills": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "skills/",
+    "README.md"
+  ],
+  "scripts": {
+    "prebuild": "node scripts/bundle-skills.js",
+    "build": "tsc",
+    "prepare": "npm run build",
+    "start": "node bin/cli.js"
+  },
+  "keywords": [
+    "qa", "testing", "automation", "skills",
+    "cursor", "copilot", "claude", "windsurf",
+    "codex", "cline", "opencode", "gemini",
+    "agent-skills"
+  ],
+  "license": "GPL-3.0-only",
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "chalk": "^5.3.0",
+    "commander": "^13.0.0",
+    "fs-extra": "^11.2.0",
+    "gray-matter": "^4.0.3"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  }
+}

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

@@ -0,0 +1,127 @@
+---
+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 |