heymegabyte/agent-skills / skills/tdd-and-verification
tdd-and-verification
VerifiedCanonical Test-Driven Development (Red-Green-Refactor), legacy characterization-first retrofit, Nx selective impact execution, 300-second CI gate, Cloudflare Browser Run parallel CDP orchestration, and 15-family (450-item) verification policy.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.7 KB |
| references/f01-unit-and-business-behavior.md | markdown | 9.0 KB |
| references/f02-components-and-interactions.md | markdown | 8.8 KB |
| references/f03-integration-and-contracts.md | markdown | 8.1 KB |
| references/f04-system-and-e2e-journeys.md | markdown | 7.7 KB |
| references/f05-visual-regression-and-compatibility.md | markdown | 8.5 KB |
| references/f06-accessibility-and-usability.md | markdown | 7.6 KB |
| references/f07-generated-and-adversarial-inputs.md | markdown | 8.6 KB |
| references/f08-security-and-privacy.md | markdown | 8.8 KB |
| references/f09-data-correctness-and-distributed-behavior.md | markdown | 8.5 KB |
| references/f10-performance-capacity-and-cost.md | markdown | 8.1 KB |
| references/f11-resilience-failure-handling-and-recovery.md | markdown | 8.3 KB |
| references/f12-deployment-platform-packaging-and-infrastructure.md | markdown | 8.3 KB |
| references/f13-ai-agent-and-evaluation-behavior.md | markdown | 8.6 KB |
| references/f14-content-analytics-and-observability.md | markdown | 7.9 KB |
| references/f15-test-suite-effectiveness-and-skill-quality.md | markdown | 9.5 KB |
references/f05-visual-regression-and-compatibility.md
View on GitHub---
name: "F05 — Visual regression and compatibility"
familyId: "F05"
defaultLayer: "visual_regression"
defaultTier: "conditional_release"
itemCount: 30
---
# F05: Visual regression and compatibility (F05.01–F05.30)
- **Default Verification Layer**: `visual_regression`
- **Default Execution Tier**: `conditional_release`
- **Authorized Pilot Implementation**: `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts`
## Complete 30-Recommendation Obligation Matrix
| ID | Title | Obligation | Layer | Tier | Pilot Status | Evidence / Location |
|---|---|---|---|---|---|---|
| `F05.01` | **Stable baseline environments** | Establish visual baselines with explicit browser version, OS, fonts, theme, and viewport metadata. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.02` | **Shared-theme impact** | Select consuming stories in ui.theme.tools and pages in apps/web whenever theme tokens change. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.03` | **High-value visual assertions** | Capture critical layouts where clipping, overlap, or broken contrast would harm readers. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.04` | **State-specific appearance** | Compare loading, empty, error, selected, and editing appearances reusing F02 stories. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.05` | **Breakpoint boundaries** | Inspect all 6 standard widths (375, 390, 768, 1024, 1280, 1920) for overflow or hidden controls. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.06` | **Container-driven layout** | Test shared blog and UI widgets inside constrained split-column and card containers. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.07` | **Font failure and substitution** | Verify legibility and layout stability when web fonts are delayed or substituted. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.08` | **International text layout** | Render long unbroken token paths, RTL Arabic, and CJK scripts without clipping or overflow. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.09` | **Zoom and reflow** | Verify 200% zoom and narrow reflow preserve access to all primary content and controls. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.10` | **Forced colors** | Verify borders, focus rings, and chart patterns remain distinguishable under forced-colors modes. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.11` | **Reduced motion** | Verify prefers-reduced-motion disables smooth-scroll and transitions while keeping instant navigation. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.12` | **Theme transitions** | Compare light (paper) and dark (midnight-cyan) themes proving distinct OKLCH token resolution. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.13` | **Extreme content shapes** | Test 120-char token identifiers, null table cells, and dense citations in AdversarialEdgeCaseFixtures. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.14` | **Minimal screenshot masking** | Mask only genuinely nondeterministic regions while asserting their presence and dimensions. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.15` | **Capture readiness** | Await font readiness, image naturalWidth > 0, and settled animations before visual capture. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.16` | **Reviewed baseline changes** | Require explicit design/behavior rationale before updating visual baselines. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.17` | **Real engine coverage** | Pair Cloudflare Browser Run Chromium with targeted Firefox and WebKit checks where required. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.18` | **Actual mobile platforms** | Account for mobile viewport chrome, touch target sizing, and safe-area insets. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.19` | **Operating-system differences** | Account for platform font rendering and scrollbar differences without masking layout bugs. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.20` | **Pixel density and scaling** | Verify crisp SVG charts, responsive srcset images, and aspect-ratio boxes across DPR scaling. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.21` | **CSS feature fallbacks** | Verify sRGB fallback hex values accompany wide-gamut OKLCH tokens for legacy engines. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.22` | **Print layout** | Verify @media print hides authoring chrome and preserves article prose, charts, and bibliography. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.23` | **Export rendering** | Verify exported CSS, Tailwind v4, shadcn, and JSON token bundles match previewed themes. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.24` | **Image and icon assets** | Verify intrinsic width/height, non-zero naturalWidth, and accessible SVG icon labels. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.25` | **Resource-policy failures** | Verify strict CSP blocks unauthorized scripts while allowing all legitimate styles and assets. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.26` | **Layering conflicts** | Verify sticky headers, citation popovers, and dialogs maintain non-overlapping z-index stacking. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.27` | **Long-page scrolling** | Verify 2,500+ word reference articles maintain smooth TOC and citation fragment navigation. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.28` | **Interaction-state visibility** | Verify visible focus-visible outlines and hover/active states across all interactive controls. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.29` | **Embedded compatibility** | Verify Storybook iframe stories and embedded calculators size and theme cleanly. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
| `F05.30` | **User browser adaptations** | Verify compatibility with password managers, autofill, and reader/translation modes. | `visual_regression` | `conditional_release` | `verified` | `apps/ui/e2e/storybook-render.spec.ts & apps/web/e2e/theme-page.spec.ts` |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |