clawfort/openspec/changes/p17-regression-defects/tasks.md

1. Playwright Foundation and Harness

• 1.1 Add Playwright project setup (config, scripts, browser install, test directory layout).
• 1.2 Implement shared fixtures for seeded app state, authless startup, and deterministic article data assumptions.
• 1.3 Define viewport profiles (mobile/tablet/desktop) and theme profile helpers (light/dark/contrast).
• 1.4 Add stable selector strategy for critical controls (role/test-id fallback rules) to reduce locator fragility.

2. Capability Coverage Matrix and Strategy

• 2.1 Create capability-to-test mapping document covering all current OpenSpec UI-facing capabilities.
• 2.2 Define scenario taxonomy (journey, accessibility-state, responsive, modal, microinteraction, deep-link).
• 2.3 Define smoke vs full regression profiles and execution criteria per CI stage.

3. Core Journey and Modal Flows

• 3.1 Implement Playwright scenarios for hero/feed browsing and summary modal open/close across entry paths.
• 3.2 Add deep-link permalink tests validating valid, invalid, and hero-origin modal flows.
• 3.3 Add source CTA/share/copy interaction tests in modal and verify non-breaking navigation behavior.

4. Accessibility and Interaction State Regression

• 4.1 Implement keyboard-navigation and focus-visible assertions for primary interactive controls.
• 4.2 Implement color-contrast/state assertions for text/link/control states across light/dark/contrast themes.
• 4.3 Add icon-only control accessible-name assertions (share, copy, back-to-top, theme controls, modal actions).
• 4.4 Add policy modal accessibility tests for open, escape-close, focus-return, and focus containment behavior.

5. Responsive and Footer Microinteractions

• 5.1 Implement responsive regression tests for mobile/tablet/desktop ensuring no overflow/clipping on key surfaces.
• 5.2 Add sticky header/footer and floating back-to-top behavior checks across breakpoints.
• 5.3 Add footer contact-email tooltip tests for mouse hover/move/leave and keyboard focus/blur interactions.
• 5.4 Add env-driven footer link rendering tests for present/absent GitHub/contact config combinations.

6. Quality Gate Integration and Reporting

• 6.1 Integrate Playwright smoke suite into pull-request quality gate with fail-on-regression policy.
• 6.2 Integrate full Playwright profile into main/nightly pipeline stage with artifact retention.
• 6.3 Enable trace/screenshot/video capture on failure and expose artifact links in CI logs.
• 6.4 Document triage workflow and ownership for UI/UX regression failures.

7. Validation and Readiness

• 7.1 Run smoke profile locally and in CI, fixing flakiness until deterministic pass criteria are met.
• 7.2 Run full profile and confirm required capability coverage matrix is satisfied.
• 7.3 Verify OpenSpec capability requirements in this change are test-mapped and implementation-ready.