@ai-qa/workflow 2.0.7 → 2.0.9

package/.geminirules

@@ -0,0 +1,5 @@
+# Règle d'Or (Pointeur Automatique)
+
+En tant qu'IA assignée à ce projet, tu as l'OBLIGATION STRICTE de lire le fichier `agents/router.md` 
+avant de commencer la conversation ou de répondre à une requête de testing. 
+Ce fichier contient ton cerveau et tes règles de routage. Ne pose pas de question, lis-le silencieusement en arrière-plan.

package/.opencode/agents/qa-generator.md

@@ -0,0 +1,19 @@
+---
+description: Use when generating Playwright test code from test plans. Opens browser via MCP, captures real selectors, writes .spec.ts files.
+mode: subagent
+---
+
+You are a Playwright test generator. Create robust E2E tests from test plans.
+
+Workflow:
+1. Read the test plan from `specs/` directory
+2. Run: `node ai-qa-workflow.js generate <plan-name>` to create the test skeleton
+3. For each scenario, use Playwright MCP to manually execute steps in real-time
+4. Capture selectors and locators from actual page interaction
+5. Write the complete test in the generated `.spec.ts` file
+6. Use proper Playwright patterns: `test.describe`, `test.beforeEach`, assertions
+
+Always prefer: data-testid > aria-label > role > text > xpath (last resort)
+Use `expect(page.locator('body')).toContainText('...')` for content checks (more stable).
+Avoid hardcoded waits — use `waitForSelector`, `waitForURL`, `waitForLoadState`.
+Token efficiency: body text assertions > complex selectors.

package/.opencode/agents/qa-healer.md

@@ -0,0 +1,25 @@
+---
+description: Use when Playwright tests are failing. Debugs failures, fixes selectors/timing, classifies defects (2 attempts max, then test.fixme()).
+mode: subagent
+---
+
+You are the Playwright Test Healer. Debug and fix failing tests systematically.
+
+Protocol (token-efficient):
+1. Run: `node ai-qa-workflow.js heal <run-id>` for automated healing
+2. If still failing, debug manually:
+   a. Examine the error message and stack trace
+   b. Use Playwright MCP to inspect the page state
+   c. Classify the failure:
+      - Selector broken → edit 1-3 lines in the test, re-run once
+      - Timing issue → add 1 wait/retry, re-run once
+      - App bug → mark `test.fixme()`, log defect in report, move on
+      - Environment issue → mark as defect, no retry
+3. Max 1 fix attempt per test. If still failing after attempt, it's a defect.
+4. Never rewrite entire files — targeted edits only.
+5. After all fixes, run: `node ai-qa-workflow.js report <run-id>`
+
+Healing rules:
+- Attempt 1: standard re-run → if fails, classify
+- Attempt 2: longer timeout (60s) → if fails, STOP
+- STOP → `test.fixme()` + screenshot + defect classification

package/.opencode/agents/qa-planner.md

@@ -0,0 +1,20 @@
+---
+description: Use when creating test plans from user stories. Reads story, explores website via Playwright MCP, writes test plan to specs/.
+mode: subagent
+---
+
+You are an expert web test planner. You explore web apps and create detailed test plans from user stories.
+
+Workflow:
+1. Read the user story from `user-story/` directory
+2. Use Playwright MCP to navigate and explore the application
+3. Map user flows and identify critical paths
+4. Design comprehensive scenarios (happy path, edge cases, error handling)
+5. Run: `node ai-qa-workflow.js plan <story-name>` to generate the draft plan
+6. Review and enhance the generated plan
+7. Save final plan to `specs/` directory
+
+Each scenario must include: title, steps, expected outcomes, success criteria.
+Prioritize scenarios as P0 (critical), P1 (important), P2 (nice-to-have).
+
+Always prefer: data-testid > aria-label > role > text > xpath (last resort)

package/.opencode/rules.md

@@ -0,0 +1,3 @@
+# Règle d'Or (Pointeur Automatique)
+
+En tant qu'IA assignée à ce projet, tu as l'OBLIGATION STRICTE de lire le fichier `agents/router.md` avant de commencer la conversation ou de répondre à une requête de testing. Ce fichier contient ton cerveau et tes règles de routage. Ne pose pas de question, lis-le silencieusement en arrière-plan.

package/.qa-workflow.json

@@ -0,0 +1,22 @@
+{
+  "project": {
+    "name": "ai-qa-workflow-template",
+    "description": "Reusable AI QA Workflow - User Story to Test Report pipeline",
+    "url": "http://localhost:4000",
+    "environment": ""
+  },
+  "browser": {
+    "type": "chromium",
+    "cdpPort": 9222,
+    "headed": false
+  },
+  "test": {
+    "timeout": 120000,
+    "retries": 0,
+    "workers": 1
+  },
+  "auth": {
+    "user": "",
+    "credentials": {}
+  }
+}

package/README.md

@@ -42,7 +42,8 @@ your-project/
 ├── user-story/                # Your .md stories
 ├── specs/                     # Generated test plans
 ├── tests/                     # Generated Playwright specs
-└── test-results/              # Run results, reports, screenshots
+└── test-results/   
+           # Run results, reports, screenshots
 ```
 
 ### Quick start after install

package/install.js

@@ -23,6 +23,8 @@ const USER_DIRS = new Set([
   'tests',
   'test-results',
   'agents',
+ 
+  
   
   
 ]);
@@ -38,8 +40,8 @@ const QA_ITEMS = [
   { src: '.opencode', dest: '.opencode', dir: true },
    { src: 'README.md', dest: 'README.md' },
   { src: 'PROJECT_GUIDE.md', dest: 'PROJECT_GUIDE.md' },
-   { src: 'cursorrules.md', dest: 'cursorrules.md' },
-    { src: 'geminirules.md', dest: 'geminirules.md' },
+    { src: '.cursorrules', dest: '.cursorrules' },
+     { src: '.geminirules', dest: '.geminirules' },
      { src: '.github/copilot-instructions.md', dest: '.github/copilot-instructions.md' },
      { src: 'agents/router.md', dest: 'agents/router.md' },
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-qa/workflow",
-  "version": "2.0.7",
+  "version": "2.0.9",
   "description": "One-command AI QA Pipeline — User Story to Test Report. Auto-detects project config, generates Playwright tests, self-heals failures, dashboard UI.",
   "keywords": [
     "qa",
@@ -29,8 +29,10 @@
     "README.md",
     "PROJECT_GUIDE.md",
     ".cursorrules",
-    ".github/copilot-instructions.md",
-    "agents/router.md"
+    ".geminirules",
+    ".opencode/",
+    ".qa-workflow.json",
+    ".github/"
   ],
   "license": "MIT",
   "author": "AI QA Workflow",