Skip to content

docs: standardize Playwright MCP headed/headless runbook across AI CLI harnesses - #1438

Merged
atxtechbro merged 2 commits into
mainfrom
docs/playwright-headed-headless-runbook
Feb 14, 2026
Merged

docs: standardize Playwright MCP headed/headless runbook across AI CLI harnesses#1438
atxtechbro merged 2 commits into
mainfrom
docs/playwright-headed-headless-runbook

Conversation

@atxtechbro

@atxtechbro atxtechbro commented Feb 14, 2026

Copy link
Copy Markdown
Owner

Summary

Adds a universal, app-agnostic process for deterministic Playwright MCP mode behavior (headed vs headless) across AI-first CLI sessions.

Changes

  • Added canonical procedure: knowledge/procedures/playwright-headed-vs-headless.md
  • Added one-page operator reference: docs/playwright-headed-headless-cheatsheet.md
  • Linked the new guidance from:
    • knowledge/procedures/README.md
    • knowledge/ai-index.md
    • mcp/README.md

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

  • Verified all new doc links resolve within the repo
  • Docs-only change; no runtime behavior changes

@amazon-q-developer amazon-q-developer Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment thread docs/playwright-headed-headless-cheatsheet.md Outdated
Co-authored-by: amazon-q-developer[bot] <208079219+amazon-q-developer[bot]@users.noreply.github.com>
@atxtechbro
atxtechbro merged commit 08dcace into main Feb 14, 2026
@atxtechbro
atxtechbro deleted the docs/playwright-headed-headless-runbook branch February 14, 2026 13:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant