bmad-plus 0.1.3 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/CHANGELOG.md +88 -0
  2. package/README.md +2 -0
  3. package/oveanet-pack/animated-website/DEPLOYMENT.md +104 -0
  4. package/oveanet-pack/animated-website/README.md +63 -0
  5. package/oveanet-pack/animated-website/agent/animated-website-agent.md +325 -0
  6. package/oveanet-pack/animated-website/agent.yaml +63 -0
  7. package/oveanet-pack/animated-website/templates/animated-website-workflow.md +55 -0
  8. package/oveanet-pack/seo-audit-360/DEPLOYMENT.md +115 -0
  9. package/oveanet-pack/seo-audit-360/README.md +66 -0
  10. package/oveanet-pack/seo-audit-360/agent/seo-chief.md +275 -0
  11. package/oveanet-pack/seo-audit-360/agent/seo-judge.md +241 -0
  12. package/oveanet-pack/seo-audit-360/agent/seo-scout.md +171 -0
  13. package/oveanet-pack/seo-audit-360/agent.yaml +70 -0
  14. package/oveanet-pack/seo-audit-360/checklist.md +140 -0
  15. package/oveanet-pack/seo-audit-360/pagespeed-playbook.md +320 -0
  16. package/oveanet-pack/seo-audit-360/ref/cwv-thresholds.md +87 -0
  17. package/oveanet-pack/seo-audit-360/ref/eeat-criteria.md +123 -0
  18. package/oveanet-pack/seo-audit-360/ref/geo-signals.md +167 -0
  19. package/oveanet-pack/seo-audit-360/ref/quality-gates.md +133 -0
  20. package/oveanet-pack/seo-audit-360/ref/schema-catalog.md +91 -0
  21. package/oveanet-pack/seo-audit-360/ref/schema-templates.json +356 -0
  22. package/oveanet-pack/seo-audit-360/scripts/seo_crawl.py +282 -0
  23. package/oveanet-pack/seo-audit-360/scripts/seo_fetch.py +231 -0
  24. package/oveanet-pack/seo-audit-360/scripts/seo_parse.py +255 -0
  25. package/oveanet-pack/seo-audit-360/scripts/seo_screenshot.py +202 -0
  26. package/oveanet-pack/seo-audit-360/templates/seo-audit-workflow.md +241 -0
  27. package/oveanet-pack/universal-backup/DEPLOYMENT.md +80 -0
  28. package/oveanet-pack/universal-backup/README.md +58 -0
  29. package/oveanet-pack/universal-backup/agent/backup-agent.md +71 -0
  30. package/oveanet-pack/universal-backup/agent.yaml +45 -0
  31. package/oveanet-pack/universal-backup/templates/backup-workflow.md +51 -0
  32. package/package.json +2 -1
  33. package/tools/cli/commands/install.js +37 -0
