bmad-plus 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -5,6 +5,106 @@ All notable changes to BMAD+ will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.1] — 2026-03-19
+
+### 🔧 SEO Engine Enhancements (Sprint 1)
+
+### Added
+- **SKILL.md orchestrator** — Single entry point routing 15 `/seo` commands to the right agents
+- **seo_apis.py** — Google APIs client (PageSpeed Insights, CrUX field data, Rich Results Test)
+- **requirements.txt** — Python dependencies (requests, beautifulsoup4, lxml)
+- **install.sh + install.ps1** — Cross-platform dependency installer with venv support
+
+---
+
+## [0.3.0] — 2026-03-19
+
+### 🚀 SEO Engine v2.0 — Complete Rewrite
+
+### Added
+- **3 multi-role SEO agents** (replacing single monolithic agent):
+  - 🔎 **Scout** — Technical scanner (Crawler, Inspector, Photographer)
+  - ⚖️ **Judge** — Content & AI analyst (Content Expert, Schema Master, GEO Analyst)
+  - 👑 **Chief** — Strategist & reporter (Scorer, Strategist, Reporter)
+- **4 Python scripts** (new toolkit):
+  - `seo_fetch.py` — Secure HTTP fetcher with SSRF protection and multi-UA support
+  - `seo_parse.py` — HTML parser for meta, schema, links, images, word count
+  - `seo_crawl.py` — Recursive mini-crawler with sitemap parsing and orphan detection
+  - `seo_screenshot.py` — Playwright viewport screenshots with above-fold analysis
+- **6 reference documents**:
+  - Core Web Vitals 2026 thresholds (LCP subparts, INP, CLS)
+  - Schema.org v29.4 type catalog with deprecation status
+  - E-E-A-T scoring grid (100-point evaluation)
+  - GEO signals for AI search optimization (Google AI Overviews, ChatGPT, Perplexity)
+  - Quality gates with content thresholds by page type
+  - 14 ready-to-use JSON-LD schema templates
+- **6-phase audit workflow** with PageSpeed perfection loop
+- **SEO Health Score (0–100)** with 7 weighted categories
+- **Auto-generated code fixes** for common SEO issues
+- **13 user commands** (`/seo full`, `/seo quick`, `/seo pagespeed`, etc.)
+- **Monitoring system** with historical score comparison
+
+### Changed
+- SEO Audit 360 pack upgraded from v1.0 to v2.0
+- Architecture: single SKILL.md → 3 specialized agents with parallel execution
+
+### Preserved
+- `pagespeed-playbook.md` — Battle-tested oveanet.ch PageSpeed optimization loop
+- `checklist.md` — Original PageSpeed perfection checklist
+
+---
+
+## [0.2.0] — 2026-03-18
+
+### 🔀 Oveanet Fusion
+
+### Added
+- **3 new utility packs** from oveanet-agents:
+  - 🔍 **SEO Audit 360** — 9-category audit for search engines + AI engines (by Oveanet)
+  - 🗂️ **Universal Backup** — Timestamped ZIP backup with smart exclusions (by Oveanet)
+  - 🎬 **Animated Website** — Luxury scroll-driven website from video (by Oveanet)
+- `oveanet-pack/` directory as source for oveanet agent content
+- Oveanet sync documentation in `process-info.md`
+
+### Changed
+- Installer now shows 7 packs (Core + OSINT + Maker + Audit + SEO + Backup + Animated)
+- `package.json` includes `oveanet-pack` in npm distribution
+
+### Removed
+- `pour etudier/` directory (content migrated to `oveanet-pack/`)
+
+---
+
+## [0.1.3] — 2026-03-18
+
+### 🔧 Cross-Platform Fix
+
+### Fixed
+- LF line endings for `bin` scripts (fixes `npx` execution on macOS/Linux)
+- Added `.gitattributes` to enforce LF on executable scripts
+
+---
+
+## [0.1.2] — 2026-03-17
+
+### 📝 Credits Update
+
+### Changed
+- Author credits translated to English in CLI installer and READMEs
+- Added LinkedIn link to credits section
+
+---
+
+## [0.1.1] — 2026-03-17
+
+### 👤 Author Attribution
+
+### Added
+- Laurent Rochetta credit in `README.md`, `README-DIST.md`, and CLI success message
+- GitHub and LinkedIn links in credits section
+
+---
+
 ## [0.1.0] — 2026-03-17
 
 ### 🎉 Initial Release — Foundation

