Add case study: Playwright MCP best practices for Claude Code CLI

[konard]

Summary

This PR adds a comprehensive case study investigating Playwright MCP best practices for Claude Code CLI (Issue #1284).

Key Findings

1. Two Valid Approaches:

   • MCP (Model Context Protocol): claude mcp add playwright npx @playwright/mcp@latest - Recommended for most users
   • CLI + Skills: playwright-cli install --skills - Better for token-efficiency and CI/CD

2. No --tool claude flag exists - The commands mentioned in the issue work independently

3. Comparative Analysis:

   • MCP: Simpler setup, automatic tool discovery, 70% memory reduction through accessibility trees
   • CLI + Skills: 33% token savings, offline capable, better CI/CD integration

Files Added

• docs/case-studies/issue-1284/README.md - Comprehensive case study with:

  • Feature comparison table
  • Best practices for both approaches
  • Configuration examples
  • Security recommendations
  • Troubleshooting guide

• docs/case-studies/issue-1284/research-sources.md - All 15+ research sources consulted

• .changeset/playwright-mcp-best-practices.md - Changeset for version bump

Recommendations

For most Claude Code CLI users:

# Primary: MCP approach (simplest, most integrated)
claude mcp add playwright npx @playwright/mcp@latest

# Pre-install browsers
npx playwright install

For high-performance/production environments:

# CLI + Skills for token efficiency
npm install -g @playwright/cli@latest
playwright-cli install --skills

# Plus MCP for interactive debugging
claude mcp add playwright npx @playwright/mcp@latest

Test Plan

• Verify case study follows existing format in docs/case-studies/
• Check all external links are valid
• Ensure changeset is properly formatted
• Confirm prettier formatting passes

Fixes #1284

---

🤖 Generated with Claude Code

[konard]

🤖 Solution Draft Log

This log file contains the complete execution trace of the AI solution draft process.

💰 Cost estimation:

• Public pricing estimate: $2.312304
• Calculated by Anthropic: $1.877659 USD
• Difference: $-0.434645 (-18.80%)
  📎 Log file uploaded as Gist (376KB)
  🔗 View complete solution draft log

---

Now working session is ended, feel free to review and add any feedback on the solution draft.