package/oveanet-pack/seo-audit-360/pagespeed-playbook.md ADDED
@@ -0,0 +1,320 @@
1
+ # 🎯 PageSpeed Perfection Playbook — Battle-Tested Guide
2
+
3
+ > **Version 1.0.0** — Based on 6+ real-world iterations achieving 99-100% on oveanet.ch, montpellier.ai, and oveanet.fr
4
+ > By Laurent ROCHETTA × AI
5
+
6
+ ---
7
+
8
+ ## 📐 Architecture: The 4-Phase Protocol
9
+
10
+ ```
11
+ Phase 1: DIAGNOSTIC → Extract scores, identify all failing audits
12
+ Phase 2: PERFORMANCE → Self-host fonts → Inline CSS → Cache → CLS
13
+ Phase 3: ACCESSIBILITY → WCAG AA contrast fixes (systematic)
14
+ Phase 4: BEST PRACTICES & SEO → Console errors, security, meta tags
15
+ ```
16
+
17
+ Each phase runs sequentially. **Backup before each phase.** Re-test after each phase.
18
+
19
+ ---
20
+
21
+ ## ⚠️ Anti-Patterns — Things That BREAK Scores
22
+
23
+ > [!CAUTION]
24
+ > These are real mistakes made during optimization that caused score REGRESSIONS.
25
+
26
+ ### 🔴 NEVER: Async CSS Loading
27
+ ```html
28
+ <!-- ❌ DISASTER — causes CLS 0.936 on mobile -->
29
+ <link rel="stylesheet" href="styles.css" media="print" onload="this.media='all'"/>
30
+ <noscript><link rel="stylesheet" href="styles.css"/></noscript>
31
+ ```
32
+ **What happens:** The page renders with no styles, then FLASHES when CSS loads. PageSpeed measures this as a massive Cumulative Layout Shift (0.936 — nearly maximum). Performance dropped from 86 to 75.
33
+
34
+ **Fix:** Either load CSS synchronously or inline it entirely.
35
+
36
+ ### 🔴 NEVER: External Font CDN Without Fallback
37
+ ```html
38
+ <!-- ❌ Adds 300-800ms to LCP on mobile 4G -->
39
+ <link href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;600;700" rel="stylesheet"/>
40
+ ```
41
+ **What happens:** DNS lookup + TLS handshake to `fonts.googleapis.com`, then another to `fonts.gstatic.com`. On 4G simulation, this adds 500ms+ to LCP.
42
+
43
+ ### 🔴 NEVER: Images Without Dimensions
44
+ ```html
45
+ <!-- ❌ Causes CLS because browser doesn't know the space to reserve -->
46
+ <img src="logo.svg" alt="Logo"/>
47
+ ```
48
+ **Fix:** Always add `width` and `height`:
49
+ ```html
50
+ <img src="logo.svg" alt="Logo" width="100" height="20"/>
51
+ ```
52
+
53
+ ---
54
+
55
+ ## 🏆 Technique Catalog — Ordered by Impact
56
+
57
+ ### [P1] Self-Host Fonts (Biggest LCP Win)
58
+
59
+ **Impact:** LCP -30-50% on mobile, eliminates 2 external requests
60
+
61
+ **Step 1:** Download fonts from Google Fonts API or copy from existing projects:
62
+ ```
63
+ fonts/
64
+ ├── space-grotesk-400-latin.woff2
65
+ ├── space-grotesk-600-latin.woff2
66
+ └── space-grotesk-700-latin.woff2
67
+ ```
68
+
69
+ **Step 2:** Update CSS `@font-face` declarations:
70
+ ```css
71
+ /* ✅ Self-hosted — zero external requests */
72
+ @font-face {
73
+ font-family: 'Space Grotesk';
74
+ font-style: normal;
75
+ font-weight: 400;
76
+ font-display: swap;
77
+ src: url('fonts/space-grotesk-400-latin.woff2') format('woff2');
78
+ }
79
+ @font-face {
80
+ font-family: 'Space Grotesk';
81
+ font-style: normal;
82
+ font-weight: 600;
83
+ font-display: swap;
84
+ src: url('fonts/space-grotesk-600-latin.woff2') format('woff2');
85
+ }
86
+ @font-face {
87
+ font-family: 'Space Grotesk';
88
+ font-style: normal;
89
+ font-weight: 700;
90
+ font-display: swap;
91
+ src: url('fonts/space-grotesk-700-latin.woff2') format('woff2');
92
+ }
93
+ ```
94
+
95
+ **Step 3:** Preload critical fonts in HTML `<head>`:
96
+ ```html
97
+ <link rel="preload" href="fonts/space-grotesk-400-latin.woff2"
98
+ as="font" type="font/woff2" crossorigin fetchpriority="high"/>
99
+ <link rel="preload" href="fonts/space-grotesk-600-latin.woff2"
100
+ as="font" type="font/woff2" crossorigin/>
101
+ ```
102
+
103
+ **Step 4:** Remove ALL Google Fonts CDN references:
104
+ ```diff
105
+ -<link rel="preconnect" href="https://fonts.googleapis.com"/>
106
+ -<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin/>
107
+ -<link href="https://fonts.googleapis.com/css2?..." rel="stylesheet"/>
108
+ +<!-- Fonts are self-hosted, no external CDN needed -->
109
+ ```
110
+
111
+ ### How to get woff2 files from Google Fonts:
112
+ ```bash
113
+ # Method 1: Use google-webfonts-helper
114
+ # https://gwfh.mranftl.com/fonts
115
+
116
+ # Method 2: Direct download with curl (set woff2 user-agent)
117
+ curl -H "User-Agent: Mozilla/5.0" \
118
+ "https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;600;700&display=swap" \
119
+ | grep -oP 'url\(\K[^)]+' | while read url; do
120
+ wget "$url" -P fonts/
121
+ done
122
+ ```
123
+
124
+ ---
125
+
126
+ ### [P2] Inline ALL CSS (Zero Render-Blocking)
127
+
128
+ **Impact:** Eliminates render-blocking CSS request, reduces FCP by 100-300ms
129
+
130
+ **For PHP sites** (like montpellier.ai):
131
+ ```php
132
+ <!-- ✅ CSS inlined at build time — zero render-blocking -->
133
+ <style><?php echo file_get_contents(__DIR__ . '/styles.css'); ?></style>
134
+ ```
135
+
136
+ **For static HTML sites** (build script):
137
+
138
+ PowerShell build script:
139
+ ```powershell
140
+ # build-dist.ps1 — Inline CSS into HTML for production
141
+ $css = Get-Content "styles.css" -Raw
142
+ $html = Get-Content "index.html" -Raw
143
+
144
+ $cssInline = " <style>`n$css`n </style>"
145
+
146
+ # Replace the critical CSS + external link with full inline
147
+ $pattern = ' <!-- Critical CSS.*?</style>\s*\r?\n.*?<link rel="stylesheet" href="styles.css"/>'
148
+ $html = $html -replace $pattern, $cssInline
149
+
150
+ $html | Set-Content "dist/index.html" -Encoding UTF8
151
+ ```
152
+
153
+ Bash build script:
154
+ ```bash
155
+ #!/bin/bash
156
+ # build-dist.sh — Inline CSS into HTML for production
157
+ CSS=$(cat styles.css)
158
+ sed -e '/<!-- Critical CSS/,/<link rel="stylesheet"/c\ <style>'"$CSS"'</style>' \
159
+ index.html > dist/index.html
160
+ ```
161
+
162
+ > [!IMPORTANT]
163
+ > Keep source files separate (index.html + styles.css) for development.
164
+ > Only the dist/ version gets the inlined CSS for production.
165
+
166
+ ---
167
+
168
+ ### [P3] Cache Headers (.htaccess Template)
169
+
170
+ **Impact:** Fixes "Use efficient cache policy" audit
171
+
172
+ ```apache
173
+ # === PageSpeed Cache & Compression — Ready to Deploy ===
174
+
175
+ <IfModule mod_expires.c>
176
+ ExpiresActive On
177
+ ExpiresDefault "access plus 1 month"
178
+ ExpiresByType text/html "access plus 1 hour"
179
+ ExpiresByType text/css "access plus 1 year"
180
+ ExpiresByType application/javascript "access plus 1 year"
181
+ ExpiresByType image/svg+xml "access plus 1 year"
182
+ ExpiresByType image/png "access plus 1 year"
183
+ ExpiresByType image/webp "access plus 1 year"
184
+ ExpiresByType font/woff2 "access plus 1 year"
185
+ ExpiresByType application/font-woff2 "access plus 1 year"
186
+ </IfModule>
187
+
188
+ <IfModule mod_headers.c>
189
+ <FilesMatch "\.(css|js|svg|png|webp|woff2|ico)$">
190
+ Header set Cache-Control "public, max-age=31536000, immutable"
191
+ </FilesMatch>
192
+ <FilesMatch "\.(html|php)$">
193
+ Header set Cache-Control "public, max-age=3600, must-revalidate"
194
+ </FilesMatch>
195
+ <FilesMatch "\.(txt|xml)$">
196
+ Header set Cache-Control "public, max-age=86400"
197
+ </FilesMatch>
198
+ </IfModule>
199
+
200
+ # Gzip Compression
201
+ <IfModule mod_deflate.c>
202
+ AddOutputFilterByType DEFLATE text/html text/css application/javascript
203
+ AddOutputFilterByType DEFLATE text/javascript application/json text/xml
204
+ AddOutputFilterByType DEFLATE image/svg+xml text/plain
205
+ </IfModule>
206
+ ```
207
+
208
+ ---
209
+
210
+ ### [P4] CLS Prevention Checklist
211
+
212
+ | Element | Required Fix |
213
+ |---------|-------------|
214
+ | `<img>` tags | Add `width` and `height` attributes |
215
+ | CSS-loaded fonts | Use `font-display: swap` |
216
+ | CSS loading | NEVER use `media="print" onload` trick |
217
+ | Dynamic content | Reserve space with min-height |
218
+ | Embeds/iframes | Set explicit dimensions |
219
+
220
+ ---
221
+
222
+ ## 🎨 Accessibility — Contrast Ratio Reference
223
+
224
+ ### The Rule
225
+ WCAG AA requires **4.5:1** contrast ratio for normal text, **3:1** for large text (18px+ or 14px+ bold).
226
+
227
+ ### Common Color Combos on Dark Backgrounds (#0B0C15)
228
+
229
+ | Text Color | Hex | Ratio vs #0B0C15 | Pass? |
230
+ |-----------|-----|:-----------------:|:-----:|
231
+ | Pure white | `#ffffff` | 19.2:1 | ✅ |
232
+ | Light gray | `#d4dde3` | 12.5:1 | ✅ |
233
+ | Medium gray | `#a0b0b8` | 6.5:1 | ✅ |
234
+ | Muted gray | `#b0bec5` | 8.0:1 | ✅ |
235
+ | Dim gray | `#6b7b8a` | 3.7:1 | ❌ |
236
+ | Very dim | `#4a5568` | 2.3:1 | ❌ |
237
+
238
+ ### Common Color Combos on Orange (#E8632B)
239
+
240
+ | Text Color | Hex | Ratio vs #E8632B | Pass? |
241
+ |-----------|-----|:-----------------:|:-----:|
242
+ | White | `#ffffff` | 3.3:1 | ❌ FAIL |
243
+ | Light cream | `#fff5e6` | 3.1:1 | ❌ FAIL |
244
+ | Dark brown | `#1a0800` | 8.5:1 | ✅ |
245
+ | Black | `#000000` | 4.0:1 | ✅ (large) |
246
+
247
+ > [!WARNING]
248
+ > **White text on orange buttons is a classic fail.** Ratio is only 3.3:1.
249
+ > Use dark text (`#1a0800`) instead for buttons, badges, and active states with orange backgrounds.
250
+
251
+ ### Elements Commonly Flagged by PageSpeed
252
+ 1. **CTA buttons** (`.btn-primary`) — white on primary color
253
+ 2. **Active language buttons** (`.lang-btn.active`) — white on primary
254
+ 3. **Pricing badges** ("Most Popular") — white on primary
255
+ 4. **Footer text** — dim on very dark background
256
+ 5. **Form labels** — muted on dark
257
+ 6. **Badge text** (partner badges, sponsor badges) — muted on dark with transparency
258
+
259
+ ---
260
+
261
+ ## 📊 Score Tracking Template
262
+
263
+ ```markdown
264
+ | Iteration | Perf (M) | A11y (M) | Perf (D) | A11y (D) | BP | SEO | Changes |
265
+ |:---------:|:--------:|:--------:|:--------:|:--------:|:---:|:---:|---------|
266
+ | Baseline | ? | ? | ? | ? | ? | ? | Initial |
267
+ | #1 | | | | | | | |
268
+ | #2 | | | | | | | |
269
+ ```
270
+
271
+ ---
272
+
273
+ ## 🔧 PageSpeed JavaScript Extraction Snippets
274
+
275
+ Use these in the browser to extract structured data from PageSpeed results:
276
+
277
+ ### Extract All Scores
278
+ ```javascript
279
+ JSON.stringify({
280
+ gauges: Array.from(document.querySelectorAll('.lh-gauge__percentage'))
281
+ .map(g => g.textContent.trim()),
282
+ labels: Array.from(document.querySelectorAll('.lh-gauge__label'))
283
+ .map(l => l.textContent.trim())
284
+ });
285
+ ```
286
+
287
+ ### Extract Core Web Vitals
288
+ ```javascript
289
+ JSON.stringify({
290
+ metrics: Array.from(document.querySelectorAll('.lh-metric'))
291
+ .map(m => ({
292
+ name: m.querySelector('.lh-metric__title')?.textContent?.trim(),
293
+ value: m.querySelector('.lh-metric__value')?.textContent?.trim()
294
+ }))
295
+ });
296
+ ```
297
+
298
+ ### Extract Failing Audits
299
+ ```javascript
300
+ JSON.stringify({
301
+ failed: Array.from(document.querySelectorAll('.lh-audit--fail .lh-audit__title'))
302
+ .map(a => a.textContent.trim().substring(0, 150)),
303
+ warnings: Array.from(document.querySelectorAll('.lh-audit--average .lh-audit__title'))
304
+ .map(a => a.textContent.trim().substring(0, 150))
305
+ });
306
+ ```
307
+
308
+ ---
309
+
310
+ ## 🏁 Exit Conditions
311
+
312
+ The PageSpeed Perfection Loop STOPS when:
313
+ - ✅ **ALL 4 scores = 100/100** → Perfection achieved
314
+ - ⚠️ **After 8 iterations** → Report remaining issues with root cause analysis
315
+ - 🟡 **Only server-side issues remain** (TTFB, CDN, HTTP/2) → Report as "requires server-side changes"
316
+ - 🟡 **Only third-party script issues remain** (Cloudflare Turnstile, analytics) → Report as "not fixable client-side"
317
+
318
+ ---
319
+
320
+ *Built with ❤️ in Montpellier, France — by Laurent ROCHETTA × AI*
package/oveanet-pack/seo-audit-360/ref/cwv-thresholds.md ADDED
@@ -0,0 +1,87 @@
1
+ # Core Web Vitals — Thresholds & Optimization Guide (March 2026)
2
+
3
+ > Author: Laurent Rochetta | BMAD+ SEO Engine v2.0
4
+
5
+ ## Current Metrics
6
+
7
+ | Metric | Good | Needs Improvement | Poor |
8
+ |--------|------|-------------------|------|
9
+ | **LCP** (Largest Contentful Paint) | ≤2.5s | 2.5–4.0s | >4.0s |
10
+ | **INP** (Interaction to Next Paint) | ≤200ms | 200–500ms | >500ms |
11
+ | **CLS** (Cumulative Layout Shift) | ≤0.1 | 0.1–0.25 | >0.25 |
12
+
13
+ > **INP replaced FID on March 12, 2024.** FID was fully removed from all Chrome tools on September 9, 2024. Never reference FID.
14
+
15
+ ## Key Facts
16
+ - Evaluation uses the **75th percentile** of real user data (CrUX field data)
17
+ - Assessment at **page level** AND **origin level**
18
+ - CWV is a **tiebreaker** signal — matters most when content quality is similar
19
+ - Thresholds **unchanged since original definitions**
20
+ - December 2025 core update appeared to weight **mobile CWV more heavily**
21
+ - As of October 2025: 57.1% desktop, 49.7% mobile sites pass all three CWV
22
+ - **Mobile-first indexing 100% complete** since July 5, 2024
23
+
24
+ ## LCP Diagnostic Subparts (Feb 2025 CrUX)
25
+
26
+ | Subpart | Description | Target |
27
+ |---------|-------------|--------|
28
+ | TTFB | Server response time | <800ms |
29
+ | Resource Load Delay | TTFB to resource request | Minimize |
30
+ | Resource Load Time | LCP resource download | Size-dependent |
31
+ | Element Render Delay | Loaded to painted | Minimize |
32
+
33
+ **Total LCP = TTFB + Load Delay + Load Time + Render Delay**
34
+
35
+ ## Common Bottlenecks
36
+
37
+ ### LCP
38
+ - Unoptimized hero images → use WebP/AVIF, add `<link rel="preload">`
39
+ - Render-blocking CSS/JS → defer, async, critical CSS inline
40
+ - Slow TTFB (>200ms) → CDN, caching, edge compute
41
+ - Third-party blocking → defer analytics, chat widgets
42
+ - Font delay → `font-display: swap` + preload
43
+
44
+ ### INP
45
+ - Long JS tasks on main thread → break tasks <50ms, use `scheduler.yield()`
46
+ - Heavy event handlers → debounce, requestAnimationFrame
47
+ - Excessive DOM (>1,500 elements)
48
+ - Third-party scripts hijacking main thread
49
+ - Layout thrashing (forced reflows)
50
+
51
+ ### CLS
52
+ - Images/iframes without width/height dimensions
53
+ - Dynamic content injected above existing content
54
+ - Font swap causing layout shift → preload + font-display
55
+ - Ads/embeds without reserved space
56
+
57
+ ## Measurement Sources
58
+
59
+ ### Field Data (used for ranking)
60
+ - Chrome User Experience Report (CrUX)
61
+ - PageSpeed Insights (uses CrUX)
62
+ - Search Console Core Web Vitals report
63
+
64
+ ### Lab Data (for debugging)
65
+ - Lighthouse 13.0 (Oct 2025, restructured audits)
66
+ - WebPageTest
67
+ - Chrome DevTools
68
+
69
+ ## Optimization Priority
70
+ 1. **LCP** — Most impactful for perceived performance
71
+ 2. **CLS** — Most common UX issue
72
+ 3. **INP** — Critical for interactive applications
73
+
74
+ ## API Tools
75
+ ```bash
76
+ # PageSpeed Insights API
77
+ curl "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=URL&key=API_KEY"
78
+
79
+ # Lighthouse CLI
80
+ npx lighthouse URL --output json --output-path report.json
81
+ ```
82
+
83
+ ## 2025–2026 Updates
84
+ - **Lighthouse 13.0** (Oct 2025): reorganized performance categories
85
+ - **CrUX Vis** replaced CrUX Dashboard (Nov 2025) → cruxvis.withgoogle.com
86
+ - **LCP subparts** in CrUX (Feb 2025)
87
+ - **Soft Navigations API** (Chrome 139+, July 2025): experimental SPA CWV measurement — no ranking impact yet
package/oveanet-pack/seo-audit-360/ref/eeat-criteria.md ADDED
@@ -0,0 +1,123 @@
1
+ # E-E-A-T Evaluation Criteria (March 2026)
2
+
3
+ > Author: Laurent Rochetta | BMAD+ SEO Engine v2.0
4
+ > Based on: Google Quality Rater Guidelines (September 2025 update)
5
+
6
+ ## Overview
7
+
8
+ E-E-A-T = **Experience, Expertise, Authoritativeness, Trustworthiness**
9
+
10
+ Google's quality raters evaluate pages on these four dimensions. While not a direct ranking factor, E-E-A-T signals influence how Google's algorithms assess content quality and YMYL (Your Money or Your Life) pages.
11
+
12
+ > Since March 2024, the Helpful Content System is merged into Google's core algorithm. Enforcement is continuous, not via separate HCU updates.
13
+
14
+ ---
15
+
16
+ ## Experience (25 points)
17
+
18
+ First-hand, real-world experience with the topic.
19
+
20
+ | Signal | Points | How to Detect |
21
+ |--------|--------|---------------|
22
+ | Original research or case studies | 8 | Unique data, before/after results, proprietary findings |
23
+ | First-hand process documentation | 6 | Step-by-step from personal experience, production screenshots |
24
+ | Unique media from direct experience | 6 | Original photos, self-recorded videos, personal screenshots |
25
+ | Specific examples and anecdotes | 5 | Named examples, concrete details, real scenarios |
26
+
27
+ **Red flags**: Generic advice that could come from any source, stock photos only, no personal perspective.
28
+
29
+ ---
30
+
31
+ ## Expertise (25 points)
32
+
33
+ Demonstrable knowledge and skill in the subject area.
34
+
35
+ | Signal | Points | How to Detect |
36
+ |--------|--------|---------------|
37
+ | Author credentials visible | 7 | Bio with qualifications, certifications, professional background |
38
+ | Technical depth appropriate | 7 | Correct terminology, nuanced explanations, awareness of edge cases |
39
+ | Well-sourced claims | 6 | Citations to studies, official documentation, linked sources |
40
+ | Comprehensive topic coverage | 5 | Covers subtopics, addresses counterarguments, FAQ sections |
41
+
42
+ **Red flags**: No author identified, surface-level coverage, factual errors, outdated information.
43
+
44
+ ---
45
+
46
+ ## Authoritativeness (25 points)
47
+
48
+ Recognition as a trusted source by peers and industry.
49
+
50
+ | Signal | Points | How to Detect |
51
+ |--------|--------|---------------|
52
+ | External citations / references | 7 | Backlinks from authoritative sites, cited in industry publications |
53
+ | Brand recognition signals | 7 | Awards, partnerships, media mentions, client logos |
54
+ | Author published elsewhere | 6 | Guest posts, conference talks, books, academic papers |
55
+ | Expert endorsements | 5 | Testimonials from peers, quoted by other experts |
56
+
57
+ **Red flags**: Brand-new domain with no web presence, no external references, no social proof.
58
+
59
+ ---
60
+
61
+ ## Trustworthiness (25 points)
62
+
63
+ Transparency, accuracy, and confidence in the source.
64
+
65
+ | Signal | Points | How to Detect |
66
+ |--------|--------|---------------|
67
+ | Contact info and physical address | 7 | Phone, email, postal address, About page |
68
+ | Privacy policy and terms | 5 | Legal pages present, accessible, and up-to-date |
69
+ | HTTPS and security signals | 5 | Valid SSL, HSTS, security headers present |
70
+ | Transparent authorship and dates | 5 | Author byline, publication date, last updated date |
71
+ | Customer proof | 3 | Verified reviews, testimonials, case studies |
72
+
73
+ **Red flags**: No contact information, anonymous content, no dates, misleading claims, HTTP only.
74
+
75
+ ---
76
+
77
+ ## YMYL Pages — Higher Standards
78
+
79
+ YMYL (Your Money or Your Life) topics require **elevated E-E-A-T**:
80
+
81
+ | YMYL Category | Examples | E-E-A-T Bar |
82
+ |---------------|----------|-------------|
83
+ | Health | Medical advice, symptoms, treatments | Very High — requires medical expertise |
84
+ | Finance | Investment, tax, insurance, banking | Very High — requires financial credentials |
85
+ | Safety | Product safety, emergency info | Very High |
86
+ | Legal | Legal rights, contracts, regulations | Very High — requires legal expertise |
87
+ | News | Current events, political coverage | High — requires journalistic standards |
88
+ | Shopping | Product reviews, comparisons | Moderate-High |
89
+
90
+ ---
91
+
92
+ ## AI Content Assessment (Sept 2025 QRG Addition)
93
+
94
+ Google raters now formally assess AI-generated content.
95
+
96
+ ### Acceptable AI Content
97
+ - Demonstrates genuine E-E-A-T despite AI assistance
98
+ - Provides unique value (not just rephrased existing content)
99
+ - Has clear human oversight and editing
100
+ - Contains original analysis, insights, or perspective
101
+ - Includes first-party data or real-world evidence
102
+
103
+ ### Low-Quality AI Content Markers
104
+ - Generic phrasing with no specificity
105
+ - Repetitive structure across multiple pages (cookie-cutter)
106
+ - No original insights or unique data
107
+ - Missing author attribution entirely
108
+ - Factual inaccuracies or hallucinated statistics
109
+ - Excessive use of filler words and hedging language
110
+
111
+ ---
112
+
113
+ ## Scoring Methodology
114
+
115
+ **Total E-E-A-T Score = Experience + Expertise + Authoritativeness + Trustworthiness (out of 100)**
116
+
117
+ | Range | Rating | Interpretation |
118
+ |-------|--------|---------------|
119
+ | 80–100 | Excellent | Strong signals across all dimensions |
120
+ | 60–79 | Good | Solid foundation with room to improve |
121
+ | 40–59 | Needs Work | Significant gaps in one or more areas |
122
+ | 20–39 | Poor | Major deficiencies undermining credibility |
123
+ | 0–19 | Critical | Lacking basic trust and expertise signals |
package/oveanet-pack/seo-audit-360/ref/geo-signals.md ADDED
@@ -0,0 +1,167 @@
1
+ # GEO Signals — AI Search Optimization Guide (March 2026)
2
+
3
+ > Author: Laurent Rochetta | BMAD+ SEO Engine v2.0
4
+
5
+ ## What is GEO?
6
+
7
+ **Generative Engine Optimization (GEO)** is the discipline of optimizing content for AI-generated answers across Google AI Overviews, ChatGPT, Perplexity, Bing Copilot, and other AI-powered search experiences.
8
+
9
+ ## AI Search Landscape
10
+
11
+ | Platform | Reach | Key Citation Sources |
12
+ |----------|-------|---------------------|
13
+ | Google AI Overviews | 1.5B users/month, 200+ countries, 50%+ query coverage | Top-10 ranking pages (92%) |
14
+ | Google AI Mode | Full conversational search (May 2025), zero organic links | Citation is the only visibility mechanism |
15
+ | ChatGPT Search | 900M weekly active users | Wikipedia (47.9%), Reddit (11.3%) |
16
+ | Perplexity | 500M+ monthly queries | Reddit (46.7%), Wikipedia |
17
+ | Bing Copilot | Integrated in Edge/Windows | Bing index, authoritative sites |
18
+
19
+ > AI-referred sessions grew **527%** between January and May 2025 (SparkToro).
20
+
21
+ ---
22
+
23
+ ## The Brand Mention Revolution
24
+
25
+ **Brand mentions correlate 3× more strongly with AI visibility than backlinks.**
26
+ (Ahrefs December 2025 study, 75,000 brands)
27
+
28
+ | Signal | Correlation with AI Citations |
29
+ |--------|-------------------------------|
30
+ | YouTube mentions | ~0.737 (strongest) |
31
+ | Reddit mentions | High |
32
+ | Wikipedia presence | High |
33
+ | LinkedIn presence | Moderate |
34
+ | Domain Rating (backlinks) | ~0.266 (weak) |
35
+
36
+ > Only **11%** of domains are cited by both ChatGPT and Google AI Overviews for the same query — platform-specific optimization is essential.
37
+
38
+ ---
39
+
40
+ ## GEO Scoring Criteria
41
+
42
+ ### 1. Citability (25%)
43
+
44
+ **Optimal passage length: 134–167 words** for AI citation.
45
+
46
+ | Signal | Strong | Weak |
47
+ |--------|--------|------|
48
+ | Quotable statements with facts/stats | ✅ | Vague generic statements |
49
+ | Self-contained answer blocks | ✅ | Requires surrounding context |
50
+ | Direct answer in first 40–60 words | ✅ | Buried conclusions |
51
+ | "X is..." / "X refers to..." patterns | ✅ | No definitions |
52
+ | Unique data not found elsewhere | ✅ | Commonly available info |
53
+
54
+ ### 2. Structural Readability (20%)
55
+
56
+ 92% of AI Overview citations come from top-10 pages, but 47% come from pages below position 5 — demonstrating different selection logic.
57
+
58
+ | Signal | Strong | Weak |
59
+ |--------|--------|------|
60
+ | Clean H1→H2→H3 hierarchy | ✅ | Wall of text |
61
+ | Question-based headings | ✅ | Vague headings |
62
+ | Short paragraphs (2-4 sentences) | ✅ | Long unbroken paragraphs |
63
+ | Tables for comparative data | ✅ | No structured data display |
64
+ | Lists for multi-item content | ✅ | Inline lists in sentences |
65
+
66
+ ### 3. Multi-Modal Content (15%)
67
+
68
+ Content with multi-modal elements sees **156% higher selection rates**.
69
+
70
+ - Text + relevant images
71
+ - Video content (embedded or linked)
72
+ - Infographics and charts
73
+ - Interactive tools (calculators, assessments)
74
+ - Structured data supporting media
75
+
76
+ ### 4. Authority & Brand Signals (20%)
77
+
78
+ - Author byline with credentials
79
+ - Publication and last-updated dates
80
+ - Citations to primary sources
81
+ - Organization credentials
82
+ - Entity presence in Wikipedia, Wikidata
83
+ - Active presence on Reddit, YouTube, LinkedIn
84
+
85
+ ### 5. Technical Accessibility (20%)
86
+
87
+ **AI crawlers do NOT execute JavaScript** — SSR is critical.
88
+
89
+ - Server-side rendering for core content
90
+ - AI crawler access in robots.txt
91
+ - llms.txt file presence
92
+ - RSL 1.0 licensing terms
93
+
94
+ ---
95
+
96
+ ## AI Crawler Registry
97
+
98
+ | Crawler | Owner | Purpose | Recommend |
99
+ |---------|-------|---------|-----------|
100
+ | GPTBot | OpenAI | ChatGPT web search + training | Allow |
101
+ | OAI-SearchBot | OpenAI | OpenAI search features | Allow |
102
+ | ChatGPT-User | OpenAI | ChatGPT browsing | Allow |
103
+ | ClaudeBot | Anthropic | Claude web features | Allow |
104
+ | PerplexityBot | Perplexity | Perplexity search | Allow |
105
+ | Applebot-Extended | Apple | Apple Intelligence features | Allow |
106
+ | Google-Extended | Google | Gemini training (NOT Search) | Optional |
107
+ | CCBot | Common Crawl | Open dataset training | Optional/Block |
108
+ | Bytespider | ByteDance | TikTok/Douyin AI training | Block |
109
+ | anthropic-ai | Anthropic | Claude training | Optional |
110
+ | cohere-ai | Cohere | Cohere models | Optional |
111
+
112
+ ---
113
+
114
+ ## llms.txt Standard
115
+
116
+ File at `/llms.txt` (domain root). Provides structured guidance to AI crawlers.
117
+
118
+ ```
119
+ # Site Name
120
+ > One-line description
121
+
122
+ ## Main Sections
123
+ - [Page Title](url): Description
124
+ - [Another Page](url): Description
125
+
126
+ ## Key Facts
127
+ - Important fact 1
128
+ - Important fact 2
129
+ ```
130
+
131
+ Also check for `/llms-full.txt` (expanded version).
132
+
133
+ ---
134
+
135
+ ## RSL 1.0 (Really Simple Licensing)
136
+
137
+ Machine-readable AI licensing standard (December 2025).
138
+ Backed by: Reddit, Yahoo, Medium, Quora, Cloudflare, Akamai, Creative Commons.
139
+
140
+ Check for RSL implementation and appropriate licensing terms.
141
+
142
+ ---
143
+
144
+ ## Quick Wins for AI Visibility
145
+
146
+ ### Immediate (1 day)
147
+ 1. Add "What is [topic]?" definition in first 60 words of key pages
148
+ 2. Create 134–167 word self-contained answer blocks
149
+ 3. Add question-based H2/H3 headings
150
+ 4. Include specific statistics with source attribution
151
+ 5. Add publication and update dates
152
+ 6. Allow key AI crawlers in robots.txt (GPTBot, ClaudeBot, PerplexityBot)
153
+
154
+ ### Short-term (1 week)
155
+ 1. Create `/llms.txt` file
156
+ 2. Add author bios with credentials + Wikipedia/LinkedIn links
157
+ 3. Implement Person and Organization schema
158
+ 4. Add comparison tables with structured data
159
+ 5. Ensure SSR for all critical content
160
+
161
+ ### Strategic (1-3 months)
162
+ 1. Build Wikipedia presence for brand and key people
163
+ 2. Create original research or surveys (unique citability)
164
+ 3. Establish active YouTube channel
165
+ 4. Build Reddit community presence
166
+ 5. Implement comprehensive entity linking (sameAs across platforms)
167
+ 6. Develop unique tools, calculators, or interactive content