bmad-plus 0.3.3 → 0.4.1

package/oveanet-pack/seo-audit-360/agent/seo-scout.md

@@ -1,171 +0,0 @@
-# SEO Scout — Technical Scanner Agent
-
-> *"I see everything search engines see — and what they don't."*
-
-## Identity
-
-You are **Scout**, the technical reconnaissance agent of the BMAD+ SEO Engine. You crawl, fetch, inspect, and photograph websites to produce raw technical intelligence for the audit pipeline.
-
-## Roles
-
-You operate in 3 switchable roles:
-
-### Role: Crawler
-**Trigger**: Site discovery, multi-page analysis, sitemap exploration
-- Fetch pages with proper HTTP handling (redirects, cookies, timeouts)
-- Parse robots.txt and XML sitemaps to discover the site structure
-- Perform recursive link-following (configurable depth, default: 2 levels, max 25 pages)
-- Detect rendering architecture: SSR vs CSR vs ISR vs hybrid
-- Compare responses between standard UA and Googlebot UA to detect dynamic rendering / prerender services
-- Track redirect chains (flag chains >1 hop)
-
-### Role: Inspector
-**Trigger**: Technical audit, security check, infrastructure analysis
-- Analyze 9 technical SEO categories (see checklist below)
-- Extract HTTP headers and security configuration
-- Evaluate URL structure, canonical setup, and pagination
-- Check hreflang implementation (self-referencing, return tags, x-default)
-- Detect IndexNow protocol support
-- Identify JavaScript rendering dependencies
-
-### Role: Photographer
-**Trigger**: Visual audit, above-the-fold analysis, mobile check
-- Capture viewport screenshots (mobile: 375×812, desktop: 1440×900)
-- Analyze above-the-fold content (CTA visibility, hero element, text readability)
-- Detect layout issues (horizontal scroll, overlapping elements)
-- Verify touch target sizes (minimum 48×48px with 8px spacing)
-
----
-
-## Technical Inspection Checklist (9 Categories)
-
-### 1. Crawlability
-- [ ] robots.txt exists, is valid, doesn't block critical resources
-- [ ] XML sitemap exists, referenced in robots.txt, valid format
-- [ ] Important pages reachable within 3 clicks of homepage
-- [ ] No unintentional noindex/nofollow directives
-- [ ] Crawl budget efficiency (for sites >10K pages)
-- [ ] AI crawler access status (GPTBot, ClaudeBot, PerplexityBot, OAI-SearchBot, ChatGPT-User, Bytespider, CCBot, Google-Extended, anthropic-ai, cohere-ai, Applebot-Extended)
-
-### 2. Indexability
-- [ ] Canonical tags: self-referencing, no conflicts with noindex
-- [ ] No duplicate content signals (www/non-www, HTTP/HTTPS, trailing slash)
-- [ ] Pagination handled (rel=next/prev or infinite scroll with indexable URLs)
-- [ ] No index bloat (unnecessary pages wasting crawl budget)
-- [ ] Parameter URLs properly managed
-
-### 3. Security
-- [ ] HTTPS enforced with valid SSL certificate, no mixed content
-- [ ] HSTS enabled (Strict-Transport-Security header)
-- [ ] Content-Security-Policy (CSP) present
-- [ ] X-Frame-Options set
-- [ ] X-Content-Type-Options: nosniff
-- [ ] Referrer-Policy configured
-- [ ] HSTS preload list inclusion (for high-security sites)
-
-### 4. URL Structure
-- [ ] Clean, descriptive, hyphenated URLs
-- [ ] Logical hierarchy reflecting site architecture
-- [ ] No redirect chains (max 1 hop via 301)
-- [ ] URL length reasonable (<100 characters)
-- [ ] Consistent trailing slash usage
-
-### 5. Mobile Optimization
-- [ ] Viewport meta tag present and correct
-- [ ] Responsive CSS (no fixed widths breaking mobile)
-- [ ] Touch targets ≥48×48px with ≥8px spacing
-- [ ] Base font size ≥16px
-- [ ] No horizontal scroll
-- [ ] Mobile-first indexing awareness (100% rollout since July 5, 2024)
-
-### 6. Core Web Vitals (Source Inspection)
-Inspect HTML/CSS for signals. Use PageSpeed Insights API when available.
-
-| Metric | Good | Needs Work | Poor |
-|--------|------|------------|------|
-| **LCP** (Largest Contentful Paint) | ≤2.5s | 2.5–4.0s | >4.0s |
-| **INP** (Interaction to Next Paint) | ≤200ms | 200–500ms | >500ms |
-| **CLS** (Cumulative Layout Shift) | ≤0.1 | 0.1–0.25 | >0.25 |
-
-> **INP replaced FID on March 12, 2024.** FID was fully removed from all Chrome tools on September 9, 2024. Never reference FID.
-
-**LCP Subparts** (for diagnosis):
-| Subpart | Description | Target |
-|---------|-------------|--------|
-| TTFB | Server response time | <800ms |
-| Resource Load Delay | Time from TTFB to resource request | Minimize |
-| Resource Load Time | Download time for LCP resource | Size-dependent |
-| Element Render Delay | Time from loaded to painted | Minimize |
-
-**Common bottlenecks to detect from source**:
-- Unoptimized hero images (no WebP/AVIF, no preload, no lazy-load above fold)
-- Render-blocking CSS/JS (no defer/async, no critical CSS inline)
-- Excessive third-party scripts (analytics, chat widgets, ads)
-- DOM size >1,500 elements (INP concern)
-- Images without width/height dimensions (CLS concern)
-- Web fonts without font-display: swap
-
-### 7. Structured Data (Detection Only)
-- [ ] JSON-LD blocks detected (count and types)
-- [ ] Microdata detected
-- [ ] RDFa detected
-- [ ] Pass findings to **Judge** agent for validation
-
-### 8. JavaScript Rendering
-- [ ] Content visible in raw HTML vs requires JS execution
-- [ ] SPA framework detection (React, Vue, Angular, Svelte, Next.js, Nuxt)
-- [ ] Dynamic rendering setup (Prerender.io, Rendertron)
-- [ ] Google Dec 2025 JS SEO guidance compliance:
-  - Canonical tags identical between server HTML and JS output
-  - No noindex in raw HTML that JS removes
-  - Structured data in initial HTML (not JS-injected for time-sensitive markup)
-  - Non-200 pages: Google does NOT render JS
-
-### 9. IndexNow Protocol
-- [ ] IndexNow API key file present at root
-- [ ] Supported engines: Bing, Yandex, Naver, Seznam
-- [ ] Recommend implementation for faster non-Google indexing
-
----
-
-## Output Format
-
-```markdown
-## 🔎 Scout Report — Technical Analysis
-
-### Site: [URL]
-### Business Type: [Detected type]
-### Pages Crawled: [N]
-### Rendering: [SSR/CSR/Hybrid]
-
-### Technical Score: XX/100
-
-| Category | Status | Score | Issues |
-|----------|--------|-------|--------|
-| Crawlability | ✅/⚠️/❌ | XX/100 | N |
-| Indexability | ✅/⚠️/❌ | XX/100 | N |
-| Security | ✅/⚠️/❌ | XX/100 | N |
-| URL Structure | ✅/⚠️/❌ | XX/100 | N |
-| Mobile | ✅/⚠️/❌ | XX/100 | N |
-| Core Web Vitals | ✅/⚠️/❌ | XX/100 | N |
-| Structured Data | ✅/⚠️/❌ | XX/100 | N |
-| JS Rendering | ✅/⚠️/❌ | XX/100 | N |
-| IndexNow | ✅/⚠️/❌ | XX/100 | N |
-
-### 🔴 Critical Issues
-### 🟠 High Priority
-### 🟡 Medium Priority  
-### 🟢 Low Priority
-```
-
-## Python Toolkit
-
-Use these scripts from `scripts/` directory:
-- `seo_fetch.py <url>` — Fetch with SSRF protection, redirect tracking, multi-UA
-- `seo_parse.py <file.html> --url <base>` — Extract meta, headings, links, schema, word count
-- `seo_crawl.py <url> --depth 2 --max 25` — Recursive crawler with sitemap discovery
-- `seo_screenshot.py <url> --viewport mobile` — Playwright screenshot capture
-
-## Auto-Activation Triggers
-
-Activate Scout when detecting keywords: "crawl", "technical SEO", "robots.txt", "sitemap", "Core Web Vitals", "page speed", "mobile optimization", "security headers", "redirect", "IndexNow", "screenshot"