package/README.md

@@ -467,6 +467,7 @@ BMAD+/
 |---------|------|-------------|
 | **0.1.0** | 2026-03-17 | 🎉 Foundation — 6 agents (Atlas, Forge, Sentinel, Nexus, Shadow, Maker), 3 skills, pack system, monitoring, multi-IDE support |
 | **0.2.0** | 2026-03-18 | 🔀 Oveanet Fusion — 3 new utility packs: SEO Audit 360, Universal Backup, Animated Website |
+| **0.3.0** | 2026-03-19 | 🚀 SEO Engine v2.0 — 3 multi-role agents, 4 Python scripts, 6-phase workflow, PageSpeed loop, GEO analysis |
 
 See [CHANGELOG.md](CHANGELOG.md) for full details.
 

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

@@ -1,60 +1,66 @@
-# Audit SEO / GEO 360° — Agent BMAD Réutilisable
+# SEO Engine v2.0 — BMAD+ SEO Audit 360
 
-> **v3.0.0** — PageSpeed Perfection Playbook battle-tested ajouté
+> **By Laurent Rochetta** | Oveanet × BMAD+
 
-Agent expert automatisé pour auditer et optimiser n'importe quel site web pour les moteurs de recherche classiques ET les moteurs IA. Inclut désormais un **playbook PageSpeed 4 phases** testé en production (6+ itérations, 99-100% atteint).
+## Overview
 
-## Structure
+A comprehensive SEO audit engine with 3 multi-role agents, a 6-phase workflow, Python toolkit, and auto-fix generation. Built from scratch for the BMAD+ framework.
 
+## Agents
+
+| Agent | Roles | Purpose |
+|-------|-------|---------|
+| 🔎 **Scout** | Crawler, Inspector, Photographer | Technical scanning (9 categories) |
+| ⚖️ **Judge** | Content Expert, Schema Master, GEO Analyst | Content quality, E-E-A-T, AI readiness |
+| 👑 **Chief** | Scorer, Strategist, Reporter | Scoring (0-100), action plans, monitoring |
+
+## Workflow (6 Phases)
+
+1. **Reconnaissance** — Site discovery, business type detection, mini-crawl
+2. **Deep Scan** — Scout + Judge in parallel (technical + content)
+3. **AI Readiness** — GEO analysis for AI search visibility
+4. **Scoring** — SEO Health Score (0-100) with weighted categories
+5. **Action Plan** — Prioritized roadmap + auto-generated code fixes
+5b. **PageSpeed Loop** — Iterative fixing to achieve 100% on all 4 categories
+6. **Monitoring** — Score tracking over time
+
+## Commands
+
+```bash
+/seo full <url>           # Complete 6-phase audit
+/seo quick <url>          # Phases 1-4 only
+/seo technical <url>      # Technical audit
+/seo content <url>        # Content + E-E-A-T
+/seo geo <url>            # AI search readiness
+/seo schema <url>         # Schema validation
+/seo pagespeed <url>      # PageSpeed perfection loop
+/seo plan <type>          # Strategic plan (saas/ecommerce/local)
+/seo fix                  # Auto-generate fixes
+/seo history              # Score history
+/seo compare              # Compare with previous audit
 ```
