Smart Playwright Protocol (SPP) v2.0.0

Smart Playwright Protocol (SPP) v2.0.0

SPP v2.0 is a major redesign focused on simplicity, consistency, and practical AI-assisted Playwright automation.

Highlights

Protocol-Driven Workflow

The framework now centers around the Smart Playwright Protocol (SPP):

Select
  ↓
Understand
  ↓
Explore
  ↓
Plan
  ↓
Implement
  ↓
Verify
  ├─ PASS → DONE
  └─ FAIL → BLOCKED → Recover → Verify

Simplified Task Lifecycle

Task states remain intentionally lightweight:

• TODO
• IN_PROGRESS
• BLOCKED
• DONE

Improved CLI Experience

• Interactive task workflow
• Task creation wizard
• Verification-focused lifecycle
• AI handoff prompts
• Clipboard support

Modernized Quality Gates

Pre-commit protections include:

• ESLint via lint-staged
• Selector validation
• test.only protection
• describe.only protection
• waitForTimeout protection
• test.skip warnings

Documentation Overhaul

Documentation is organized around:

• README.md
• PROTOCOL.md
• CLI.md
• ROADMAP.md
• AGENTS.md

MCP Strategy

• Official Playwright MCP is recommended for browser exploration and selector validation.
• SPP remains tool-agnostic and does not require MCP integrations to operate.

Philosophy

SPP v2 prioritizes:

• Simplicity
• Reviewability
• Verification-first development
• Human-AI collaboration
• Lightweight workflows

over complex orchestration and autonomous agent systems.

What's Next

Future improvements will focus on:

• Task frontmatter validation
• CI verification workflows
• Configurable quality gates

while preserving the lightweight nature of the protocol.