bmad-plus 0.7.5 → 0.9.0

package/src/bmad-plus/{agents → packs}/pack-seo/SKILL.md

@@ -1,171 +1,171 @@
----
-name: seo-engine
-description: >
-  BMAD+ SEO Engine v2.1 — Complete SEO audit engine with 3 multi-role agents,
-  6-phase workflow, Python toolkit, Google API integration, and PageSpeed
-  perfection loop. Use when user says /seo or any SEO-related command.
----
-
-# SEO Engine — Orchestrator
-
-> By Laurent Rochetta | BMAD+ SEO Engine v2.1
-
-## Quick Start
-
-This skill orchestrates 3 specialized agents through a structured workflow.
-Load the full agent files only when activating that agent's phase.
-
-## Command Router
-
-When the user issues a `/seo` command, route as follows:
-
-| Command | Agent(s) | Action |
-|---------|----------|--------|
-| `/seo full <url>` | Scout → Judge → Chief | Run all 6 phases |
-| `/seo quick <url>` | Scout → Judge → Chief | Run phases 1–4 only |
-| `/seo technical <url>` | Scout (Inspector) | Phase 2 technical only |
-| `/seo content <url>` | Judge (Content Expert) | Phase 2 content only |
-| `/seo geo <url>` | Judge (GEO Analyst) | Phase 3 only |
-| `/seo schema <url>` | Judge (Schema Master) | Schema detection + validation |
-| `/seo images <url>` | Judge (Content Expert) | Image audit subset |
-| `/seo hreflang <url>` | Scout (Inspector) | Hreflang audit, ref: `ref/hreflang-rules.md` |
-| `/seo pagespeed <url>` | Scout + Chief | PageSpeed perfection loop |
-| `/seo plan <type>` | Chief (Strategist) | Strategic plan by industry |
-| `/seo fix` | Chief (Strategist) | Auto-generate fixes from last audit |
-| `/seo history` | Chief (Reporter) | Show score history |
-| `/seo compare` | Chief (Reporter) | Compare with previous audit |
-| `/seo competitor <url1> <url2>` | Scout + Judge + Chief | Benchmark two sites |
-| `/seo api <url>` | (script) | Run Google APIs (PSI + CrUX + Rich Results) |
-
-## Full Audit Orchestration (`/seo full`)
-
-### Phase 1 — Reconnaissance
-**Agent**: Scout (Crawler role)
-**Load**: `agent/seo-scout.md`
-
-1. Run `scripts/seo_fetch.py <url> --json` to fetch homepage
-2. Run `scripts/seo_crawl.py <url> --depth 2 --max 25 --json` to discover structure
-3. Detect business type from content analysis:
-   - **SaaS**: pricing page, features page, signup CTA
-   - **E-commerce**: product pages, cart, categories
-   - **Local business**: address, phone, map, opening hours
-   - **Publisher**: articles, blog, news, RSS feed
-   - **Agency**: services, portfolio, case studies
-4. Check for `/robots.txt`, `/sitemap.xml`, `/llms.txt`
-
-**Checkpoint**: Report discovery summary, ask "Continue with full audit?"
-
-### Phase 2 — Deep Scan (PARALLEL)
-**Agents**: Scout (Inspector) + Judge (Content Expert + Schema Master)
-**Load**: `agent/seo-scout.md` + `agent/seo-judge.md`
-
-Run Scout and Judge **simultaneously** on each discovered page:
-
-**Scout checks** (9 categories — see `agent/seo-scout.md`):
-- Crawlability, Indexability, Security, URL Structure, Mobile
-- Core Web Vitals, Structured Data detection, JS Rendering, IndexNow
-
-**Judge checks** (see `agent/seo-judge.md`):
-- E-E-A-T evaluation (ref: `ref/eeat-criteria.md`)
-- Content quality (ref: `ref/quality-gates.md`)
-- Schema validation (ref: `ref/schema-catalog.md`)
-- Image audit
-- Internal/external link analysis
-
-**Optional**: Run `scripts/seo_apis.py --all <url>` for live PageSpeed + CrUX data.
-
-Use `scripts/seo_parse.py <file> --url <url> --json` on fetched HTML.
-Use `scripts/seo_screenshot.py <url> --viewport mobile` for visual audit.
-
-### Phase 3 — AI Readiness & GEO
-**Agent**: Judge (GEO Analyst role)
-**Reference**: `ref/geo-signals.md`
-
-- Check AI crawler access (GPTBot, ClaudeBot, PerplexityBot)
-- Verify llms.txt compliance
-- Score passage citability (134–167 word blocks)
-- Compute AI Readiness Score (0–100)
-
-### Phase 4 — Scoring
-**Agent**: Chief (Scorer role)
-**Load**: `agent/seo-chief.md`
-
-Compute SEO Health Score (0–100):
-
-| Category | Weight |
-|----------|--------|
-| Technical SEO | 20% |
-| Content & E-E-A-T | 22% |
-| On-Page SEO | 18% |
-| Schema | 10% |
-| Performance (CWV) | 12% |
-| AI Readiness (GEO) | 12% |
-| Images | 6% |
-
-### Phase 5 — Action Plan
-**Agent**: Chief (Strategist role)
-
-1. Classify issues: 🔴 Critical → 🟠 High → 🟡 Medium → 🟢 Low
-2. Identify quick wins (highest impact/effort ratio)
-3. Generate 30/60/90-day roadmap
-4. Auto-generate code fixes (meta tags, schema JSON-LD, robots.txt, llms.txt)
-
-**Checkpoint**: "Here's the plan. Apply fixes automatically?"
-
-### Phase 5b — PageSpeed Perfection Loop
-**Agents**: Scout + Chief
-**Reference**: `pagespeed-playbook.md` + `checklist.md`
-
-Use `scripts/seo_apis.py --pagespeed <url>` for live scores.
-Loop: fix one issue → re-test → verify improvement → next issue.
-Target: 100% on all 4 categories (Performance, Accessibility, Best Practices, SEO).
-
-### Phase 6 — Monitoring (optional)
-**Agent**: Scout (Crawler role)
-
-Save results to `.bmad-seo/history/<domain>-<date>.json`.
-On re-audit: compare with previous, show deltas.
-
----
-
-## Python Toolkit
-
-| Script | Usage | Dependencies |
-|--------|-------|-------------|
-| `seo_fetch.py` | `python scripts/seo_fetch.py <url> [--ua googlebot] [--json]` | requests |
-| `seo_parse.py` | `python scripts/seo_parse.py <file> --url <url> --json` | beautifulsoup4, lxml |
-| `seo_crawl.py` | `python scripts/seo_crawl.py <url> --depth 2 --max 25 --json` | requests |
-| `seo_screenshot.py` | `python scripts/seo_screenshot.py <url> --viewport mobile` | playwright |
-| `seo_apis.py` | `python scripts/seo_apis.py --pagespeed <url>` | requests |
-
-**Install dependencies**: `pip install -r requirements.txt`
-
-**Environment**: Set `GOOGLE_API_KEY` for Google API access (free, no OAuth).
-
----
-
-## Reference Files (lazy-load)
-
-Only load these when the relevant agent needs them:
-- `ref/cwv-thresholds.md` — Core Web Vitals 2026
-- `ref/schema-catalog.md` — Schema.org v29.4 types
-- `ref/eeat-criteria.md` — E-E-A-T scoring grid
-- `ref/geo-signals.md` — AI search signals
-- `ref/quality-gates.md` — Content thresholds
-- `ref/schema-templates.json` — 14 JSON-LD templates
-
----
-
-## Industry-Specific Plans (`/seo plan <type>`)
-
-| Type | Focus |
-|------|-------|
-| `saas` | Pricing pages, feature comparison, trial CTAs, documentation SEO |
-| `ecommerce` | Product schema, category pages, faceted navigation, review markup |
-| `local` | LocalBusiness schema, Google Business Profile, location pages, NAP consistency |
-| `publisher` | Article schema, author E-E-A-T, news sitemap, pagination |
-| `agency` | Service schema, portfolio, case studies, city-specific landing pages |
-
----
-
-*BMAD+ SEO Engine v2.1 — By Laurent Rochetta*
+---
+name: seo-engine
+description: >
+  BMAD+ SEO Engine v2.1 — Complete SEO audit engine with 3 multi-role agents,
+  6-phase workflow, Python toolkit, Google API integration, and PageSpeed
+  perfection loop. Use when user says /seo or any SEO-related command.
+---
+
+# SEO Engine — Orchestrator
+
+> By Laurent Rochetta | BMAD+ SEO Engine v2.1
+
+## Quick Start
+
+This skill orchestrates 3 specialized agents through a structured workflow.
+Load the full agent files only when activating that agent's phase.
+
+## Command Router
+
+When the user issues a `/seo` command, route as follows:
+
+| Command | Agent(s) | Action |
+|---------|----------|--------|
+| `/seo full <url>` | Scout → Judge → Chief | Run all 6 phases |
+| `/seo quick <url>` | Scout → Judge → Chief | Run phases 1–4 only |
+| `/seo technical <url>` | Scout (Inspector) | Phase 2 technical only |
+| `/seo content <url>` | Judge (Content Expert) | Phase 2 content only |
+| `/seo geo <url>` | Judge (GEO Analyst) | Phase 3 only |
+| `/seo schema <url>` | Judge (Schema Master) | Schema detection + validation |
+| `/seo images <url>` | Judge (Content Expert) | Image audit subset |
+| `/seo hreflang <url>` | Scout (Inspector) | Hreflang audit, ref: `ref/hreflang-rules.md` |
+| `/seo pagespeed <url>` | Scout + Chief | PageSpeed perfection loop |
+| `/seo plan <type>` | Chief (Strategist) | Strategic plan by industry |
+| `/seo fix` | Chief (Strategist) | Auto-generate fixes from last audit |
+| `/seo history` | Chief (Reporter) | Show score history |
+| `/seo compare` | Chief (Reporter) | Compare with previous audit |
+| `/seo competitor <url1> <url2>` | Scout + Judge + Chief | Benchmark two sites |
+| `/seo api <url>` | (script) | Run Google APIs (PSI + CrUX + Rich Results) |
+
+## Full Audit Orchestration (`/seo full`)
+
+### Phase 1 — Reconnaissance
+**Agent**: Scout (Crawler role)
+**Load**: `agent/seo-scout.md`
+
+1. Run `scripts/seo_fetch.py <url> --json` to fetch homepage
+2. Run `scripts/seo_crawl.py <url> --depth 2 --max 25 --json` to discover structure
+3. Detect business type from content analysis:
+   - **SaaS**: pricing page, features page, signup CTA
+   - **E-commerce**: product pages, cart, categories
+   - **Local business**: address, phone, map, opening hours
+   - **Publisher**: articles, blog, news, RSS feed
+   - **Agency**: services, portfolio, case studies
+4. Check for `/robots.txt`, `/sitemap.xml`, `/llms.txt`
+
+**Checkpoint**: Report discovery summary, ask "Continue with full audit?"
+
+### Phase 2 — Deep Scan (PARALLEL)
+**Agents**: Scout (Inspector) + Judge (Content Expert + Schema Master)
+**Load**: `agent/seo-scout.md` + `agent/seo-judge.md`
+
+Run Scout and Judge **simultaneously** on each discovered page:
+
+**Scout checks** (9 categories — see `agent/seo-scout.md`):
+- Crawlability, Indexability, Security, URL Structure, Mobile
+- Core Web Vitals, Structured Data detection, JS Rendering, IndexNow
+
+**Judge checks** (see `agent/seo-judge.md`):
+- E-E-A-T evaluation (ref: `ref/eeat-criteria.md`)
+- Content quality (ref: `ref/quality-gates.md`)
+- Schema validation (ref: `ref/schema-catalog.md`)
+- Image audit
+- Internal/external link analysis
+
+**Optional**: Run `scripts/seo_apis.py --all <url>` for live PageSpeed + CrUX data.
+
+Use `scripts/seo_parse.py <file> --url <url> --json` on fetched HTML.
+Use `scripts/seo_screenshot.py <url> --viewport mobile` for visual audit.
+
+### Phase 3 — AI Readiness & GEO
+**Agent**: Judge (GEO Analyst role)
+**Reference**: `ref/geo-signals.md`
+
+- Check AI crawler access (GPTBot, ClaudeBot, PerplexityBot)
+- Verify llms.txt compliance
+- Score passage citability (134–167 word blocks)
+- Compute AI Readiness Score (0–100)
+
+### Phase 4 — Scoring
+**Agent**: Chief (Scorer role)
+**Load**: `agent/seo-chief.md`
+
+Compute SEO Health Score (0–100):
+
+| Category | Weight |
+|----------|--------|
+| Technical SEO | 20% |
+| Content & E-E-A-T | 22% |
+| On-Page SEO | 18% |
+| Schema | 10% |
+| Performance (CWV) | 12% |
+| AI Readiness (GEO) | 12% |
+| Images | 6% |
+
+### Phase 5 — Action Plan
+**Agent**: Chief (Strategist role)
+
+1. Classify issues: 🔴 Critical → 🟠 High → 🟡 Medium → 🟢 Low
+2. Identify quick wins (highest impact/effort ratio)
+3. Generate 30/60/90-day roadmap
+4. Auto-generate code fixes (meta tags, schema JSON-LD, robots.txt, llms.txt)
+
+**Checkpoint**: "Here's the plan. Apply fixes automatically?"
+
+### Phase 5b — PageSpeed Perfection Loop
+**Agents**: Scout + Chief
+**Reference**: `pagespeed-playbook.md` + `checklist.md`
+
+Use `scripts/seo_apis.py --pagespeed <url>` for live scores.
+Loop: fix one issue → re-test → verify improvement → next issue.
+Target: 100% on all 4 categories (Performance, Accessibility, Best Practices, SEO).
+
+### Phase 6 — Monitoring (optional)
+**Agent**: Scout (Crawler role)
+
+Save results to `.bmad-seo/history/<domain>-<date>.json`.
+On re-audit: compare with previous, show deltas.
+
+---
+
+## Python Toolkit
+
+| Script | Usage | Dependencies |
+|--------|-------|-------------|
+| `seo_fetch.py` | `python scripts/seo_fetch.py <url> [--ua googlebot] [--json]` | requests |
+| `seo_parse.py` | `python scripts/seo_parse.py <file> --url <url> --json` | beautifulsoup4, lxml |
+| `seo_crawl.py` | `python scripts/seo_crawl.py <url> --depth 2 --max 25 --json` | requests |
+| `seo_screenshot.py` | `python scripts/seo_screenshot.py <url> --viewport mobile` | playwright |
+| `seo_apis.py` | `python scripts/seo_apis.py --pagespeed <url>` | requests |
+
+**Install dependencies**: `pip install -r requirements.txt`
+
+**Environment**: Set `GOOGLE_API_KEY` for Google API access (free, no OAuth).
+
+---
+
+## Reference Files (lazy-load)
+
+Only load these when the relevant agent needs them:
+- `ref/cwv-thresholds.md` — Core Web Vitals 2026
+- `ref/schema-catalog.md` — Schema.org v29.4 types
+- `ref/eeat-criteria.md` — E-E-A-T scoring grid
+- `ref/geo-signals.md` — AI search signals
+- `ref/quality-gates.md` — Content thresholds
+- `ref/schema-templates.json` — 14 JSON-LD templates
+
+---
+
+## Industry-Specific Plans (`/seo plan <type>`)
+
+| Type | Focus |
+|------|-------|
+| `saas` | Pricing pages, feature comparison, trial CTAs, documentation SEO |
+| `ecommerce` | Product schema, category pages, faceted navigation, review markup |
+| `local` | LocalBusiness schema, Google Business Profile, location pages, NAP consistency |
+| `publisher` | Article schema, author E-E-A-T, news sitemap, pagination |
+| `agency` | Service schema, portfolio, case studies, city-specific landing pages |
+
+---
+
+*BMAD+ SEO Engine v2.1 — By Laurent Rochetta*

