qaa-agent 1.9.1 → 1.9.5

package/frameworks/pytest.json

@@ -0,0 +1,59 @@
+{
+  "name": "pytest",
+  "display_name": "pytest",
+  "languages": [
+    "python"
+  ],
+  "extensions": [
+    ".py"
+  ],
+  "detection": {
+    "manifest_files": [
+      "requirements.txt",
+      "pyproject.toml",
+      "setup.py",
+      "Pipfile"
+    ],
+    "manifest_grep": "pytest",
+    "config_files": [
+      "pytest.ini",
+      "pyproject.toml",
+      "conftest.py",
+      "setup.cfg"
+    ],
+    "file_patterns": [
+      "tests/**/test_*.py",
+      "tests/**/*_test.py",
+      "test/**/test_*.py"
+    ]
+  },
+  "validation_commands": {
+    "syntax_check": "python -m py_compile {file}",
+    "dry_run": "pytest --collect-only",
+    "lint": "ruff check {file}"
+  },
+  "conventions": {
+    "test_dirs": [
+      "tests/",
+      "test/"
+    ],
+    "pom_dirs": [
+      "tests/page_objects/",
+      "tests/pages/"
+    ],
+    "fixture_dirs": [
+      "tests/fixtures/",
+      "tests/conftest.py"
+    ],
+    "config_filename": "pytest.ini"
+  },
+  "context7_keys": [
+    "pytest",
+    "pytest-dev"
+  ],
+  "test_kinds": [
+    "unit",
+    "integration",
+    "api"
+  ]
+}

package/frameworks/robot-framework.json

@@ -0,0 +1,54 @@
+{
+  "name": "robot-framework",
+  "display_name": "Robot Framework",
+  "languages": [
+    "python",
+    "robot"
+  ],
+  "extensions": [
+    ".robot",
+    ".resource"
+  ],
+  "detection": {
+    "manifest_files": [
+      "requirements.txt",
+      "pyproject.toml"
+    ],
+    "manifest_grep": "robotframework|robotframework-browser",
+    "config_files": [],
+    "file_patterns": [
+      "tests/**/*.robot",
+      "**/*.robot"
+    ]
+  },
+  "validation_commands": {
+    "syntax_check": "robot --dryrun {file}",
+    "dry_run": "robot --dryrun {test_dir}",
+    "lint": "robocop {file}"
+  },
+  "conventions": {
+    "test_dirs": [
+      "tests/",
+      "tests/e2e/",
+      "robot_tests/"
+    ],
+    "pom_dirs": [
+      "resources/pages/",
+      "pages/"
+    ],
+    "fixture_dirs": [
+      "resources/data/",
+      "resources/"
+    ],
+    "config_filename": null
+  },
+  "context7_keys": [
+    "robotframework",
+    "robotframework-browser",
+    "MarketSquare/robotframework"
+  ],
+  "test_kinds": [
+    "e2e",
+    "api"
+  ]
+}

package/frameworks/selenium.json

@@ -0,0 +1,65 @@
+{
+  "name": "selenium",
+  "display_name": "Selenium",
+  "languages": [
+    "typescript",
+    "javascript",
+    "python",
+    "java",
+    "csharp"
+  ],
+  "extensions": [
+    ".spec.ts",
+    ".spec.js",
+    ".py",
+    ".java",
+    ".cs"
+  ],
+  "detection": {
+    "manifest_files": [
+      "package.json",
+      "requirements.txt",
+      "pom.xml",
+      "build.gradle"
+    ],
+    "manifest_grep": "selenium-webdriver|selenium|Selenium\\.WebDriver",
+    "config_files": [],
+    "file_patterns": [
+      "tests/**/*selenium*",
+      "src/test/**/*.java"
+    ]
+  },
+  "validation_commands": {
+    "syntax_check_ts": "tsc --noEmit",
+    "syntax_check_js": "node --check {file}",
+    "syntax_check_py": "python -m py_compile {file}",
+    "dry_run": null,
+    "lint": null
+  },
+  "conventions": {
+    "test_dirs": [
+      "tests/",
+      "src/test/",
+      "src/test/java/"
+    ],
+    "pom_dirs": [
+      "pages/",
+      "src/test/java/pages/",
+      "tests/pages/"
+    ],
+    "fixture_dirs": [
+      "fixtures/",
+      "src/test/resources/"
+    ],
+    "config_filename": null
+  },
+  "context7_keys": [
+    "selenium",
+    "selenium-webdriver",
+    "SeleniumHQ"
+  ],
+  "test_kinds": [
+    "e2e",
+    "integration"
+  ]
+}

