Skip to content

heymegabyte/agent-skills / 07-quality-and-verification

quality-and-verification

Unverified

5-level verification pyramid: static→unit→Playwright E2E (homepage-first, 6bp)→AI visual→post-deploy. 8-check quality gate. Multi-agent testing (functional/security/a11y/performance). Playwright v1.56+ AI agents (Planner/Generator/Healer, v1.63 current). WCAG 2.2 AA via axe-core v4.13. Percy+Chromatic visual regression. ADA Title II 2027/2028 deadlines.

FileKindSize
SKILL.mdskill md5.5 KB
accessibility-gate.mdmarkdown5.8 KB
adversarial-testing.mdmarkdown5.5 KB
agentic-security.mdmarkdown3.4 KB
audio-video-sync.mdmarkdown1.7 KB
build-breaking-rules.mdmarkdown17.0 KB
chrome-and-browser-workflows.mdmarkdown5.5 KB
completeness-verification.mdmarkdown5.3 KB
computer-use-automation.mdmarkdown6.0 KB
contract-testing.mdmarkdown4.3 KB
e2e-accumulation.mdmarkdown1.6 KB
eval-driven-development.mdmarkdown6.3 KB
evidence-collection.mdmarkdown3.7 KB
llm-evals.mdmarkdown15.7 KB
performance-optimization.mdmarkdown4.8 KB
picovoice-eagle-biometric.mdmarkdown1.6 KB
security-hardening.mdmarkdown8.7 KB
semgrep-codebase-rules.mdmarkdown4.2 KB
slop-detection.mdmarkdown4.3 KB
spec-driven-development.mdmarkdown5.0 KB
stagehand-ai-fallback.mdmarkdown1.6 KB
stagehand-ai-testing.mdmarkdown7.7 KB
tdd-verification.mdmarkdown6.7 KB
testing-matrices.mdmarkdown5.3 KB
ui-completeness-sweep.mdmarkdown6.3 KB
visual-inspection-loop.mdmarkdown14.0 KB
visual-regression.mdmarkdown7.0 KB
wcag-2-2-2026.mdmarkdown3.2 KB

accessibility-gate.md

View on GitHub
---
name: "Accessibility Gate"
version: "2.0.1"
updated: "2026-10-04"
description: "WCAG 2.2 AA via axe-core v4.13 + Playwright. 9 new SC: focus-not-obscured, target-size 24px, accessible-auth, consistent-help, redundant-entry, dragging-movements, focus-appearance. ADA Title II: 2027 (large) / 2028 (small). WCAG 3.0 awareness (174 requirements, 2028-2030)."
---

# Accessibility Gate

WCAG 2.2 AA minimum on every project.

### Why it matters

1 in 4 US adults has a disability; 71% leave inaccessible sites; 5,000+ ADA lawsuits in 2025 (+37% YoY); accessible sites rank higher. Brian's ethos: usable by everyone.

## Automated Audit (EVERY deploy)

```typescript
import { test, expect } from '@playwright/test';
import AxeBuilder from '@axe-core/playwright';

const BREAKPOINTS = [
  { name: 'mobile', width: 375, height: 667 },
  { name: 'tablet', width: 768, height: 1024 },
  { name: 'desktop', width: 1280, height: 720 },
];

for (const bp of BREAKPOINTS) {
  test(`a11y audit at ${bp.name}`, async ({ page }) => {
    await page.setViewportSize({ width: bp.width, height: bp.height });
    await page.goto('/');
    const results = await new AxeBuilder({ page })
      .withTags(['wcag2a', 'wcag2aa', 'wcag21aa', 'wcag22aa'])
      .analyze();
    expect(results.violations).toHaveLength(0);
  });
}
```

## Focus Styling

```css
.skip-link { position: absolute; top: -100%; left: 50%; transform: translateX(-50%); background: #00E5FF; color: #060610; padding: 0.75rem 1.5rem; border-radius: 0 0 8px 8px; font-weight: 600; z-index: 10000; transition: top 0.2s; }
.skip-link:focus { top: 0; }
*:focus-visible { outline: 2px solid #00E5FF; outline-offset: 3px; border-radius: 4px; }
*:focus:not(:focus-visible) { outline: none; }
.dark-bg *:focus-visible { outline-color: #fff; box-shadow: 0 0 0 4px rgba(0,229,255,0.3); }
```

## HTML Requirements

