playwright-documentation-tdd

Playwright TDD Documentation

Use this skill when the user wants structured test-case specs rather than lightweight notes.

Output Contract

Produce one scenario document per test case with these fields:

• title
• description
• test_suite
• covered_requirement
• preconditions
• steps
• execution_type
• design_status
• test_engineer
• test_level
• jira
• test_script

Use a markdown step table with Step, Action, and Expected result.

Traceability Rules

• Use repo-relative automation references such as tests/e2e/auth/login.spec.ts#AUTH-US02-user-login.
• Keep requirement references explicit and stable.
• If automation does not exist yet, say so instead of inventing a script link.

Organization Rules

• Prefer feature- or story-based folders when the user wants a persistent test-doc tree.
• Keep one scenario per file when the docs are meant to be maintained over time.
• Name files after the behavior they describe, not after arbitrary numbering alone.

Writing Rules

• Preconditions should describe the meaningful starting state, not boilerplate every test shares implicitly.
• Steps should reflect meaningful user or system actions, not every low-level click.
• Expected results should assert the requirement, not generic success language.