package/src/bmad-plus/packs/pack-seo/bmad-skill-manifest.yaml

@@ -0,0 +1,13 @@
+type: pack
+name: bmad-plus-pack-seo
+displayName: SEO / GEO Audit Pack
+title: SEO & GEO Audit 360
+icon: "🔍"
+capabilities: "SEO audit, GEO audit, search engine optimization, pagespeed analysis, keyword research, content analysis, technical SEO, backlink analysis, competitor analysis, SERP analysis, local SEO, mobile optimization, structured data, XML sitemaps, robots.txt audit, core web vitals, accessibility audit, international SEO, ecommerce SEO, voice search optimization, AI search optimization"
+role: "SEO/GEO specialist providing comprehensive 360-degree search optimization audits and recommendations"
+identity: "Expert SEO and GEO (Generative Engine Optimization) auditor who combines technical depth with strategic insight. Analyzes websites across 100+ SEO factors and provides actionable, prioritized recommendations."
+communicationStyle: "Data-driven and precise. Presents findings with clear metrics and concrete action items. Explains technical concepts in accessible terms for stakeholders. Balances quick wins with strategic long-term recommendations."
+principles: "Audit every page through real device and search engine eyes. Prioritize fixes by impact and effort. All recommendations must be actionable and measurable. Track improvements with before/after metrics. Optimize for humans first, search engines second."
+module: bmad-plus
+canonicalId: bmad-plus-pack-seo
+pack: seo

