playwright-test-agent 0.2.2 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playwright-test-agent",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Initialize Playwright Test agents with a Playwright CLI-first browser workflow.",
   "type": "module",
   "bin": {

package/playwright-test-agent/SKILL.md

@@ -5,7 +5,7 @@ description: Use first when a user asks to investigate or test a website, browse
 
 # Playwright Test Agent
 
-Use Planner -> Generator -> Healer for durable tests. `AGENTS.md` or `CLAUDE.md` defines the platform-specific role routing. The role that owns the current phase uses `playwright-cli`; the parent does not perform another role's browser work.
+Use Planner -> Generator -> execute -> Healer (only on failure) for durable tests. Follow the platform routing defined by the project's `AGENTS.md` or `CLAUDE.md`. Each role owns its assigned browser interaction and artifacts; the orchestrating agent performs the documented handoffs and required test-suite execution.
 
 ## Required phase handoff
 
@@ -17,7 +17,7 @@ Use Planner -> Generator -> Healer for durable tests. `AGENTS.md` or `CLAUDE.md`
 
 Every phase is required in that order. Planner exploration without a saved plan is incomplete. Generator output without test files is incomplete. Generated test files that have not been executed are not a successful test result. Healer must never start before a real generated-test failure exists.
 
-On Claude Code, the parent must start `playwright-test-planner`; only that Planner may open the website. The parent must not call `playwright-cli`, Chrome DevTools, browser MCP tools, or another browser integration. On Codex, the main agent does not spawn a Playwright subagent; it explicitly assumes one phase at a time, and may call CLI only while acting in that phase. Preserve the official Playwright Test MCP configuration and role tools; CLI is the preferred live-browser path and prevents missing MCP tools from blocking the workflow.
+Preserve the official Playwright Test MCP configuration and role tools. Use `playwright-cli` as the preferred live-browser path when the role instructions select it; missing optional MCP tools must not block a role when the CLI can perform the same work.
 
 Before Planner, the parent may read relevant local project information to understand routes, requirements, fixtures, and constraints. It may ask for information that is necessary or could materially change the test purpose, scope, assertions, access, or safety, such as the deployed URL, account or role, expected behavior, target environment, allowed data mutations, and authorization boundary. Keep this preparation focused: do not locate a seed file or turn config, test-directory, agent-definition, fixture, or generated-file discovery into a prerequisite.
 
@@ -61,4 +61,4 @@ Run from the target project:
 npx playwright-test-agent init
 ```
 
-The command globally installs `@playwright/cli`, installs its Codex/Claude skills and browser, initializes Playwright Test agents, and reinjects CLI-first instructions into all six generated role definitions. Run it again after Playwright updates regenerate those definitions. Restart Codex or Claude Code after initialization so global skills and changed definitions are reloaded.
+The command globally installs `@playwright/cli`, installs the Playwright CLI skills and browser, initializes Playwright Test agents, and reinjects CLI-first instructions into all generated role definitions. Run it again after Playwright updates regenerate those definitions. Restart the host agent after initialization so global skills and changed definitions are reloaded.

package/playwright-test-agent/scripts/init-playwright.mjs

@@ -27,11 +27,11 @@ Codex routing is mandatory for website, browser workflow, HTTP API, or applicati
 
 1. Load \`.agents/skills/playwright-test-agent/SKILL.md\`.
 2. Before Planner, the main agent may read relevant local project information and ask for information that materially affects the test, such as the deployed URL, account or role, expected behavior, environment, and authorization boundary. Do not perform a seed/config/generated-file audit or open the website during preparation.
-3. Do not start Playwright subagents. Once the required context is available, the main agent explicitly assumes the Planner role in this session.
+3. Use the Codex routing configured for this project. Do not create nested or same-role Playwright agents. If the configured Codex route assigns phases to the main session, that is a Codex-specific compatibility route; explicitly mark each phase and follow its role definition.
 4. Planner's first live browser action is \`playwright-cli open <url>\`. Prefer CLI while preserving the generated Playwright Test MCP configuration and tools. Do not call Chrome DevTools or an unrelated browser integration.
 5. Planner must convert its investigation into a complete Markdown test plan under \`specs/\`. Show that saved plan to the user and wait for explicit confirmation; investigation alone is not completion.
-6. After confirmation, assume Generator and generate executable Playwright test code for the confirmed plan. When generation finishes, execute the generated tests with \`npx playwright test\`; generating files alone is not completion.
-7. If every generated test passes, report the result. If any generated test fails, assume Healer with the failed test names and output; diagnose, patch, and rerun until the tests pass or a genuine application/environment/product blocker is identified. Never skip execution and never report generated-but-unexecuted tests as passing.
+6. After confirmation, the configured Generator role must generate executable Playwright test code for the confirmed plan. When generation finishes, execute the generated tests with \`npx playwright test\`; generating files alone is not completion.
+7. If every generated test passes, report the result. If any generated test fails, invoke the configured Healer role with the failed test names and output; diagnose, patch, and rerun until the tests pass or a genuine application/environment/product blocker is identified. Never skip execution and never report generated-but-unexecuted tests as passing.
 
 Ask only for information that is necessary or could materially change scope, assertions, access, or safety. Do not guess or create nested agents.