package/frameworks/vitest.json

@@ -0,0 +1,57 @@
+{
+  "name": "vitest",
+  "display_name": "Vitest",
+  "languages": [
+    "typescript",
+    "javascript"
+  ],
+  "extensions": [
+    ".test.ts",
+    ".test.js",
+    ".spec.ts",
+    ".spec.js"
+  ],
+  "detection": {
+    "manifest_files": [
+      "package.json"
+    ],
+    "manifest_grep": "\"vitest\"",
+    "config_files": [
+      "vitest.config.ts",
+      "vitest.config.js",
+      "vite.config.ts"
+    ],
+    "file_patterns": [
+      "**/*.test.ts",
+      "**/*.spec.ts",
+      "tests/**/*"
+    ]
+  },
+  "validation_commands": {
+    "syntax_check_ts": "tsc --noEmit",
+    "syntax_check_js": "node --check {file}",
+    "dry_run": "vitest --list",
+    "lint": "eslint {file}"
+  },
+  "conventions": {
+    "test_dirs": [
+      "tests/",
+      "src/__tests__/",
+      "test/"
+    ],
+    "pom_dirs": [],
+    "fixture_dirs": [
+      "tests/fixtures/",
+      "test/fixtures/"
+    ],
+    "config_filename": "vitest.config.ts"
+  },
+  "context7_keys": [
+    "vitest",
+    "vitest-dev"
+  ],
+  "test_kinds": [
+    "unit",
+    "integration"
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qaa-agent",
-  "version": "1.9.1",
+  "version": "1.9.5",
   "description": "QA Automation Agent for Claude Code — multi-agent pipeline that analyzes repos, generates tests, validates, and creates PRs",
   "bin": {
     "qaa-agent": "./bin/install.cjs"
@@ -26,12 +26,16 @@
     "agents/",
     "workflows/",
     "templates/",
-    "docs/",
+    "docs/COMMANDS.md",
+    "docs/DEMO.md",
+    "docs/TESTING.md",
     "commands/",
     "skills/",
+    "frameworks/",
     "settings.json",
     ".mcp.json",
     "CLAUDE.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "VERSION"
   ]
 }

package/workflows/qa-analyze.md

@@ -90,8 +90,32 @@ Spawn the scanner agent to produce SCAN_MANIFEST.md.
 ```
 Task(
   prompt="
+    <critical_directive priority="MANDATORY">
+    You are executing as a QAA pipeline agent. Your FIRST action MUST be to read
+    ~/.claude/qaa/agents/qaa-scanner.md and adopt it as your operating contract.
+
+    Even though you may be running as a general-purpose agent (native subagent type
+    routing for QAA agents is not yet enabled), you MUST behave exactly as the
+    dedicated agent defined in that file: read everything in its <required_reading>,
+    obey its <quality_gate>, and run its mandatory bash checklist before returning.
+
+    Never modify application source code (src/, app/, lib/, or equivalent
+    directories) unless the agent's <scope> section explicitly permits it. If the
+    agent's contract restricts what files it can touch, honor that restriction —
+    even if a fix seems obvious or trivial.
+
+    If you cannot read ~/.claude/qaa/agents/qaa-scanner.md (file missing, corrupted, parse
+    error), STOP and report the failure. Do NOT proceed with default agent
+    behavior — that defeats the purpose of this directive.
+
+    Do NOT improvise, substitute steps, apply changes the agent isn't allowed to
+    make, or skip any of the above. Skipping the agent's required_reading,
+    quality_gate, or bash checklist makes the run INVALID — its output cannot be
+    trusted.
+    </critical_directive>
+
     <objective>Scan repository and produce SCAN_MANIFEST.md</objective>
-    <execution_context>@agents/qaa-scanner.md</execution_context>
+    <execution_context>~/.claude/qaa/agents/qaa-scanner.md</execution_context>
     <files_to_read>
     - CLAUDE.md
     </files_to_read>
@@ -109,8 +133,32 @@ Task(
 ```
 Task(
   prompt="
+    <critical_directive priority="MANDATORY">
+    You are executing as a QAA pipeline agent. Your FIRST action MUST be to read
+    ~/.claude/qaa/agents/qaa-scanner.md and adopt it as your operating contract.
+
+    Even though you may be running as a general-purpose agent (native subagent type
+    routing for QAA agents is not yet enabled), you MUST behave exactly as the
+    dedicated agent defined in that file: read everything in its <required_reading>,
+    obey its <quality_gate>, and run its mandatory bash checklist before returning.
+
+    Never modify application source code (src/, app/, lib/, or equivalent
+    directories) unless the agent's <scope> section explicitly permits it. If the
+    agent's contract restricts what files it can touch, honor that restriction —
+    even if a fix seems obvious or trivial.
+
+    If you cannot read ~/.claude/qaa/agents/qaa-scanner.md (file missing, corrupted, parse
+    error), STOP and report the failure. Do NOT proceed with default agent
+    behavior — that defeats the purpose of this directive.
+
+    Do NOT improvise, substitute steps, apply changes the agent isn't allowed to
+    make, or skip any of the above. Skipping the agent's required_reading,
+    quality_gate, or bash checklist makes the run INVALID — its output cannot be
+    trusted.
+    </critical_directive>
+
     <objective>Scan both developer and QA repositories and produce SCAN_MANIFEST.md</objective>
-    <execution_context>@agents/qaa-scanner.md</execution_context>
+    <execution_context>~/.claude/qaa/agents/qaa-scanner.md</execution_context>
     <files_to_read>
     - CLAUDE.md
     </files_to_read>
@@ -148,8 +196,32 @@ Spawn the analyzer agent to produce analysis artifacts.
 ```
 Task(
   prompt="
+    <critical_directive priority="MANDATORY">
+    You are executing as a QAA pipeline agent. Your FIRST action MUST be to read
+    ~/.claude/qaa/agents/qaa-analyzer.md and adopt it as your operating contract.
+
+    Even though you may be running as a general-purpose agent (native subagent type
+    routing for QAA agents is not yet enabled), you MUST behave exactly as the
+    dedicated agent defined in that file: read everything in its <required_reading>,
+    obey its <quality_gate>, and run its mandatory bash checklist before returning.
+
+    Never modify application source code (src/, app/, lib/, or equivalent
+    directories) unless the agent's <scope> section explicitly permits it. If the
+    agent's contract restricts what files it can touch, honor that restriction —
+    even if a fix seems obvious or trivial.
+
+    If you cannot read ~/.claude/qaa/agents/qaa-analyzer.md (file missing, corrupted, parse
+    error), STOP and report the failure. Do NOT proceed with default agent
+    behavior — that defeats the purpose of this directive.
+
+    Do NOT improvise, substitute steps, apply changes the agent isn't allowed to
+    make, or skip any of the above. Skipping the agent's required_reading,
+    quality_gate, or bash checklist makes the run INVALID — its output cannot be
+    trusted.
+    </critical_directive>
+
     <objective>Analyze scanned repository and produce QA_ANALYSIS.md, TEST_INVENTORY.md, and QA_REPO_BLUEPRINT.md</objective>
-    <execution_context>@agents/qaa-analyzer.md</execution_context>
+    <execution_context>~/.claude/qaa/agents/qaa-analyzer.md</execution_context>
     <files_to_read>
     - {OUTPUT_DIR}/SCAN_MANIFEST.md
     - CLAUDE.md
@@ -169,8 +241,32 @@ Task(
 ```
 Task(
   prompt="
+    <critical_directive priority="MANDATORY">
+    You are executing as a QAA pipeline agent. Your FIRST action MUST be to read
+    ~/.claude/qaa/agents/qaa-analyzer.md and adopt it as your operating contract.
+
+    Even though you may be running as a general-purpose agent (native subagent type
+    routing for QAA agents is not yet enabled), you MUST behave exactly as the
+    dedicated agent defined in that file: read everything in its <required_reading>,
+    obey its <quality_gate>, and run its mandatory bash checklist before returning.
+
+    Never modify application source code (src/, app/, lib/, or equivalent
+    directories) unless the agent's <scope> section explicitly permits it. If the
+    agent's contract restricts what files it can touch, honor that restriction —
+    even if a fix seems obvious or trivial.
+
+    If you cannot read ~/.claude/qaa/agents/qaa-analyzer.md (file missing, corrupted, parse
+    error), STOP and report the failure. Do NOT proceed with default agent
+    behavior — that defeats the purpose of this directive.
+
+    Do NOT improvise, substitute steps, apply changes the agent isn't allowed to
+    make, or skip any of the above. Skipping the agent's required_reading,
+    quality_gate, or bash checklist makes the run INVALID — its output cannot be
+    trusted.
+    </critical_directive>
+
     <objective>Analyze scanned repositories and produce QA_ANALYSIS.md, TEST_INVENTORY.md, and GAP_ANALYSIS.md</objective>
-    <execution_context>@agents/qaa-analyzer.md</execution_context>
+    <execution_context>~/.claude/qaa/agents/qaa-analyzer.md</execution_context>
     <files_to_read>
     - {OUTPUT_DIR}/SCAN_MANIFEST.md
     - CLAUDE.md

package/workflows/qa-from-ticket.md

@@ -417,8 +417,32 @@ Write to `{OUTPUT_DIR}/GENERATION_PLAN_TICKET.md`.
 ```
 Task(
   prompt="
+    <critical_directive priority="MANDATORY">
+    You are executing as a QAA pipeline agent. Your FIRST action MUST be to read
+    ~/.claude/qaa/agents/qaa-executor.md and adopt it as your operating contract.
+
+    Even though you may be running as a general-purpose agent (native subagent type
+    routing for QAA agents is not yet enabled), you MUST behave exactly as the
+    dedicated agent defined in that file: read everything in its <required_reading>,
+    obey its <quality_gate>, and run its mandatory bash checklist before returning.
+
+    Never modify application source code (src/, app/, lib/, or equivalent
+    directories) unless the agent's <scope> section explicitly permits it. If the
+    agent's contract restricts what files it can touch, honor that restriction —
+    even if a fix seems obvious or trivial.
+
+    If you cannot read ~/.claude/qaa/agents/qaa-executor.md (file missing, corrupted, parse
+    error), STOP and report the failure. Do NOT proceed with default agent
+    behavior — that defeats the purpose of this directive.
+
+    Do NOT improvise, substitute steps, apply changes the agent isn't allowed to
+    make, or skip any of the above. Skipping the agent's required_reading,
+    quality_gate, or bash checklist makes the run INVALID — its output cannot be
+    trusted.
+    </critical_directive>
+
     <objective>Generate test files from ticket-derived test cases</objective>
-    <execution_context>@agents/qaa-executor.md</execution_context>
+    <execution_context>~/.claude/qaa/agents/qaa-executor.md</execution_context>
     <files_to_read>
     - {OUTPUT_DIR}/GENERATION_PLAN_TICKET.md
     - {OUTPUT_DIR}/TEST_CASES_FROM_TICKET.md
@@ -445,8 +469,32 @@ Validate the generated test files against CLAUDE.md standards.
 ```
 Task(
   prompt="
+    <critical_directive priority="MANDATORY">
+    You are executing as a QAA pipeline agent. Your FIRST action MUST be to read
+    ~/.claude/qaa/agents/qaa-validator.md and adopt it as your operating contract.
+
+    Even though you may be running as a general-purpose agent (native subagent type
+    routing for QAA agents is not yet enabled), you MUST behave exactly as the
+    dedicated agent defined in that file: read everything in its <required_reading>,
+    obey its <quality_gate>, and run its mandatory bash checklist before returning.
+
+    Never modify application source code (src/, app/, lib/, or equivalent
+    directories) unless the agent's <scope> section explicitly permits it. If the
+    agent's contract restricts what files it can touch, honor that restriction —
+    even if a fix seems obvious or trivial.
+
+    If you cannot read ~/.claude/qaa/agents/qaa-validator.md (file missing, corrupted, parse
+    error), STOP and report the failure. Do NOT proceed with default agent
+    behavior — that defeats the purpose of this directive.
+
+    Do NOT improvise, substitute steps, apply changes the agent isn't allowed to
+    make, or skip any of the above. Skipping the agent's required_reading,
+    quality_gate, or bash checklist makes the run INVALID — its output cannot be
+    trusted.
+    </critical_directive>
+
     <objective>Validate generated test files across 4 layers</objective>
-    <execution_context>@agents/qaa-validator.md</execution_context>
+    <execution_context>~/.claude/qaa/agents/qaa-validator.md</execution_context>
     <files_to_read>
     - CLAUDE.md
     - {OUTPUT_DIR}/GENERATION_PLAN_TICKET.md

package/workflows/qa-gap.md

@@ -92,8 +92,32 @@ Spawn the scanner agent to scan both the developer and QA repositories, producin
 ```
 Task(
   prompt="
+    <critical_directive priority="MANDATORY">
+    You are executing as a QAA pipeline agent. Your FIRST action MUST be to read
+    ~/.claude/qaa/agents/qaa-scanner.md and adopt it as your operating contract.
+
+    Even though you may be running as a general-purpose agent (native subagent type
+    routing for QAA agents is not yet enabled), you MUST behave exactly as the
+    dedicated agent defined in that file: read everything in its <required_reading>,
+    obey its <quality_gate>, and run its mandatory bash checklist before returning.
+
+    Never modify application source code (src/, app/, lib/, or equivalent
+    directories) unless the agent's <scope> section explicitly permits it. If the
+    agent's contract restricts what files it can touch, honor that restriction —
+    even if a fix seems obvious or trivial.
+
+    If you cannot read ~/.claude/qaa/agents/qaa-scanner.md (file missing, corrupted, parse
+    error), STOP and report the failure. Do NOT proceed with default agent
+    behavior — that defeats the purpose of this directive.
+
+    Do NOT improvise, substitute steps, apply changes the agent isn't allowed to
+    make, or skip any of the above. Skipping the agent's required_reading,
+    quality_gate, or bash checklist makes the run INVALID — its output cannot be
+    trusted.
+    </critical_directive>
+
     <objective>Scan both developer and QA repositories and produce SCAN_MANIFEST.md with combined file trees</objective>
-    <execution_context>@agents/qaa-scanner.md</execution_context>
+    <execution_context>~/.claude/qaa/agents/qaa-scanner.md</execution_context>
     <files_to_read>
     - CLAUDE.md
     </files_to_read>
@@ -129,8 +153,32 @@ Spawn the analyzer agent in gap analysis mode to compare dev repo testable surfa
 ```
 Task(
   prompt="
+    <critical_directive priority="MANDATORY">
+    You are executing as a QAA pipeline agent. Your FIRST action MUST be to read
+    ~/.claude/qaa/agents/qaa-analyzer.md and adopt it as your operating contract.
+
+    Even though you may be running as a general-purpose agent (native subagent type
+    routing for QAA agents is not yet enabled), you MUST behave exactly as the
+    dedicated agent defined in that file: read everything in its <required_reading>,
+    obey its <quality_gate>, and run its mandatory bash checklist before returning.
+
+    Never modify application source code (src/, app/, lib/, or equivalent
+    directories) unless the agent's <scope> section explicitly permits it. If the
+    agent's contract restricts what files it can touch, honor that restriction —
+    even if a fix seems obvious or trivial.
+
+    If you cannot read ~/.claude/qaa/agents/qaa-analyzer.md (file missing, corrupted, parse
+    error), STOP and report the failure. Do NOT proceed with default agent
+    behavior — that defeats the purpose of this directive.
+
+    Do NOT improvise, substitute steps, apply changes the agent isn't allowed to
+    make, or skip any of the above. Skipping the agent's required_reading,
+    quality_gate, or bash checklist makes the run INVALID — its output cannot be
+    trusted.
+    </critical_directive>
+
     <objective>Perform gap analysis comparing dev repo testable surfaces against QA repo test coverage. Use codebase map for deep context and locator registry for frontend coverage assessment. Produce QA_ANALYSIS.md, TEST_INVENTORY.md, and GAP_ANALYSIS.md.</objective>
-    <execution_context>@agents/qaa-analyzer.md</execution_context>
+    <execution_context>~/.claude/qaa/agents/qaa-analyzer.md</execution_context>
     <files_to_read>
     - {OUTPUT_DIR}/SCAN_MANIFEST.md
     - CLAUDE.md