docs: standardize Playwright MCP headed/headless runbook across AI CLI harnesses - #1438
Conversation
There was a problem hiding this comment.
Review Summary
This PR adds comprehensive documentation for managing Playwright MCP headed vs headless browser modes across AI CLI harnesses. The documentation structure is well-organized with both a quick-reference cheatsheet and a detailed runbook.
Critical Issue
One broken relative path link that prevents navigation from the cheatsheet to the detailed procedure. This must be fixed before merge as it breaks the core functionality of the documentation.
Documentation Quality
The content is clear, actionable, and follows the repository's documentation patterns. The cross-linking strategy between files is sound once the path issue is resolved.
You can now have the agent implement changes and create commits directly on your pull request's source branch. Simply comment with /q followed by your request in natural language to ask the agent to make changes.
Co-authored-by: amazon-q-developer[bot] <208079219+amazon-q-developer[bot]@users.noreply.github.com>
Summary
Adds a universal, app-agnostic process for deterministic Playwright MCP mode behavior (headed vs headless) across AI-first CLI sessions.
Changes
Why
Headed sessions are often required for login, verification, and demos, but can appear to run headless due to harness config/env boundaries. This PR documents deterministic diagnosis and recovery.
Validation