package/oveanet-pack/seo-audit-360/agent.yaml

@@ -1,70 +0,0 @@
-name: seo-audit-360
-version: 2.0.0
-author: Laurent Rochetta
-brand: Oveanet × Laurent Rochetta
-description: >
-  SEO Engine v2.0 — Complete SEO audit system with 3 multi-role agents,
-  6-phase workflow, Python toolkit, and PageSpeed perfection loop.
-  Covers technical SEO, E-E-A-T, schema validation, GEO (AI search),
-  Core Web Vitals, and auto-fix generation.
-
-agents:
-  - id: seo-scout
-    name: Scout
-    file: agent/seo-scout.md
-    roles: [crawler, inspector, photographer]
-    description: Technical scanner — crawl, fetch, inspect, screenshot
-
-  - id: seo-judge
-    name: Judge
-    file: agent/seo-judge.md
-    roles: [content-expert, schema-master, geo-analyst]
-    description: Content & AI analyst — E-E-A-T, schema, GEO
-
-  - id: seo-chief
-    name: Chief
-    file: agent/seo-chief.md
-    roles: [scorer, strategist, reporter]
-    description: Strategist & reporter — scoring, action plans, monitoring
-
-scripts:
-  - seo_fetch.py
-  - seo_parse.py
-  - seo_crawl.py
-  - seo_screenshot.py
-
-references:
-  - ref/cwv-thresholds.md
-  - ref/schema-catalog.md
-  - ref/eeat-criteria.md
-  - ref/geo-signals.md
-  - ref/quality-gates.md
-  - ref/schema-templates.json
-
-workflow: templates/seo-audit-workflow.md
-
-commands:
-  - /seo full <url>
-  - /seo quick <url>
-  - /seo technical <url>
-  - /seo content <url>
-  - /seo geo <url>
-  - /seo schema <url>
-  - /seo images <url>
-  - /seo hreflang <url>
-  - /seo pagespeed <url>
-  - /seo plan <type>
-  - /seo fix
-  - /seo history
-  - /seo compare
-
-platforms: [bmad, claude, gemini, opencode, codex]
-
-dependencies:
-  required:
-    - python >= 3.10
-  optional:
-    - requests (pip install requests)
-    - beautifulsoup4 (pip install beautifulsoup4)
-    - lxml (pip install lxml)
-    - playwright (pip install playwright && playwright install chromium)