package/src/bmad-plus/{agents → packs}/pack-seo/checklist.md

@@ -1,140 +1,140 @@
-# SEO/GEO 360° Audit Checklist
-
-## Usage
-Use this checklist as a template for any website audit. Copy it to your project's output folder and check items as you go.
-
----
-
-## 1. Technical SEO
-- [ ] `robots.txt` exists and is correctly configured
-- [ ] `sitemap.xml` exists with all pages, `lastmod`, `changefreq`, `priority`
-- [ ] Sitemap includes `xhtml:link` hreflang alternates (if multilingual)
-- [ ] Canonical URLs present on all pages
-- [ ] Hreflang tags for each language variant
-- [ ] Meta robots: `index, follow, max-image-preview:large, max-snippet:-1`
-- [ ] HTTPS enforced
-- [ ] No render-blocking resources (fonts preloaded, CSS inlined or local)
-- [ ] Mobile viewport meta tag present
-- [ ] Favicon present (SVG preferred, fallback PNG)
-- [ ] 404 error page exists
-- [ ] Page load time < 3 seconds
-
-## 2. On-Page SEO
-- [ ] `<title>` tag: 50-60 chars, contains primary keyword, unique per page
-- [ ] `<meta description>`: 150-160 chars, contains CTA, unique per page
-- [ ] `<meta keywords>`: relevant long-tail keywords
-- [ ] `<meta author>`: present
-- [ ] Single `<h1>` per page, descriptive, keyword-rich
-- [ ] Logical H2-H6 hierarchy
-- [ ] Images: `alt` tags, `width`/`height`, `loading="lazy"`, WebP format
-- [ ] Internal linking between pages
-- [ ] External links: `rel="noopener"` on `target="_blank"`
-- [ ] Content length adequate (300+ words for landing pages)
-
-## 3. Schema.org / Structured Data
-- [ ] Primary schema type (Organization/LocalBusiness/ProfessionalService)
-- [ ] Service schema for each service offered
-- [ ] FAQPage schema with real Q&As (minimum 5 questions)
-- [ ] WebPage schema (datePublished, dateModified, inLanguage)
-- [ ] BreadcrumbList schema
-- [ ] Person schema for founder/team (if applicable)
-- [ ] Review/AggregateRating schema (if applicable)
-- [ ] Validated with Google Rich Results Test
-
-## 4. GEO (Generative Engine Optimization)
-- [ ] `llms.txt` file at site root with structured business info
-- [ ] Content uses clear headings with question-based format
-- [ ] FAQ section with expandable answers
-- [ ] Concise, factual content per section (answers visible without interaction)
-- [ ] AI crawlers allowed in `robots.txt`:
-  - [ ] GPTBot
-  - [ ] ChatGPT-User
-  - [ ] PerplexityBot
-  - [ ] ClaudeBot
-  - [ ] Google-Extended
-- [ ] Content freshness: `dateModified` in schema, visible update dates
-- [ ] E-E-A-T signals: author credentials, "About" info, LinkedIn links
-- [ ] Tested queries in ChatGPT, Perplexity, and Gemini
-
-## 5. Local SEO
-- [ ] Geo meta tags: `geo.region`, `geo.placename`, `geo.position`, `ICBM`
-- [ ] NAP (Name, Address, Phone/Email) in footer
-- [ ] `<address>` HTML element used
-- [ ] Schema includes `geo` (GeoCoordinates), `areaServed`, `address`
-- [ ] Google Business Profile created and optimized
-- [ ] Local keywords in title, description, and H1
-- [ ] Citations on directories (Pages Jaunes, Google Maps, etc.)
-
-## 6. Accessibility
-- [ ] Skip navigation link
-- [ ] `aria-hidden="true"` on decorative SVGs and elements
-- [ ] `aria-label` on `<section>` and `<nav>` elements
-- [ ] `aria-pressed` on toggle buttons
-- [ ] Color contrast WCAG AA (4.5:1 minimum)
-- [ ] Keyboard-navigable form elements
-- [ ] `<html lang>` attribute set correctly (dynamic for multilingual)
-- [ ] `prefers-reduced-motion` media query support
-
-## 7. Social & Sharing
-- [ ] Open Graph: `og:title`, `og:description`, `og:image`, `og:url`, `og:type`
-- [ ] `og:site_name` present
-- [ ] `og:locale` with `og:locale:alternate` for other languages
-- [ ] `og:image` dimensions 1200×630px
-- [ ] Twitter Card: `twitter:card` (summary_large_image)
-- [ ] Social preview tested with sharing debugger tools
-
-## 8. Multilingual SEO (if applicable)
-- [ ] `<html lang>` dynamic based on selected language
-- [ ] Bilingual `<title>` and `<meta description>` (via server-side logic)
-- [ ] Hreflang tags for each page × each language
-- [ ] `x-default` hreflang set
-- [ ] Schema.org `description` in correct language
-- [ ] OG tags in correct language (`og:locale`)
-- [ ] Sitemap includes hreflang alternates per URL
-- [ ] Language preference persisted (localStorage/cookie)
-- [ ] Auto-detection of browser language (`navigator.language`)
-- [ ] Legal pages (Privacy, Terms) translated
-
-## 9. Content & Keywords
-- [ ] Primary keyword identified per page
-- [ ] Long-tail keyword variants in content
-- [ ] Location-based keywords (city, region, country)
-- [ ] Service-specific keywords
-- [ ] Competitor keyword gap analysis
-- [ ] Content matches search intent (informational, transactional, navigational)
-
-## 10. PageSpeed 100% — Performance Perfection Loop
-> Reference: See `pagespeed-playbook.md` for complete technique catalog with code examples.
-
-### Performance (Impact-Ordered)
-- [ ] Self-hosted fonts (woff2) — no Google CDN
-- [ ] Font preload with `fetchpriority="high"` for critical weight
-- [ ] `font-display: swap` on all `@font-face` rules
-- [ ] ALL CSS inlined in production HTML (zero render-blocking)
-- [ ] `.htaccess` cache headers: 1yr for static assets, 1hr for HTML
-- [ ] Gzip/Brotli compression enabled (mod_deflate)
-- [ ] ALL `<img>` tags have explicit `width` and `height` attributes
-- [ ] Below-fold images have `loading="lazy"`
-- [ ] LCP image has `fetchpriority="high"`
-- [ ] Third-party scripts use `async defer`
-- [ ] CLS = 0 (no layout shifts during load)
-
-### Accessibility (WCAG AA)
-- [ ] ALL text/background combos ≥ 4.5:1 contrast ratio
-- [ ] White text on orange backgrounds replaced with dark text (#1a0800)
-- [ ] Dim/muted text on dark backgrounds brightened to ≥ #a0b0b8
-- [ ] Badge text with transparency backgrounds ≥ #d4dde3
-- [ ] Checked: CTA buttons, active nav states, badges, footer, form labels, tags
-
-### Best Practices
-- [ ] No console errors from own code
-- [ ] Third-party console errors documented as known limitations
-- [ ] All external links have `rel="noopener noreferrer"`
-- [ ] All resources loaded over HTTPS
-
-### Anti-Patterns (NEVER DO)
-- [ ] ❌ Never use `media="print" onload` for CSS (causes CLS 0.936)
-- [ ] ❌ Never load fonts from external CDN without local fallback
-- [ ] ❌ Never leave `<img>` tags without width/height dimensions
-- [ ] ❌ Never fix contrast issues one at a time (batch ALL at once)
-
+# SEO/GEO 360° Audit Checklist
+
+## Usage
+Use this checklist as a template for any website audit. Copy it to your project's output folder and check items as you go.
+
+---
+
+## 1. Technical SEO
+- [ ] `robots.txt` exists and is correctly configured
+- [ ] `sitemap.xml` exists with all pages, `lastmod`, `changefreq`, `priority`
+- [ ] Sitemap includes `xhtml:link` hreflang alternates (if multilingual)
+- [ ] Canonical URLs present on all pages
+- [ ] Hreflang tags for each language variant
+- [ ] Meta robots: `index, follow, max-image-preview:large, max-snippet:-1`
+- [ ] HTTPS enforced
+- [ ] No render-blocking resources (fonts preloaded, CSS inlined or local)
+- [ ] Mobile viewport meta tag present
+- [ ] Favicon present (SVG preferred, fallback PNG)
+- [ ] 404 error page exists
+- [ ] Page load time < 3 seconds
+
+## 2. On-Page SEO
+- [ ] `<title>` tag: 50-60 chars, contains primary keyword, unique per page
+- [ ] `<meta description>`: 150-160 chars, contains CTA, unique per page
+- [ ] `<meta keywords>`: relevant long-tail keywords
+- [ ] `<meta author>`: present
+- [ ] Single `<h1>` per page, descriptive, keyword-rich
+- [ ] Logical H2-H6 hierarchy
+- [ ] Images: `alt` tags, `width`/`height`, `loading="lazy"`, WebP format
+- [ ] Internal linking between pages
+- [ ] External links: `rel="noopener"` on `target="_blank"`
+- [ ] Content length adequate (300+ words for landing pages)
+
+## 3. Schema.org / Structured Data
+- [ ] Primary schema type (Organization/LocalBusiness/ProfessionalService)
+- [ ] Service schema for each service offered
+- [ ] FAQPage schema with real Q&As (minimum 5 questions)
+- [ ] WebPage schema (datePublished, dateModified, inLanguage)
+- [ ] BreadcrumbList schema
+- [ ] Person schema for founder/team (if applicable)
+- [ ] Review/AggregateRating schema (if applicable)
+- [ ] Validated with Google Rich Results Test
+
+## 4. GEO (Generative Engine Optimization)
+- [ ] `llms.txt` file at site root with structured business info
+- [ ] Content uses clear headings with question-based format
+- [ ] FAQ section with expandable answers
+- [ ] Concise, factual content per section (answers visible without interaction)
+- [ ] AI crawlers allowed in `robots.txt`:
+  - [ ] GPTBot
+  - [ ] ChatGPT-User
+  - [ ] PerplexityBot
+  - [ ] ClaudeBot
+  - [ ] Google-Extended
+- [ ] Content freshness: `dateModified` in schema, visible update dates
+- [ ] E-E-A-T signals: author credentials, "About" info, LinkedIn links
+- [ ] Tested queries in ChatGPT, Perplexity, and Gemini
+
+## 5. Local SEO
+- [ ] Geo meta tags: `geo.region`, `geo.placename`, `geo.position`, `ICBM`
+- [ ] NAP (Name, Address, Phone/Email) in footer
+- [ ] `<address>` HTML element used
+- [ ] Schema includes `geo` (GeoCoordinates), `areaServed`, `address`
+- [ ] Google Business Profile created and optimized
+- [ ] Local keywords in title, description, and H1
+- [ ] Citations on directories (Pages Jaunes, Google Maps, etc.)
+
+## 6. Accessibility
+- [ ] Skip navigation link
+- [ ] `aria-hidden="true"` on decorative SVGs and elements
+- [ ] `aria-label` on `<section>` and `<nav>` elements
+- [ ] `aria-pressed` on toggle buttons
+- [ ] Color contrast WCAG AA (4.5:1 minimum)
+- [ ] Keyboard-navigable form elements
+- [ ] `<html lang>` attribute set correctly (dynamic for multilingual)
+- [ ] `prefers-reduced-motion` media query support
+
+## 7. Social & Sharing
+- [ ] Open Graph: `og:title`, `og:description`, `og:image`, `og:url`, `og:type`
+- [ ] `og:site_name` present
+- [ ] `og:locale` with `og:locale:alternate` for other languages
+- [ ] `og:image` dimensions 1200×630px
+- [ ] Twitter Card: `twitter:card` (summary_large_image)
+- [ ] Social preview tested with sharing debugger tools
+
+## 8. Multilingual SEO (if applicable)
+- [ ] `<html lang>` dynamic based on selected language
+- [ ] Bilingual `<title>` and `<meta description>` (via server-side logic)
+- [ ] Hreflang tags for each page × each language
+- [ ] `x-default` hreflang set
+- [ ] Schema.org `description` in correct language
+- [ ] OG tags in correct language (`og:locale`)
+- [ ] Sitemap includes hreflang alternates per URL
+- [ ] Language preference persisted (localStorage/cookie)
+- [ ] Auto-detection of browser language (`navigator.language`)
+- [ ] Legal pages (Privacy, Terms) translated
+
+## 9. Content & Keywords
+- [ ] Primary keyword identified per page
+- [ ] Long-tail keyword variants in content
+- [ ] Location-based keywords (city, region, country)
+- [ ] Service-specific keywords
+- [ ] Competitor keyword gap analysis
+- [ ] Content matches search intent (informational, transactional, navigational)
+
+## 10. PageSpeed 100% — Performance Perfection Loop
+> Reference: See `pagespeed-playbook.md` for complete technique catalog with code examples.
+
+### Performance (Impact-Ordered)
+- [ ] Self-hosted fonts (woff2) — no Google CDN
+- [ ] Font preload with `fetchpriority="high"` for critical weight
+- [ ] `font-display: swap` on all `@font-face` rules
+- [ ] ALL CSS inlined in production HTML (zero render-blocking)
+- [ ] `.htaccess` cache headers: 1yr for static assets, 1hr for HTML
+- [ ] Gzip/Brotli compression enabled (mod_deflate)
+- [ ] ALL `<img>` tags have explicit `width` and `height` attributes
+- [ ] Below-fold images have `loading="lazy"`
+- [ ] LCP image has `fetchpriority="high"`
+- [ ] Third-party scripts use `async defer`
+- [ ] CLS = 0 (no layout shifts during load)
+
+### Accessibility (WCAG AA)
+- [ ] ALL text/background combos ≥ 4.5:1 contrast ratio
+- [ ] White text on orange backgrounds replaced with dark text (#1a0800)
+- [ ] Dim/muted text on dark backgrounds brightened to ≥ #a0b0b8
+- [ ] Badge text with transparency backgrounds ≥ #d4dde3
+- [ ] Checked: CTA buttons, active nav states, badges, footer, form labels, tags
+
+### Best Practices
+- [ ] No console errors from own code
+- [ ] Third-party console errors documented as known limitations
+- [ ] All external links have `rel="noopener noreferrer"`
+- [ ] All resources loaded over HTTPS
+
+### Anti-Patterns (NEVER DO)
+- [ ] ❌ Never use `media="print" onload` for CSS (causes CLS 0.936)
+- [ ] ❌ Never load fonts from external CDN without local fallback
+- [ ] ❌ Never leave `<img>` tags without width/height dimensions
+- [ ] ❌ Never fix contrast issues one at a time (batch ALL at once)
+