## 1. Playwright Foundation and Harness

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

## 2. Capability Coverage Matrix and Strategy

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

## 3. Core Journey and Modal Flows

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

## 4. Accessibility and Interaction State Regression

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

## 5. Responsive and Footer Microinteractions

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

## 6. Quality Gate Integration and Reporting

- [x] 6.1 Integrate Playwright smoke suite into pull-request quality gate with fail-on-regression policy.
- [x] 6.2 Integrate full Playwright profile into main/nightly pipeline stage with artifact retention.
- [x] 6.3 Enable trace/screenshot/video capture on failure and expose artifact links in CI logs.
- [x] 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.