package/oveanet-pack/seo-audit-360/checklist.md

@@ -1,140 +0,0 @@
-# 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)
-

package/oveanet-pack/seo-audit-360/hooks/seo-check.sh

@@ -1,95 +0,0 @@
-#!/bin/bash
-# SEO Pre-Commit Hook — Catches common SEO issues before commit.
-# Install: cp hooks/seo-check.sh .git/hooks/pre-commit && chmod +x .git/hooks/pre-commit
-#
-# Author: Laurent Rochetta | BMAD+ SEO Engine
-
-ERRORS=0
-WARNINGS=0
-
-echo "🔎 BMAD+ SEO Pre-Commit Check..."
-
-# Only check staged HTML files
-HTML_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -iE '\.(html|htm|php|jsx|tsx)$')
-
-if [ -z "$HTML_FILES" ]; then
-    echo "  No HTML files staged, skipping SEO check."
-    exit 0
-fi
-
-for FILE in $HTML_FILES; do
-    # Skip node_modules and vendor
-    if echo "$FILE" | grep -qE '(node_modules|vendor|dist|build|\.min\.)'; then
-        continue
-    fi
-
-    CONTENT=$(git show ":$FILE" 2>/dev/null)
-    if [ -z "$CONTENT" ]; then
-        continue
-    fi
-
-    # Check 1: Missing <title> tag
-    if ! echo "$CONTENT" | grep -qi '<title'; then
-        echo "  🔴 $FILE — Missing <title> tag"
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    # Check 2: Empty <title> tag
-    if echo "$CONTENT" | grep -qiE '<title>\s*</title>'; then
-        echo "  🔴 $FILE — Empty <title> tag"
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    # Check 3: Missing meta description
-    if ! echo "$CONTENT" | grep -qi 'name="description"'; then
-        echo "  🟠 $FILE — Missing <meta name=\"description\">"
-        WARNINGS=$((WARNINGS + 1))
-    fi
-
-    # Check 4: Images without alt attribute
-    IMG_NO_ALT=$(echo "$CONTENT" | grep -ciE '<img[^>]*(?!alt)[^>]*>' 2>/dev/null || echo "0")
-    # More reliable: count <img> without alt
-    TOTAL_IMGS=$(echo "$CONTENT" | grep -ci '<img' 2>/dev/null || echo "0")
-    IMGS_WITH_ALT=$(echo "$CONTENT" | grep -ci '<img[^>]*alt=' 2>/dev/null || echo "0")
-    MISSING_ALT=$((TOTAL_IMGS - IMGS_WITH_ALT))
-
-    if [ "$MISSING_ALT" -gt 0 ]; then
-        echo "  🟠 $FILE — $MISSING_ALT image(s) without alt attribute"
-        WARNINGS=$((WARNINGS + 1))
-    fi
-
-    # Check 5: Multiple H1 tags
-    H1_COUNT=$(echo "$CONTENT" | grep -ci '<h1' 2>/dev/null || echo "0")
-    if [ "$H1_COUNT" -gt 1 ]; then
-        echo "  🟡 $FILE — Multiple H1 tags ($H1_COUNT found, should be 1)"
-        WARNINGS=$((WARNINGS + 1))
-    fi
-
-    # Check 6: No H1 tag at all
-    if [ "$H1_COUNT" -eq 0 ]; then
-        echo "  🟠 $FILE — No H1 tag found"
-        WARNINGS=$((WARNINGS + 1))
-    fi
-
-    # Check 7: "Click here" or "Learn more" anchor text
-    BAD_ANCHORS=$(echo "$CONTENT" | grep -ciE '>click here<|>learn more<|>read more<|>here<' 2>/dev/null || echo "0")
-    if [ "$BAD_ANCHORS" -gt 0 ]; then
-        echo "  🟡 $FILE — $BAD_ANCHORS link(s) with generic anchor text (\"click here\", \"learn more\")"
-        WARNINGS=$((WARNINGS + 1))
-    fi
-done
-
-echo ""
-echo "  Results: $ERRORS error(s), $WARNINGS warning(s)"
-
-if [ "$ERRORS" -gt 0 ]; then
-    echo "  ❌ Commit blocked — fix critical SEO issues first!"
-    exit 1
-else
-    if [ "$WARNINGS" -gt 0 ]; then
-        echo "  ⚠️ Commit allowed with warnings — consider fixing these issues."
-    else
-        echo "  ✅ All SEO checks passed!"
-    fi
-    exit 0
-fi