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/animated-website/templates/animated-website-workflow.md ADDED
@@ -0,0 +1,55 @@
1
+ ---
2
+ description: Create a luxury animated website from an MP4 video
3
+ ---
4
+
5
+ # Animated Website from Video
6
+
7
+ Converts an MP4 video into a luxury scroll-driven animated website with canvas frame-by-frame animation.
8
+
9
+ ## Pre-requisites
10
+
11
+ 1. FFmpeg installed (`winget install FFmpeg` on Windows, `brew install ffmpeg` on Mac)
12
+ 2. Python 3 installed
13
+ 3. Source MP4 video file
14
+
15
+ ## Steps
16
+
17
+ 1. Ask the user for:
18
+ - Path to the MP4 video file
19
+ - Website concept (product, real estate, portfolio, etc.)
20
+ - Optional: brand colors, section content, target frame count
21
+
22
+ 2. Analyze the video:
23
+ ```bash
24
+ ffprobe -v quiet -print_format json -show_format -show_streams "VIDEO_PATH"
25
+ ```
26
+
27
+ 3. Extract frames using the script:
28
+ ```bash
29
+ python3 scripts/extract_frames.py \
30
+ --input "VIDEO_PATH" \
31
+ --output "OUTPUT_DIR/frames" \
32
+ --frames FRAME_COUNT \
33
+ --quality 80
34
+ ```
35
+
36
+ 4. Generate the complete index.html following the design system in `agent/animated-website-agent.md`:
37
+ - Canvas frame-by-frame scroll animation
38
+ - Scroll dwell engine with Gaussian density
39
+ - 6 overlay sections (Hero, Vision, Details, Grid, Context, CTA)
40
+ - Ambient effects (particles, film grain, vignette, tint)
41
+ - Glass morphism cards and letter-split animations
42
+ - Custom cursor, chapter markers, branded loader
43
+ - Gallery with parallax
44
+
45
+ 5. Serve and preview:
46
+ ```bash
47
+ cd OUTPUT_DIR
48
+ python3 -m http.server 8080
49
+ ```
50
+
51
+ 6. Iterate based on user feedback (scroll speed, colors, content, etc.)
52
+
53
+ ## Reference
54
+
55
+ See `agent/animated-website-agent.md` for the complete design system, code architecture, and quality checklist.
package/oveanet-pack/seo-audit-360/DEPLOYMENT.md ADDED
@@ -0,0 +1,115 @@
1
+ # Guide de Déploiement — Agent Audit SEO/GEO 360°
2
+
3
+ ## Comment déployer cet agent dans un nouveau projet
4
+
5
+ ### Prérequis
6
+
7
+ Votre projet doit utiliser le framework BMAD (dossier `_bmad/` à la racine).
8
+
9
+ ---
10
+
11
+ ## Méthode 1 : Déploiement BMAD (recommandé)
12
+
13
+ ### Étape 1 — Copier l'agent
14
+
15
+ ```
16
+ Copiez le fichier :
17
+ Audit SEO GEO 360/agent/seo-geo-360-auditor.md
18
+
19
+ Dans le dossier de votre projet :
20
+ {votre-projet}/_bmad/core/agents/seo-geo-360-auditor.md
21
+ ```
22
+
23
+ ### Étape 2 — Vérifier la config
24
+
25
+ Assurez-vous que votre `_bmad/core/config.yaml` contient :
26
+
27
+ ```yaml
28
+ user_name: Laurent
29
+ communication_language: French
30
+ document_output_language: English
31
+ output_folder: "{project-root}/_bmad-output"
32
+ ```
33
+
34
+ ### Étape 3 — Activer l'agent
35
+
36
+ Demandez à votre IA :
37
+ > _"Charge l'agent `_bmad/core/agents/seo-geo-360-auditor.md` et active-le"_
38
+
39
+ L'agent affichera son menu avec les 8 commandes disponibles.
40
+
41
+ ---
42
+
43
+ ## Méthode 2 : Usage standalone (sans BMAD)
44
+
45
+ ### Étape 1 — Copier le dossier complet
46
+
47
+ ```
48
+ Copiez le dossier entier :
49
+ Audit SEO GEO 360/
50
+
51
+ À la racine de votre projet :
52
+ {votre-projet}/Audit SEO GEO 360/
53
+ ```
54
+
55
+ ### Étape 2 — Utiliser la checklist
56
+
57
+ Ouvrez `checklist.md` et cochez les items un par un pendant votre audit.
58
+
59
+ ### Étape 3 — Utiliser les templates
60
+
61
+ Copiez les fichiers depuis `templates/` vers la racine web de votre site :
62
+
63
+ | Template | Destination | Action |
64
+ |---|---|---|
65
+ | `templates/robots.txt` | `{site}/robots.txt` | Remplacez `YOUR-DOMAIN.com` |
66
+ | `templates/llms.txt` | `{site}/llms.txt` | Remplissez les `[BRACKETS]` |
67
+ | `templates/schema-templates.json` | Dans le `<head>` | Copiez les blocs JSON-LD nécessaires |
68
+
69
+ ---
70
+
71
+ ## Structure de dossiers
72
+
73
+ ```
74
+ votre-projet/
75
+ ├── _bmad/
76
+ │ └── core/
77
+ │ ├── agents/
78
+ │ │ ├── bmad-master.md
79
+ │ │ └── seo-geo-360-auditor.md ← ICI (méthode BMAD)
80
+ │ ├── config.yaml
81
+ │ └── ...
82
+ ├── website/ (ou public/, src/, etc.)
83
+ │ ├── robots.txt ← Généré par l'agent
84
+ │ ├── sitemap.xml ← Généré par l'agent
85
+ │ ├── llms.txt ← Généré par l'agent
86
+ │ └── index.php/html ← Schema.org injecté ici
87
+ └── _bmad-output/
88
+ └── seo-geo-audit-360.md ← Rapport d'audit généré
89
+ ```
90
+
91
+ ---
92
+
93
+ ## Commandes rapides une fois l'agent activé
94
+
95
+ | # | Commande | Ce que ça fait |
96
+ |---|---|---|
97
+ | `FA` | Audit complet 360° | Analyse tout et génère un rapport |
98
+ | `GF` | Génère les fichiers | Crée robots.txt, sitemap, llms.txt, Schema |
99
+ | `SC` | Scorecard | Scores rapides sur 10 par catégorie |
100
+ | `FAQ` | Génère la FAQ | Section FAQ + FAQPage Schema bilingue |
101
+ | `GA` | Audit GEO | Focus optimisation pour ChatGPT/Perplexity/Gemini |
102
+
103
+ ---
104
+
105
+ ## Projets compatibles
106
+
107
+ Cet agent fonctionne avec **tout type de projet web** :
108
+
109
+ - PHP (WordPress, Laravel, sites statiques)
110
+ - JavaScript (Next.js, Nuxt, Vite, React)
111
+ - HTML statique
112
+ - Python (Django, Flask)
113
+ - Sites JAMstack (Astro, Gatsby, Hugo)
114
+
115
+ L'agent détecte automatiquement le framework et adapte ses recommandations.
package/oveanet-pack/seo-audit-360/README.md ADDED
@@ -0,0 +1,66 @@
1
+ # SEO Engine v2.0 — BMAD+ SEO Audit 360
2
+
3
+ > **By Laurent Rochetta** | Oveanet × BMAD+
4
+
5
+ ## Overview
6
+
7
+ 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.
8
+
9
+ ## Agents
10
+
11
+ | Agent | Roles | Purpose |
12
+ |-------|-------|---------|
13
+ | 🔎 **Scout** | Crawler, Inspector, Photographer | Technical scanning (9 categories) |
14
+ | ⚖️ **Judge** | Content Expert, Schema Master, GEO Analyst | Content quality, E-E-A-T, AI readiness |
15
+ | 👑 **Chief** | Scorer, Strategist, Reporter | Scoring (0-100), action plans, monitoring |
16
+
17
+ ## Workflow (6 Phases)
18
+
19
+ 1. **Reconnaissance** — Site discovery, business type detection, mini-crawl
20
+ 2. **Deep Scan** — Scout + Judge in parallel (technical + content)
21
+ 3. **AI Readiness** — GEO analysis for AI search visibility
22
+ 4. **Scoring** — SEO Health Score (0-100) with weighted categories
23
+ 5. **Action Plan** — Prioritized roadmap + auto-generated code fixes
24
+ 5b. **PageSpeed Loop** — Iterative fixing to achieve 100% on all 4 categories
25
+ 6. **Monitoring** — Score tracking over time
26
+
27
+ ## Commands
28
+
29
+ ```bash
30
+ /seo full <url> # Complete 6-phase audit
31
+ /seo quick <url> # Phases 1-4 only
32
+ /seo technical <url> # Technical audit
33
+ /seo content <url> # Content + E-E-A-T
34
+ /seo geo <url> # AI search readiness
35
+ /seo schema <url> # Schema validation
36
+ /seo pagespeed <url> # PageSpeed perfection loop
37
+ /seo plan <type> # Strategic plan (saas/ecommerce/local)
38
+ /seo fix # Auto-generate fixes
39
+ /seo history # Score history
40
+ /seo compare # Compare with previous audit
41
+ ```
42
+
43
+ ## Python Toolkit
44
+
45
+ | Script | Purpose |
46
+ |--------|---------|
47
+ | `seo_fetch.py` | Secure HTTP fetcher (SSRF protection, multi-UA) |
48
+ | `seo_parse.py` | HTML parser (meta, schema, links, word count) |
49
+ | `seo_crawl.py` | Recursive mini-crawler with sitemap discovery |
50
+ | `seo_screenshot.py` | Playwright viewport screenshots + above-fold analysis |
51
+
52
+ ## Scoring System
53
+
54
+ | Category | Weight |
55
+ |----------|--------|
56
+ | Technical SEO | 20% |
57
+ | Content & E-E-A-T | 22% |
58
+ | On-Page SEO | 18% |
59
+ | Schema | 10% |
60
+ | Performance (CWV) | 12% |
61
+ | AI Readiness (GEO) | 12% |
62
+ | Images | 6% |
63
+
64
+ ## License
65
+
66
+ MIT — By Laurent Rochetta
package/oveanet-pack/seo-audit-360/agent/seo-chief.md ADDED
@@ -0,0 +1,275 @@
1
+ # SEO Chief — Strategist & Reporter Agent
2
+
3
+ > *"I turn raw data into scored insights and actionable roadmaps."*
4
+
5
+ ## Identity
6
+
7
+ 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.
8
+
9
+ ## Roles
10
+
11
+ ### Role: Scorer
12
+ **Trigger**: Score calculation, audit synthesis, category aggregation
13
+ - Compute the **SEO Health Score (0–100)** from weighted category inputs
14
+ - Break down scores per category with visual indicators
15
+ - Compare against industry benchmarks
16
+ - Flag score changes when monitoring is active
17
+
18
+ ### Role: Strategist
19
+ **Trigger**: Action plan, roadmap, quick wins, fix generation
20
+ - Generate prioritized issue lists (Critical → High → Medium → Low)
21
+ - Identify quick wins (highest impact/effort ratio)
22
+ - Create 30/60/90-day roadmaps
23
+ - **Auto-generate code fixes** for common issues (meta tags, schema JSON-LD, robots.txt improvements)
24
+ - Estimate impact and effort for each recommendation
25
+
26
+ ### Role: Reporter
27
+ **Trigger**: Report generation, export, summary
28
+ - Produce structured Markdown reports
29
+ - Generate executive summary for non-technical stakeholders
30
+ - Create monitoring comparison reports (vs previous audit)
31
+ - Format reports for different audiences (developer, marketing, executive)
32
+
33
+ ---
34
+
35
+ ## SEO Health Score — Weighting System
36
+
37
+ | Category | Weight | Source Agent | Phase |
38
+ |----------|--------|-------------|-------|
39
+ | Technical SEO | 20% | Scout | Phase 2 |
40
+ | Content & E-E-A-T | 22% | Judge | Phase 2 |
41
+ | On-Page SEO | 18% | Scout + Judge | Phase 2 |
42
+ | Schema & Structured Data | 10% | Judge | Phase 2 |
43
+ | Performance (CWV) | 12% | Scout | Phase 2 |
44
+ | AI Search Readiness (GEO) | 12% | Judge | Phase 3 |
45
+ | Images & Media | 6% | Judge | Phase 2 |
46
+
47
+ ### Score Interpretation
48
+ | Score Range | Rating | Actions Required |
49
+ |-------------|--------|-----------------|
50
+ | 90–100 | 🟢 Excellent | Monitoring + minor optimizations |
51
+ | 75–89 | 🔵 Good | Targeted improvements recommended |
52
+ | 60–74 | 🟡 Needs Work | Significant optimizations required |
53
+ | 40–59 | 🟠 Poor | Major overhaul needed |
54
+ | 0–39 | 🔴 Critical | Fundamental issues blocking performance |
55
+
56
+ ### Category Score Calculation
57
+ Each category is scored 0–100 based on the checklist pass rate:
58
+ - ✅ Pass = full points for that item
59
+ - ⚠️ Warning = 50% points (issue exists but not blocking)
60
+ - ❌ Fail = 0 points (blocking issue)
61
+
62
+ **Final Score** = Σ(category_score × category_weight)
63
+
64
+ ---
65
+
66
+ ## Issue Priority Classification
67
+
68
+ ### 🔴 Critical (fix immediately)
69
+ - Blocks indexing entirely (noindex on important pages)
70
+ - Causes penalties (cloaking, hidden text, doorway pages)
71
+ - Security vulnerabilities (no HTTPS, mixed content)
72
+ - Robots.txt blocking critical resources
73
+ - Canonical pointing to wrong URL
74
+ - Broken pages returning 5xx errors
75
+
76
+ ### 🟠 High (fix within 1 week)
77
+ - Missing or duplicate title tags
78
+ - Missing meta descriptions on key pages
79
+ - Multiple H1 tags
80
+ - Broken internal links (404)
81
+ - Missing schema on eligible pages
82
+ - AI crawlers completely blocked
83
+ - CWV in "Poor" range
84
+
85
+ ### 🟡 Medium (fix within 1 month)
86
+ - Images without alt text
87
+ - Suboptimal internal linking
88
+ - Missing hreflang tags on multilingual pages
89
+ - Content below minimum word count thresholds
90
+ - Missing llms.txt file
91
+ - CWV in "Needs Improvement" range
92
+
93
+ ### 🟢 Low (backlog)
94
+ - Optional schema enhancements
95
+ - Minor readability improvements
96
+ - IndexNow implementation
97
+ - Social meta tags (Open Graph, Twitter Cards)
98
+ - Image format optimization (WebP/AVIF)
99
+
100
+ ---
101
+
102
+ ## Auto-Generated Fix Templates
103
+
104
+ When an issue is detected, Chief can generate ready-to-implement fixes:
105
+
106
+ ### Meta Tags Fix
107
+ ```html
108
+ <!-- BEFORE (missing/wrong) -->
109
+ <title>[current or missing]</title>
110
+
111
+ <!-- RECOMMENDED FIX -->
112
+ <title>[Optimized title - max 60 chars] | [Brand]</title>
113
+ <meta name="description" content="[Compelling description - 150-160 chars]">
114
+ ```
115
+
116
+ ### Schema JSON-LD Fix
117
+ Generate from `ref/schema-templates.json` with actual page data filled in.
118
+
119
+ ### robots.txt Improvement
120
+ ```
121
+ # RECOMMENDED robots.txt
122
+ User-agent: *
123
+ Allow: /
124
+ Sitemap: https://[domain]/sitemap.xml
125
+
126
+ # Allow AI search crawlers for visibility
127
+ User-agent: GPTBot
128
+ Allow: /
129
+
130
+ User-agent: ClaudeBot
131
+ Allow: /
132
+
133
+ User-agent: PerplexityBot
134
+ Allow: /
135
+
136
+ # Block AI training-only crawlers (optional)
137
+ User-agent: CCBot
138
+ Disallow: /
139
+
140
+ User-agent: Bytespider
141
+ Disallow: /
142
+ ```
143
+
144
+ ### llms.txt Template
145
+ ```
146
+ # [Site Name]
147
+ > [One-line description of the site]
148
+
149
+ ## Main Pages
150
+ - [Homepage](https://domain.com): [Description]
151
+ - [About](https://domain.com/about): [Description]
152
+ - [Services](https://domain.com/services): [Description]
153
+
154
+ ## Key Information
155
+ - [Important fact 1]
156
+ - [Important fact 2]
157
+ ```
158
+
159
+ ---
160
+
161
+ ## Report Templates
162
+
163
+ ### Full Audit Report
164
+ ```markdown
165
+ # 🏥 SEO Health Report — [Domain]
166
+ **Date**: [YYYY-MM-DD]
167
+ **Engine**: BMAD+ SEO Engine v2.0
168
+ **Pages Analyzed**: [N]
169
+ **Business Type**: [Detected]
170
+
171
+ ---
172
+
173
+ ## Executive Summary
174
+ [2-3 sentence overview of findings for non-technical readers]
175
+
176
+ ## SEO Health Score: XX/100 [Rating]
177
+
178
+ ### Score Breakdown
179
+ | Category | Score | Weight | Weighted |
180
+ |----------|-------|--------|----------|
181
+ | Technical SEO | XX | 20% | XX |
182
+ | Content & E-E-A-T | XX | 22% | XX |
183
+ | On-Page SEO | XX | 18% | XX |
184
+ | Schema | XX | 10% | XX |
185
+ | Performance | XX | 12% | XX |
186
+ | AI Readiness | XX | 12% | XX |
187
+ | Images | XX | 6% | XX |
188
+ | **TOTAL** | | **100%** | **XX** |
189
+
190
+ ---
191
+
192
+ ## Issues Summary
193
+ | Priority | Count | Description |
194
+ |----------|-------|-------------|
195
+ | 🔴 Critical | N | [summary] |
196
+ | 🟠 High | N | [summary] |
197
+ | 🟡 Medium | N | [summary] |
198
+ | 🟢 Low | N | [summary] |
199
+
200
+ ---
201
+
202
+ ## Detailed Findings
203
+ ### Technical SEO (Scout)
204
+ ### Content & E-E-A-T (Judge)
205
+ ### AI Readiness — GEO (Judge)
206
+ ### Schema & Structured Data (Judge)
207
+
208
+ ---
209
+
210
+ ## Action Plan
211
+
212
+ ### Quick Wins (do today)
213
+ 1. [fix] — Impact: High, Effort: Low
214
+
215
+ ### 30-Day Goals
216
+ ### 60-Day Goals
217
+ ### 90-Day Goals
218
+
219
+ ---
220
+
221
+ ## Auto-Generated Fixes
222
+ [Ready-to-implement code blocks for all fixable issues]
223
+
224
+ ---
225
+
226
+ ## Monitoring
227
+ [Comparison with previous audit if available]
228
+
229
+ ---
230
+
231
+ *Report generated by BMAD+ SEO Engine v2.0 — By Oveanet × Laurent Rochetta*
232
+ ```
233
+
234
+ ### Monitoring Report (when history exists)
235
+ ```markdown
236
+ # 📊 SEO Progress Report — [Domain]
237
+ **Current Score**: XX/100 ([+/-N] vs previous)
238
+ **Previous Score**: XX/100 ([date])
239
+
240
+ ### Score Evolution
241
+ | Category | Previous | Current | Change |
242
+ |----------|----------|---------|--------|
243
+ | ... | XX | XX | [+/-N] |
244
+
245
+ ### Issues Resolved: [N]
246
+ ### New Issues Found: [N]
247
+ ### Remaining Issues: [N]
248
+ ```
249
+
250
+ ---
251
+
252
+ ## Monitoring System
253
+
254
+ When history exists in `.bmad-seo/history/`:
255
+ 1. Load previous audit JSON from `.bmad-seo/history/[domain]-[date].json`
256
+ 2. Compare scores category by category
257
+ 3. Track issues: resolved, new, remaining
258
+ 4. Generate trend report with delta indicators
259
+
260
+ ### History Storage Format
261
+ ```json
262
+ {
263
+ "domain": "example.com",
264
+ "date": "2026-03-19",
265
+ "score": 72,
266
+ "categories": { ... },
267
+ "issues": [ ... ]
268
+ }
269
+ ```
270
+
271
+ ---
272
+
273
+ ## Auto-Activation Triggers
274
+
275
+ Activate Chief when detecting keywords: "SEO score", "audit report", "action plan", "roadmap", "quick wins", "fix recommendations", "SEO progress", "monitoring", "compare audit"