seo-a11y-analyzer

# SEO & Accessibility Analyzer

Analyzes HTML/JSX/TSX files for SEO issues and WCAG 2.1 AA compliance.

## Quick Start

Copy this workflow checklist and track progress:

```
Analysis Progress:
- [ ] Step 1: Read target file
- [ ] Step 2: Run quick checks (P0 critical issues)
- [ ] Step 3: Run detailed checks (all issues)
- [ ] Step 4: Validate with axe-core CLI
- [ ] Step 5: Generate report with fixes
```

## Step 1: Read Target File

Read the HTML/JSX/TSX file using the Read tool.

Identify file type:
- `.html` - Standard HTML
- `.jsx` / `.tsx` - React components (check className instead of class)

## Step 2: Quick Checks (P0 Critical Issues)

Check these **immediately** - they block compliance:

### 1. Title Tag (WCAG 2.4.2)
```html
<!-- Required -->
<title>Descriptive Page Title - Site Name</title>
```
- Must exist and be non-empty
- Recommended length: 50-60 characters
- Should be unique per page

### 2. Meta Description (SEO)
```html
<!-- Required -->
<meta name="description" content="Concise page description...">
```
- Must exist
- Recommended length: 150-160 characters

### 3. H1 Uniqueness (WCAG 2.4.6)
- Exactly **one** `<h1>` per page
- Must be descriptive and unique

### 4. Heading Hierarchy
- No skipped levels (h1 → h3 without h2)
- Logical nesting structure

### 5. Image Alt Text (WCAG 1.1.1)
```html
<!-- Informative image -->
<img src="photo.jpg" alt="Team members at annual retreat">

<!-- Decorative image -->
<img src="decoration.png" alt="">
```
- All `<img>` must have `alt` attribute
- Decorative images: `alt=""`
- Informative images: descriptive text (not filename)

### 6. Color Contrast (WCAG 1.4.3)
- Normal text: **4.5:1** minimum
- Large text (18pt / 14pt bold+): **3:1** minimum
- See [reference/color-contrast.md](reference/color-contrast.md) for common color combinations

**If any P0 issue found, report immediately with location and fix.**

## Step 3: Detailed Checks

### SEO Checks
See [reference/seo-checks.md](reference/seo-checks.md) for comp