```html
<html lang="en">
<a href="#main" class="skip-link">Skip to content</a>
<header role="banner"><nav role="navigation" aria-label="Main navigation"></nav></header>
<main id="main" role="main"></main>
<footer role="contentinfo"></footer>
<!-- Images: descriptive alt, decorative: alt="" role="presentation" -->
<!-- Forms: <label for="id">, aria-describedby for help text -->
<!-- Headings: never skip levels -->
```

## Keyboard Navigation Test

- Tab through all focusable elements
- Verify focus does not get stuck on `BODY`
- Test `Escape` closes modals

## Reduced Motion

```typescript
test('respects prefers-reduced-motion', async ({ page }) => {
  await page.emulateMedia({ reducedMotion: 'reduce' });
  await page.goto('/');
  const running = await page.evaluate(() => document.getAnimations().filter(a => a.playState === 'running').length);
  expect(running).toBe(0);
});
```

## Screen Reader Checklist

- All interactive elements have accessible names
- Form errors announced via `aria-live="polite"`
- Dynamic content uses `aria-live`
- Images have descriptive `alt` (not "image" / filename)
- Decorative: `alt=""` + `role="presentation"`
- Links describe destination
- Buttons describe action
- Page title includes page name + brand
- Logical heading hierarchy

## WCAG 2.2 New Success Criteria (9 total)

### Level A (3)

- **3.2.6 Consistent Help** — same relative order
- **3.3.7 Redundant Entry** — don't re-ask same info
- **3.3.9 Accessible Auth Enhanced** — all cognitive tests need alternatives

### Level AA (6)

- **2.4.11 Focus Not Obscured (Min)** — not hidden by sticky headers
- **2.4.12 Focus Not Obscured (Enhanced)**
- **2.4.13 Focus Appearance** — 2px thick, 3:1 contrast
- **2.5.7 Dragging Movements** — single-pointer alternative
- **2.5.8 Target Size (Min)** — 24×24 CSS px
- **3.3.8 Accessible Auth (Min)** — support password managers / autofill / biometrics

## Full Deploy Checklist

- Skip-to-content link
- All images have alt text
- Form inputs labeled
- Contrast ≥4.5:1 (3:1 large)
- Keyboard accessible
- Focus rings visible + beautiful (2px solid, 3:1 contrast per 2.4.13)
- ARIA landmarks
- `lang` on `<html>`
- `prefers-reduced-motion` respected
- axe-core 0 violations (wcag22aa tags)
- Logical tab order
- No keyboard traps
- Touch targets ≥24×24px (WCAG 2.2) / 44×44px (recommended)
- Focused element not obscured by sticky headers/footers (2.4.11)
- Dragging has single-pointer alt (2.5.7)
- Forms support autofill / password managers (3.3.8)
- Help mechanisms consistent across pages (3.2.6)
- Never re-ask info already entered (3.3.7)
- Iframes have `title`
- Icon buttons have `aria-label`
- Toggle buttons use `aria-checked` / `aria-pressed`
- Decorative elements `aria-hidden="true"`

## MANDATORY Playwright Test (create if missing)

Verify:

- `lang` attribute
- Skip link exists
- Landmarks (`main` / `nav` / `header` / `footer`)
- Keyboard reaches CTA
- `focus-visible` defined (2px thick per 2.4.13)
- `prefers-reduced-motion` defined
- Form inputs labeled
- Buttons named
- No same fg/bg colors
- Target sizes ≥24px
- Focused element visible (not behind sticky elements)

## ADA & Standards Landscape

- **ADA Title II** — Large entities (50K+ pop) 2027-04-26, smaller 2028-04-26 (extended from 2026/2027). Legal standard: WCAG 2.1 AA (house bar: 2.2 AA).
- **Private companies** — No formal deadline, but 5,000+ lawsuits in 2025 (+37%). Gov contractors contractually required.
- **WCAG 3.0** — Working draft March 2026, 174 requirements (up from 78 SC), no A/AA/AAA levels, assertions + scoring. Est. W3C Rec 2028-2030, legal adoption 2030+.
- **axe-core v4.13.0** (Aug 2026) — Covers WCAG 2.0/2.1/2.2 at A/AA/AAA, Section 508, EN 301 549, RGAA, ADA. ~57% automated detection. 4.13's web-standards alignment shifts issue numbers (re-baseline a11y snapshots) + adds Element Internals support.
- AI agents interact with interfaces — semantic HTML + ARIA + structured data serve BOTH humans and agents.
- `font-display: swap`, subset fonts, min 16px body, test at 200% zoom, `prefers-contrast: more` support.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall