feat(qa): add Playwright MCP test agents & config

Introduces Playwright testing agents (planner, generator, healer) powered by MCP to plan, generate, and heal end-to-end tests.

Configures the MCP server and integrates agent workflows into OpenCode and GitHub chat modes to enable AI-assisted testing.

Adds Playwright test dependency and updates lockfile; adjusts markdown lint ignores to reduce noise.

Adds contributor guidance for Claude Code to streamline local development.

Normalizes shell script shebangs to use /usr/bin/env bash for portability.

Enables automated browser testing workflows and resilient test maintenance within AI-enabled tooling.

opencode.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "playwright-test": {
+      "type": "local",
+      "command": ["npx", "playwright", "run-test-mcp-server"],
+      "enabled": true
+    }
+  },
+  "tools": {
+    "playwright*": false
+  },
+  "agent": {
+    "playwright-test-generator": {
+      "description": "Use this agent when you need to create automated browser tests using Playwright",
+      "mode": "subagent",
+      "prompt": "{file:.opencode/prompts/playwright-test-generator.md}",
+      "tools": {
+        "ls": true,
+        "glob": true,
+        "grep": true,
+        "read": true,
+        "playwright-test*browser_click": true,
+        "playwright-test*browser_drag": true,
+        "playwright-test*browser_evaluate": true,
+        "playwright-test*browser_file_upload": true,
+        "playwright-test*browser_handle_dialog": true,
+        "playwright-test*browser_hover": true,
+        "playwright-test*browser_navigate": true,
+        "playwright-test*browser_press_key": true,
+        "playwright-test*browser_select_option": true,
+        "playwright-test*browser_snapshot": true,
+        "playwright-test*browser_type": true,
+        "playwright-test*browser_verify_element_visible": true,
+        "playwright-test*browser_verify_list_visible": true,
+        "playwright-test*browser_verify_text_visible": true,
+        "playwright-test*browser_verify_value": true,
+        "playwright-test*browser_wait_for": true,
+        "playwright-test*generator_read_log": true,
+        "playwright-test*generator_setup_page": true,
+        "playwright-test*generator_write_test": true
+      }
+    },
+    "playwright-test-healer": {
+      "description": "Use this agent when you need to debug and fix failing Playwright tests",
+      "mode": "subagent",
+      "prompt": "{file:.opencode/prompts/playwright-test-healer.md}",
+      "tools": {
+        "ls": true,
+        "glob": true,
+        "grep": true,
+        "read": true,
+        "write": true,
+        "edit": true,
+        "playwright-test*browser_console_messages": true,
+        "playwright-test*browser_evaluate": true,
+        "playwright-test*browser_generate_locator": true,
+        "playwright-test*browser_network_requests": true,
+        "playwright-test*browser_snapshot": true,
+        "playwright-test*test_debug": true,
+        "playwright-test*test_list": true,
+        "playwright-test*test_run": true
+      }
+    },
+    "playwright-test-planner": {
+      "description": "Use this agent when you need to create comprehensive test plan for a web application or website",
+      "mode": "subagent",
+      "prompt": "{file:.opencode/prompts/playwright-test-planner.md}",
+      "tools": {
+        "ls": true,
+        "glob": true,
+        "grep": true,
+        "read": true,
+        "write": true,
+        "playwright-test*browser_click": true,
+        "playwright-test*browser_close": true,
+        "playwright-test*browser_console_messages": true,
+        "playwright-test*browser_drag": true,
+        "playwright-test*browser_evaluate": true,
+        "playwright-test*browser_file_upload": true,
+        "playwright-test*browser_handle_dialog": true,
+        "playwright-test*browser_hover": true,
+        "playwright-test*browser_navigate": true,
+        "playwright-test*browser_navigate_back": true,
+        "playwright-test*browser_network_requests": true,
+        "playwright-test*browser_press_key": true,
+        "playwright-test*browser_select_option": true,
+        "playwright-test*browser_snapshot": true,
+        "playwright-test*browser_take_screenshot": true,
+        "playwright-test*browser_type": true,
+        "playwright-test*browser_wait_for": true,
+        "playwright-test*planner_setup_page": true
+      }
+    }
+  }
+}