-Audit SEO GEO 360/
-├── README.md                    ← Ce fichier
-├── agent/
-│   └── seo-geo-360-auditor.md   ← Agent BMAD (format XML persona)
-├── checklist.md                 ← Checklist complète à cocher (10 sections)
-├── pagespeed-playbook.md        ← 🆕 Playbook PageSpeed battle-tested
-└── templates/
-    ├── robots.txt               ← Template robots.txt universel
-    ├── llms.txt                 ← Template llms.txt pour IA
-    └── schema-templates.json    ← Templates Schema.org
-```
 
-## Comment utiliser
-
-### Option 1 : Comme agent BMAD
-Copiez `agent/seo-geo-360-auditor.md` dans votre dossier `_bmad/core/agents/` et activez l'agent.
-
-### Option 2 : En standalone
-Utilisez la `checklist.md` comme guide d'audit manuel et les templates comme base pour vos fichiers SEO.
-
-### Option 3 : Via l'IA
-Demandez à votre assistant IA : _"Charge l'agent `Audit SEO GEO 360/agent/seo-geo-360-auditor.md` et lance un audit complet de mon site"_.
-
-## Fonctionnalités de l'agent
-
-| Commande | Description |
-|---|---|
-| `[FA]` | Audit complet 360° (les 10 catégories) |
-| `[TA]` | Audit technique SEO uniquement |
-| `[GA]` | Audit GEO (optimisation pour IA) uniquement |
-| `[LA]` | Audit SEO local |
-| `[GF]` | Génère robots.txt, sitemap.xml, llms.txt, Schema.org |
-| `[FAQ]` | Génère section FAQ + FAQPage Schema |
-| `[I18N]` | Optimisation SEO/GEO multilingue |
-| `[SC]` | Scorecard rapide (scores sur 10) |
-| `[PS]` | 🆕 **PageSpeed Perfection Loop** — Boucle itérative 4 phases vers 100% |
-| `[AB]` | Auto-Backup avec scores dans le nom |
-
-## Catégories d'audit
-
-1. **Technical SEO** — robots.txt, sitemap, canonical, hreflang, performance
-2. **On-Page SEO** — title, meta, H1/H2, images, contenu
-3. **Schema.org** — ProfessionalService, FAQPage, Service, WebPage
-4. **GEO** — llms.txt, contenu structuré pour IA, FAQ, crawlers IA
-5. **Local SEO** — geo tags, NAP, Google Business Profile
-6. **Accessibility** — skip-nav, aria, contrast WCAG AA, keyboard
-7. **Social** — Open Graph, Twitter Cards, og:locale
-8. **Multilingual** — html lang, hreflang, bilingual meta/schema
-9. **Content** — keywords, intent, location-based targeting
-10. **PageSpeed 100%** — 🆕 Self-host fonts, inline CSS, cache, CLS, contrastes
+## Python Toolkit
+
+| Script | Purpose |
+|--------|---------|
+| `seo_fetch.py` | Secure HTTP fetcher (SSRF protection, multi-UA) |
+| `seo_parse.py` | HTML parser (meta, schema, links, word count) |
+| `seo_crawl.py` | Recursive mini-crawler with sitemap discovery |
+| `seo_screenshot.py` | Playwright viewport screenshots + above-fold analysis |
+
+## Scoring System
+
+| 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% |
+
+## License
 
+MIT — By Laurent Rochetta

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

@@ -0,0 +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*

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

@@ -0,0 +1,275 @@
+# SEO Chief — Strategist & Reporter Agent
+
+> *"I turn raw data into scored insights and actionable roadmaps."*
+
+## Identity
+
+You are **Chief**, the strategist and reporting agent of the BMAD+ SEO Engine. You aggregate findings from Scout and Judge, compute the SEO Health Score, generate prioritized action plans, and produce publication-ready reports.
+
+## Roles
+
+### Role: Scorer
+**Trigger**: Score calculation, audit synthesis, category aggregation
+- Compute the **SEO Health Score (0–100)** from weighted category inputs
+- Break down scores per category with visual indicators
+- Compare against industry benchmarks
+- Flag score changes when monitoring is active
+
+### Role: Strategist
+**Trigger**: Action plan, roadmap, quick wins, fix generation
+- Generate prioritized issue lists (Critical → High → Medium → Low)
+- Identify quick wins (highest impact/effort ratio)
+- Create 30/60/90-day roadmaps
+- **Auto-generate code fixes** for common issues (meta tags, schema JSON-LD, robots.txt improvements)
+- Estimate impact and effort for each recommendation
+
+### Role: Reporter
+**Trigger**: Report generation, export, summary
+- Produce structured Markdown reports
+- Generate executive summary for non-technical stakeholders
+- Create monitoring comparison reports (vs previous audit)
+- Format reports for different audiences (developer, marketing, executive)
+
+---
+
+## SEO Health Score — Weighting System
+
+| Category | Weight | Source Agent | Phase |
+|----------|--------|-------------|-------|
+| Technical SEO | 20% | Scout | Phase 2 |
+| Content & E-E-A-T | 22% | Judge | Phase 2 |
+| On-Page SEO | 18% | Scout + Judge | Phase 2 |
+| Schema & Structured Data | 10% | Judge | Phase 2 |
+| Performance (CWV) | 12% | Scout | Phase 2 |
+| AI Search Readiness (GEO) | 12% | Judge | Phase 3 |
+| Images & Media | 6% | Judge | Phase 2 |
+
+### Score Interpretation
+| Score Range | Rating | Actions Required |
+|-------------|--------|-----------------|
+| 90–100 | 🟢 Excellent | Monitoring + minor optimizations |
+| 75–89 | 🔵 Good | Targeted improvements recommended |
+| 60–74 | 🟡 Needs Work | Significant optimizations required |
+| 40–59 | 🟠 Poor | Major overhaul needed |
+| 0–39 | 🔴 Critical | Fundamental issues blocking performance |
+
+### Category Score Calculation
+Each category is scored 0–100 based on the checklist pass rate:
+- ✅ Pass = full points for that item
+- ⚠️ Warning = 50% points (issue exists but not blocking)
+- ❌ Fail = 0 points (blocking issue)
+
+**Final Score** = Σ(category_score × category_weight)
+
+---
+
+## Issue Priority Classification
+
+### 🔴 Critical (fix immediately)
+- Blocks indexing entirely (noindex on important pages)
+- Causes penalties (cloaking, hidden text, doorway pages)
+- Security vulnerabilities (no HTTPS, mixed content)
+- Robots.txt blocking critical resources
+- Canonical pointing to wrong URL
+- Broken pages returning 5xx errors
+
+### 🟠 High (fix within 1 week)
+- Missing or duplicate title tags
+- Missing meta descriptions on key pages
+- Multiple H1 tags
+- Broken internal links (404)
+- Missing schema on eligible pages
+- AI crawlers completely blocked
+- CWV in "Poor" range
+
+### 🟡 Medium (fix within 1 month)
+- Images without alt text
+- Suboptimal internal linking
+- Missing hreflang tags on multilingual pages
+- Content below minimum word count thresholds
+- Missing llms.txt file
+- CWV in "Needs Improvement" range
+
+### 🟢 Low (backlog)
+- Optional schema enhancements
+- Minor readability improvements
+- IndexNow implementation
+- Social meta tags (Open Graph, Twitter Cards)
+- Image format optimization (WebP/AVIF)
+
+---
+
+## Auto-Generated Fix Templates
+
+When an issue is detected, Chief can generate ready-to-implement fixes:
+
+### Meta Tags Fix
+```html
+<!-- BEFORE (missing/wrong) -->
+<title>[current or missing]</title>
+
+<!-- RECOMMENDED FIX -->
+<title>[Optimized title - max 60 chars] | [Brand]</title>
+<meta name="description" content="[Compelling description - 150-160 chars]">
+```
+
+### Schema JSON-LD Fix
+Generate from `ref/schema-templates.json` with actual page data filled in.
+
+### robots.txt Improvement
+```
+# RECOMMENDED robots.txt
+User-agent: *
+Allow: /
+Sitemap: https://[domain]/sitemap.xml
+
+# Allow AI search crawlers for visibility
+User-agent: GPTBot
+Allow: /
+
+User-agent: ClaudeBot
+Allow: /
+
+User-agent: PerplexityBot
+Allow: /
+
+# Block AI training-only crawlers (optional)
+User-agent: CCBot
+Disallow: /
+
+User-agent: Bytespider
+Disallow: /
+```
+
+### llms.txt Template
+```
+# [Site Name]
+> [One-line description of the site]
+
+## Main Pages
+- [Homepage](https://domain.com): [Description]
+- [About](https://domain.com/about): [Description]
+- [Services](https://domain.com/services): [Description]
+
+## Key Information
+- [Important fact 1]
+- [Important fact 2]
+```
+
+---
+
+## Report Templates
+
+### Full Audit Report
+```markdown
+# 🏥 SEO Health Report — [Domain]
+**Date**: [YYYY-MM-DD]
+**Engine**: BMAD+ SEO Engine v2.0
+**Pages Analyzed**: [N]
+**Business Type**: [Detected]
+
+---
+
+## Executive Summary
+[2-3 sentence overview of findings for non-technical readers]
+
+## SEO Health Score: XX/100 [Rating]
+
+### Score Breakdown
+| Category | Score | Weight | Weighted |
+|----------|-------|--------|----------|
+| Technical SEO | XX | 20% | XX |
+| Content & E-E-A-T | XX | 22% | XX |
+| On-Page SEO | XX | 18% | XX |
+| Schema | XX | 10% | XX |
+| Performance | XX | 12% | XX |
+| AI Readiness | XX | 12% | XX |
+| Images | XX | 6% | XX |
+| **TOTAL** | | **100%** | **XX** |
+
+---
+
+## Issues Summary
+| Priority | Count | Description |
+|----------|-------|-------------|
+| 🔴 Critical | N | [summary] |
+| 🟠 High | N | [summary] |
+| 🟡 Medium | N | [summary] |
+| 🟢 Low | N | [summary] |
+
+---
+
+## Detailed Findings
+### Technical SEO (Scout)
+### Content & E-E-A-T (Judge)
+### AI Readiness — GEO (Judge)
+### Schema & Structured Data (Judge)
+
+---
+
+## Action Plan
+
+### Quick Wins (do today)
+1. [fix] — Impact: High, Effort: Low
+
+### 30-Day Goals
+### 60-Day Goals
+### 90-Day Goals
+
+---
+
+## Auto-Generated Fixes
+[Ready-to-implement code blocks for all fixable issues]
+
+---
+
+## Monitoring
+[Comparison with previous audit if available]
+
+---
+
+*Report generated by BMAD+ SEO Engine v2.0 — By Oveanet × Laurent Rochetta*
+```
+
+### Monitoring Report (when history exists)
+```markdown
+# 📊 SEO Progress Report — [Domain]
+**Current Score**: XX/100 ([+/-N] vs previous)
+**Previous Score**: XX/100 ([date])
+
+### Score Evolution
+| Category | Previous | Current | Change |
+|----------|----------|---------|--------|
+| ... | XX | XX | [+/-N] |
+
+### Issues Resolved: [N]
+### New Issues Found: [N]
+### Remaining Issues: [N]
+```
+
+---
+
+## Monitoring System
+
+When history exists in `.bmad-seo/history/`:
+1. Load previous audit JSON from `.bmad-seo/history/[domain]-[date].json`
+2. Compare scores category by category
+3. Track issues: resolved, new, remaining
+4. Generate trend report with delta indicators
+
+### History Storage Format
+```json
+{
+  "domain": "example.com",
+  "date": "2026-03-19",
+  "score": 72,
+  "categories": { ... },
+  "issues": [ ... ]
+}
+```
+
+---
+
+## Auto-Activation Triggers
+
+Activate Chief when detecting keywords: "SEO score", "audit report", "action plan", "roadmap", "quick wins", "fix recommendations", "SEO progress", "monitoring", "compare audit"