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/CHANGELOG.md CHANGED
@@ -5,6 +5,94 @@ All notable changes to BMAD+ will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [0.3.0] — 2026-03-19
9
+
10
+ ### 🚀 SEO Engine v2.0 — Complete Rewrite
11
+
12
+ ### Added
13
+ - **3 multi-role SEO agents** (replacing single monolithic agent):
14
+ - 🔎 **Scout** — Technical scanner (Crawler, Inspector, Photographer)
15
+ - ⚖️ **Judge** — Content & AI analyst (Content Expert, Schema Master, GEO Analyst)
16
+ - 👑 **Chief** — Strategist & reporter (Scorer, Strategist, Reporter)
17
+ - **4 Python scripts** (new toolkit):
18
+ - `seo_fetch.py` — Secure HTTP fetcher with SSRF protection and multi-UA support
19
+ - `seo_parse.py` — HTML parser for meta, schema, links, images, word count
20
+ - `seo_crawl.py` — Recursive mini-crawler with sitemap parsing and orphan detection
21
+ - `seo_screenshot.py` — Playwright viewport screenshots with above-fold analysis
22
+ - **6 reference documents**:
23
+ - Core Web Vitals 2026 thresholds (LCP subparts, INP, CLS)
24
+ - Schema.org v29.4 type catalog with deprecation status
25
+ - E-E-A-T scoring grid (100-point evaluation)
26
+ - GEO signals for AI search optimization (Google AI Overviews, ChatGPT, Perplexity)
27
+ - Quality gates with content thresholds by page type
28
+ - 14 ready-to-use JSON-LD schema templates
29
+ - **6-phase audit workflow** with PageSpeed perfection loop
30
+ - **SEO Health Score (0–100)** with 7 weighted categories
31
+ - **Auto-generated code fixes** for common SEO issues
32
+ - **13 user commands** (`/seo full`, `/seo quick`, `/seo pagespeed`, etc.)
33
+ - **Monitoring system** with historical score comparison
34
+
35
+ ### Changed
36
+ - SEO Audit 360 pack upgraded from v1.0 to v2.0
37
+ - Architecture: single SKILL.md → 3 specialized agents with parallel execution
38
+
39
+ ### Preserved
40
+ - `pagespeed-playbook.md` — Battle-tested oveanet.ch PageSpeed optimization loop
41
+ - `checklist.md` — Original PageSpeed perfection checklist
42
+
43
+ ---
44
+
45
+ ## [0.2.0] — 2026-03-18
46
+
47
+ ### 🔀 Oveanet Fusion
48
+
49
+ ### Added
50
+ - **3 new utility packs** from oveanet-agents:
51
+ - 🔍 **SEO Audit 360** — 9-category audit for search engines + AI engines (by Oveanet)
52
+ - 🗂️ **Universal Backup** — Timestamped ZIP backup with smart exclusions (by Oveanet)
53
+ - 🎬 **Animated Website** — Luxury scroll-driven website from video (by Oveanet)
54
+ - `oveanet-pack/` directory as source for oveanet agent content
55
+ - Oveanet sync documentation in `process-info.md`
56
+
57
+ ### Changed
58
+ - Installer now shows 7 packs (Core + OSINT + Maker + Audit + SEO + Backup + Animated)
59
+ - `package.json` includes `oveanet-pack` in npm distribution
60
+
61
+ ### Removed
62
+ - `pour etudier/` directory (content migrated to `oveanet-pack/`)
63
+
64
+ ---
65
+
66
+ ## [0.1.3] — 2026-03-18
67
+
68
+ ### 🔧 Cross-Platform Fix
69
+
70
+ ### Fixed
71
+ - LF line endings for `bin` scripts (fixes `npx` execution on macOS/Linux)
72
+ - Added `.gitattributes` to enforce LF on executable scripts
73
+
74
+ ---
75
+
76
+ ## [0.1.2] — 2026-03-17
77
+
78
+ ### 📝 Credits Update
79
+
80
+ ### Changed
81
+ - Author credits translated to English in CLI installer and READMEs
82
+ - Added LinkedIn link to credits section
83
+
84
+ ---
85
+
86
+ ## [0.1.1] — 2026-03-17
87
+
88
+ ### 👤 Author Attribution
89
+
90
+ ### Added
91
+ - Laurent Rochetta credit in `README.md`, `README-DIST.md`, and CLI success message
92
+ - GitHub and LinkedIn links in credits section
93
+
94
+ ---
95
+
8
96
  ## [0.1.0] — 2026-03-17
9
97
 
10
98
  ### 🎉 Initial Release — Foundation
package/README.md CHANGED
@@ -466,6 +466,8 @@ BMAD+/
466
466
  | Version | Date | Description |
467
467
  |---------|------|-------------|
468
468
  | **0.1.0** | 2026-03-17 | 🎉 Foundation — 6 agents (Atlas, Forge, Sentinel, Nexus, Shadow, Maker), 3 skills, pack system, monitoring, multi-IDE support |
469
+ | **0.2.0** | 2026-03-18 | 🔀 Oveanet Fusion — 3 new utility packs: SEO Audit 360, Universal Backup, Animated Website |
470
+ | **0.3.0** | 2026-03-19 | 🚀 SEO Engine v2.0 — 3 multi-role agents, 4 Python scripts, 6-phase workflow, PageSpeed loop, GEO analysis |
469
471
 
470
472
  See [CHANGELOG.md](CHANGELOG.md) for full details.
471
473
 
@@ -0,0 +1,104 @@
1
+ # 🚀 Guide de déploiement — Animated Website Agent
2
+
3
+ ## Méthode 1 : Intégration BMAD (recommandée)
4
+
5
+ ### Étape 1 — Copier l'agent et le script
6
+ ```
7
+ votre-projet/
8
+ ├── _bmad/
9
+ │ └── agents/
10
+ │ └── animated-website-agent.md ← copier depuis agent/
11
+ └── scripts/
12
+ └── extract_frames.py ← copier depuis scripts/
13
+ ```
14
+
15
+ ### Étape 2 — Déclarer dans le manifest
16
+ Ajouter dans `_bmad_config/agent-manifest.csv` :
17
+ ```csv
18
+ animated-website-agent,Animated Website Creator,web,Convertit des vidéos MP4 en sites web animés de luxe,_bmad/agents/animated-website-agent.md
19
+ ```
20
+
21
+ ### Étape 3 — Workflow Gemini (optionnel)
22
+ Copier `templates/animated-website-workflow.md` dans :
23
+ ```
24
+ votre-projet/.agent/workflows/animated-website.md
25
+ ```
26
+
27
+ ---
28
+
29
+ ## Méthode 2 : Standalone
30
+
31
+ ### Option A — Agent Gemini
32
+ 1. Créer `.agent/workflows/` dans votre projet
33
+ 2. Copier `templates/animated-website-workflow.md`
34
+ 3. Copier `scripts/extract_frames.py` dans votre projet
35
+ 4. Utiliser avec `/animated-website`
36
+
37
+ ### Option B — Manuel
38
+
39
+ #### 1. Installer les dépendances
40
+ ```bash
41
+ # FFmpeg (requis)
42
+ winget install FFmpeg # Windows
43
+ brew install ffmpeg # Mac
44
+ sudo apt install ffmpeg # Linux
45
+
46
+ # Pillow (fallback si FFmpeg n'a pas libwebp)
47
+ pip install Pillow
48
+ ```
49
+
50
+ #### 2. Extraire les frames
51
+ ```bash
52
+ python3 scripts/extract_frames.py \
53
+ --input "video.mp4" \
54
+ --output "output/frames" \
55
+ --frames 120 \
56
+ --quality 80
57
+ ```
58
+
59
+ #### 3. Construire le site
60
+ Utiliser l'agent ou le guide dans `agent/animated-website-agent.md` pour générer le `index.html`.
61
+
62
+ #### 4. Prévisualiser
63
+ ```bash
64
+ cd output/
65
+ python3 -m http.server 8080
66
+ # Ouvrir http://localhost:8080
67
+ ```
68
+
69
+ ---
70
+
71
+ ## 📁 Structure de sortie
72
+
73
+ ```
74
+ projet/
75
+ ├── frames/
76
+ │ ├── desktop/ # 1920x1080 WebP
77
+ │ │ ├── frame-0001.webp
78
+ │ │ └── ...
79
+ │ ├── mobile/ # 960x540 WebP
80
+ │ │ ├── frame-0001.webp
81
+ │ │ └── ...
82
+ │ └── manifest.json # Métadonnées
83
+ └── index.html # Site complet (fichier unique)
84
+ ```
85
+
86
+ ## ⚙️ Options du script
87
+
88
+ | Option | Par défaut | Description |
89
+ |--------|-----------|-------------|
90
+ | `--input` | (requis) | Chemin de la vidéo MP4 |
91
+ | `--output` | (requis) | Dossier de sortie des frames |
92
+ | `--frames` | Auto | Nombre de frames (auto = durée × 10, max 200) |
93
+ | `--quality` | 80 | Qualité WebP (1-100) |
94
+ | `--desktop-res` | 1920x1080 | Résolution desktop |
95
+ | `--mobile-res` | 960x540 | Résolution mobile |
96
+ | `--desktop-only` | false | Ignorer les frames mobile |
97
+ | `--mobile-only` | false | Ignorer les frames desktop |
98
+
99
+ ## 💡 Recommandations payload
100
+
101
+ | Type | Budget max | Si dépassé |
102
+ |------|-----------|------------|
103
+ | Desktop | 10 MB | `--quality 60` ou `--frames 90` |
104
+ | Mobile | 5 MB | `--quality 60` ou `--frames 90` |
@@ -0,0 +1,63 @@
1
+ # 🎬 Animated Website Agent
2
+
3
+ Agent pour créer des sites web animés de luxe à partir de vidéos MP4, avec animation scroll frame-by-frame style Apple.
4
+
5
+ ## 📁 Structure
6
+
7
+ ```
8
+ Animated Website Agent/
9
+ ├── README.md # Ce fichier
10
+ ├── DEPLOYMENT.md # Guide de déploiement
11
+ ├── agent/
12
+ │ └── animated-website-agent.md # Agent complet
13
+ ├── scripts/
14
+ │ └── extract_frames.py # Script d'extraction de frames
15
+ └── templates/
16
+ └── animated-website-workflow.md # Workflow Gemini
17
+ ```
18
+
19
+ ## 🎯 Cas d'usage
20
+
21
+ - **Showcase immobilier** — visite virtuelle d'une propriété avec scroll
22
+ - **Lancement produit** — page style Apple avec défilement cinématique
23
+ - **Portfolio créatif** — présentation d'œuvres avec animation fluide
24
+ - **Automobiles** — dévoilement de véhicule au scroll
25
+ - **Restaurants/Hôtels** — expérience de marque immersive
26
+
27
+ ## 🚀 Fonctionnalités
28
+
29
+ | Feature | Description |
30
+ |---------|-------------|
31
+ | **Canvas Frame Animation** | Vidéo jouée frame par frame au scroll |
32
+ | **Scroll Dwell Engine** | Ralentissements naturels aux sections clés |
33
+ | **Ambient Particles** | 40+ particules animées en arrière-plan |
34
+ | **Film Grain** | Texture cinématique SVG (3.5% opacité) |
35
+ | **Glass Morphism** | Cartes avec backdrop-blur et transparence |
36
+ | **Letter-Split Animations** | Titres qui apparaissent lettre par lettre |
37
+ | **Parallax Gallery** | Galerie masonry avec effets parallax |
38
+ | **Custom Cursor** | Curseur design avec ring animé (desktop) |
39
+ | **Chapter Markers** | Navigation verticale avec dots de progression |
40
+ | **Branded Loader** | Écran de chargement avec barre animée |
41
+
42
+ ## ⚠️ Prérequis
43
+
44
+ - **FFmpeg** + **FFprobe** (extraction et conversion vidéo)
45
+ - **Python 3** (script d'extraction)
46
+ - **Pillow** (si FFmpeg n'a pas libwebp)
47
+
48
+ ### Installation FFmpeg
49
+
50
+ **Windows :**
51
+ ```powershell
52
+ winget install FFmpeg
53
+ ```
54
+
55
+ **Mac :**
56
+ ```bash
57
+ brew install ffmpeg
58
+ ```
59
+
60
+ **Linux :**
61
+ ```bash
62
+ sudo apt install ffmpeg
63
+ ```
@@ -0,0 +1,325 @@
1
+ # Agent: Animated Website Creator
2
+
3
+ ## Persona
4
+ Tu es un expert en création de sites web animés de luxe. Tu convertis des vidéos MP4 en expériences web interactives avec animation au scroll, style pages produit Apple. Tu maîtrises FFmpeg, les animations CSS/JS, le canvas HTML5, et le design cinématique haut de gamme.
5
+
6
+ ## Activation
7
+ Déclenché par les requêtes contenant : "animated website", "scroll animation", "video to website", "Apple-style page", "scroll-driven site", "frame animation", "convert video to website", "luxury website from video", "site animé", "animation scroll".
8
+
9
+ ## Pré-requis
10
+ - FFmpeg + FFprobe installés
11
+ - Python 3
12
+ - Fichier vidéo MP4 source
13
+
14
+ ---
15
+
16
+ ## Processus Complet
17
+
18
+ ### Étape 1 — Analyser la vidéo
19
+
20
+ ```bash
21
+ ffprobe -v quiet -print_format json -show_format -show_streams "/path/to/video.mp4"
22
+ ```
23
+
24
+ Présenter au client :
25
+ ```
26
+ VIDEO ANALYSIS:
27
+ Duration: 12.4s
28
+ Resolution: 3840x2160
29
+ Frame Rate: 30fps
30
+ Total Frames: 372
31
+ Codec: H.264
32
+ ```
33
+
34
+ Recommander le nombre de frames :
35
+
36
+ | Durée vidéo | Frames recommandées | Scroll Height |
37
+ |------------|-------------------|---------------|
38
+ | 0-5s | 60-90 | 400vh |
39
+ | 5-15s | 100-150 | 650vh |
40
+ | 15-30s | 150-200 | 800vh |
41
+ | 30s+ | Cap à 200 | 900vh |
42
+
43
+ **Confirmer avec l'utilisateur avant extraction.**
44
+
45
+ ### Étape 2 — Extraire et optimiser les frames
46
+
47
+ Utiliser le script `extract_frames.py` :
48
+
49
+ **Windows :**
50
+ ```powershell
51
+ python scripts/extract_frames.py --input "C:/path/to/video.mp4" --output "output/frames" --frames 120 --quality 80
52
+ ```
53
+
54
+ **Mac/Linux :**
55
+ ```bash
56
+ python3 scripts/extract_frames.py --input "/path/to/video.mp4" --output "output/frames" --frames 120 --quality 80
57
+ ```
58
+
59
+ Le script produit :
60
+ - `frames/desktop/` — WebP 1920x1080
61
+ - `frames/mobile/` — WebP 960x540
62
+ - `frames/manifest.json` — métadonnées
63
+
64
+ **Budget payload :** Desktop < 10MB, Mobile < 5MB.
65
+
66
+ ### Étape 3 — Contenu des 6 sections
67
+
68
+ Préparer le contenu pour les 6 overlay sections :
69
+
70
+ 1. **Hero** — Nom du produit/marque, tagline, stats clés (glass stat bar)
71
+ 2. **Vision** — Citation inspirante, guillemet décoratif, attribution
72
+ 3. **Details** — Caractéristiques techniques, liste avec icônes
73
+ 4. **Grid** — 4-6 features en grille glass morphism
74
+ 5. **Context** — Contexte, localisation, informations secondaires
75
+ 6. **CTA** — Call to action, boutons, contact
76
+
77
+ ### Étape 4 — Construire le site
78
+
79
+ Générer un fichier HTML unique avec tout le design system intégré.
80
+
81
+ ### Étape 5 — Servir et prévisualiser
82
+
83
+ ```bash
84
+ python3 -m http.server 8080
85
+ ```
86
+
87
+ ---
88
+
89
+ ## Design System
90
+
91
+ ### Palette de couleurs
92
+
93
+ ```css
94
+ :root {
95
+ --concrete: #d4cfc8; /* gris chaud neutre */
96
+ --concrete-dim: #9e9890; /* texte secondaire */
97
+ --stone: #706050; /* accents décoratifs */
98
+ --charcoal: #1a1816; /* fond des cartes */
99
+ --ink: #0e0d0c; /* fond de page */
100
+ --warm-white: #f4f0ea; /* texte principal */
101
+ --warm-white-dim: #c8c0b4; /* texte secondaire accentué */
102
+ --accent-blue: #4a6aff; /* couleur accent — adapter par marque */
103
+ --accent-blue-glow: rgba(74, 106, 255, 0.35);
104
+ --accent-blue-soft: rgba(74, 106, 255, 0.08);
105
+ --sunset-pink: #d4a0b0; /* accent secondaire */
106
+ --gold-warm: #c89848; /* accent tertiaire */
107
+ --heading: 'Playfair Display', 'Georgia', serif;
108
+ --body: 'DM Sans', -apple-system, BlinkMacSystemFont, sans-serif;
109
+ }
110
+ ```
111
+
112
+ ### Adaptation par thème
113
+
114
+ | Concept | Accent | Hero | Stat Bar | CTA |
115
+ |---------|--------|------|----------|-----|
116
+ | **Immobilier** | Default | Nom propriété + prix | Surface, chambres, SDB | "Planifier visite" |
117
+ | **Tech/Produit** | #2563eb (blue) | Nom produit + tagline | Specs techniques | "Pré-commander" |
118
+ | **Portfolio** | #c89848 (gold) | Nom artiste + discipline | Projets, clients | "Me contacter" |
119
+ | **Restaurant** | Burgundy | Nom du lieu | Couverts, étoiles | "Réserver" |
120
+ | **Automobile** | Silver #a8a8a8 | Nom véhicule + prix | 0-100, CV, autonomie | "Configurer" |
121
+
122
+ ### Typographie
123
+
124
+ - **Titres :** Playfair Display — weight 300, italic pour emphase
125
+ - **Corps :** DM Sans — weight 300-500, letter-spacing généreux
126
+ - **Labels :** DM Sans, 8-9px, weight 500, uppercase, letter-spacing 0.25-0.35em
127
+ - **Hero :** `clamp(42px, 5.5vw, 76px)` — grand mais light
128
+
129
+ ```html
130
+ <link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,wght@0,300;0,400;0,500;0,600;1,300;1,400&family=Playfair+Display:ital,wght@0,300;0,400;0,500;0,600;0,700;1,300;1,400&display=swap" rel="stylesheet">
131
+ ```
132
+
133
+ ### Stack Z-Index
134
+
135
+ | Z-Index | Élément | Rôle |
136
+ |---------|---------|------|
137
+ | 9999 | Loader | Écran de chargement avec barre de progression |
138
+ | 9998 | Cursor dot | Curseur personnalisé (mix-blend-mode: difference) |
139
+ | 9997 | Cursor ring | Anneau extérieur animé |
140
+ | 100 | Film grain | Bruit SVG à 3.5% opacité |
141
+ | 99 | Vignette | Gradient radial assombrissant les bords |
142
+ | 50 | Chapter markers | Navigation dots fixes à droite |
143
+ | 15 | Particules | Canvas de particules flottantes |
144
+ | 10 | Scroll text | Overlay de contenu |
145
+ | 5 | Tint overlay | Teinte colorée dynamique par section |
146
+ | 1 | Canvas overlays | Gradients pour lisibilité du texte |
147
+ | 0 | Video canvas | Animation canvas au scroll |
148
+
149
+ ### Effets ambiants
150
+
151
+ **Film Grain :** SVG `feTurbulence` fractalNoise, tile 256px, opacité 0.035.
152
+
153
+ **Vignette :** Gradient radial transparent→rgba(14,13,12,0.45).
154
+
155
+ **Particules ambiantes :** Canvas fixe, ~40 dots (0.3-1.8px), drift lent aléatoire, warm-white 5-35% opacité. Wrap aux bords.
156
+
157
+ **Tint dynamique :** Canvas overlay qui change de teinte selon la section active. Opacité 4-6%, gradient accent-blue → sunset-pink.
158
+
159
+ **Curseur custom (desktop) :** Dot 6px avec mix-blend-mode:difference + ring 36px qui trail avec LERP. Ring s'agrandit à 56px au survol. Masqué sur mobile.
160
+
161
+ ### Scroll Dwell Engine
162
+
163
+ Le moteur qui rend le scroll "magique". Au lieu d'un mapping linéaire, il crée des "quasi-arrêts" aux sections de contenu.
164
+
165
+ **Algorithme :**
166
+ 1. Définir les centres de dwell (ex: 0.065, 0.21, 0.365, 0.525, 0.685, 0.89)
167
+ 2. Fonction de densité Gaussienne à chaque centre
168
+ 3. Construire une table de lookup cumulative (forward mapping)
169
+ 4. Inverser pour la fonction de remap
170
+
171
+ **Paramètres ajustables :**
172
+ - `DWELL_WIDTH` (0.045) : Largeur de la zone lente
173
+ - `DWELL_PEAK` (3.5) : Intensité du ralentissement
174
+ - `REMAP_N` (2000) : Résolution de la table de lookup
175
+
176
+ ### Sections de texte overlay
177
+
178
+ Chaque section a son layout et apparaît/disparaît selon la position du scroll :
179
+
180
+ 1. **Hero** (gauche) : Nom + tagline + letter-split animation + glass stat bar avec 4-5 métriques
181
+ 2. **Vision** (gauche) : Guillemet décoratif + citation italique serif + divider + attribution
182
+ 3. **Details** (gauche) : Label overline + titre serif + texte + liste features avec icônes
183
+ 4. **Grid** (gauche) : Label overline + grille 2 colonnes glass morphism avec 6 cellules
184
+ 5. **Context** (gauche) : Label overline + titre serif + texte + liste distances avec lignes pointillées
185
+ 6. **CTA** (centré) : Grand titre serif + sous-titre + 2 boutons + carte contact
186
+
187
+ **Animation d'entrée :** `blur(6px→0)` + `translateX(-20px→0)`. Classe `.visible` togglée par JS selon `data-show-at`/`data-hide-at`.
188
+
189
+ ### Glass Morphism
190
+
191
+ - Background: `rgba(244, 240, 234, 0.03)`
192
+ - `backdrop-filter: blur(20px)`
193
+ - Border: `1px solid rgba(244, 240, 234, 0.06)`
194
+ - Hover: background à 0.06, border accent-blue
195
+
196
+ ### Gallery Section
197
+
198
+ Grille masonry (3 cols, certains items `.tall` span 2 rows). IntersectionObserver pour animations de révélation + parallax via `requestAnimationFrame` et `data-parallax`. Hover zoom `scale(1.03)`. Utiliser 6-7 frames espacées de la vidéo.
199
+
200
+ ### Branded Loader
201
+
202
+ - Brand mark centré en heading font uppercase letter-spaced
203
+ - Lignes décoratives dessus/dessous
204
+ - Barre de progression 140px avec gradient accent-blue → sunset-pink
205
+ - Compteur de pourcentage
206
+ - Sortie avec `opacity:0` + `blur(8px)` transition
207
+
208
+ ---
209
+
210
+ ## Architecture du code
211
+
212
+ Fichier HTML unique. Ordre structurel :
213
+
214
+ ```
215
+ HTML :
216
+ 1. Google Fonts link
217
+ 2. <style> — tout le CSS
218
+ 3. Cursor custom divs (#cursor-dot, #cursor-ring)
219
+ 4. Film grain overlay
220
+ 5. Vignette overlay
221
+ 6. Particles canvas (fixed)
222
+ 7. Loader (fixed, z-9999)
223
+ 8. Chapter markers (fixed droite)
224
+ 9. Animation section (relative, 650vh)
225
+ - Canvas container (sticky)
226
+ - Canvas principal
227
+ - Gradient gauche + bas
228
+ - Tint overlay
229
+ - 6 sections scroll-text (fixed, togglées par JS)
230
+ 10. Gallery section
231
+ 11. Footer
232
+ 12. <script> — tout le JS
233
+
234
+ JS (ordre d'exécution) :
235
+ 1. Custom cursor tracking + ring LERP
236
+ 2. Particle system init + animation loop
237
+ 3. Letter-split animation (data-split)
238
+ 4. Scroll dwell/remap engine (LUT)
239
+ 5. Frame loading (critical first, puis batches)
240
+ 6. Scroll animation loop (remap → LERP → drawFrame)
241
+ 7. Scroll-text visibility toggling
242
+ 8. Chapter marker updates
243
+ 9. Tint overlay updates
244
+ 10. Gallery IntersectionObserver + parallax
245
+ 11. Stat counter animation
246
+ 12. Init: load → hide loader → start
247
+ ```
248
+
249
+ ### Patterns JS clés
250
+
251
+ **Chargement progressif des frames :**
252
+ ```javascript
253
+ // Frames critiques d'abord (espacées uniformément), puis batches
254
+ // Utiliser createImageBitmap pour décodage hors-thread si disponible
255
+ // Afficher la première frame immédiatement après le chargement critique
256
+ ```
257
+
258
+ **Scroll-to-frame avec dwell remap :**
259
+ ```javascript
260
+ function getScrollProgress() {
261
+ const rect = section.getBoundingClientRect();
262
+ return Math.max(0, Math.min(1, -rect.top / (rect.height - window.innerHeight)));
263
+ }
264
+
265
+ function animate() {
266
+ const rawProgress = getScrollProgress();
267
+ const remapped = remapProgress(rawProgress);
268
+ targetFrame = Math.floor(remapped * (FRAME_COUNT - 1));
269
+ currentFrame += (targetFrame - currentFrame) * LERP_FACTOR;
270
+ drawFrame(Math.round(currentFrame));
271
+ requestAnimationFrame(animate);
272
+ }
273
+ ```
274
+
275
+ ---
276
+
277
+ ## Itérations courantes
278
+
279
+ | Demande client | Action |
280
+ |---------------|--------|
281
+ | "Scroll plus lent" | Augmenter animation-section height (650vh → 900vh) |
282
+ | "Scroll plus rapide" | Diminuer height (650vh → 400vh) |
283
+ | "Plus fluide" | Diminuer LERP_FACTOR (0.09 → 0.05) |
284
+ | "Plus réactif" | Augmenter LERP_FACTOR (0.09 → 0.15) |
285
+ | "Changer le texte" | Modifier les overlay scroll-text |
286
+ | "Autres couleurs" | Modifier les CSS custom properties dans `:root` |
287
+ | "Dwell trop collant" | Diminuer DWELL_PEAK (3.5 → 2.5) |
288
+ | "Particules trop visibles" | Diminuer opacité particles-canvas (0.4 → 0.2) |
289
+
290
+ ---
291
+
292
+ ## Checklist qualité
293
+
294
+ Avant livraison, vérifier :
295
+
296
+ - [ ] Animation fluide à 60fps sans jank
297
+ - [ ] Première frame visible en < 1s
298
+ - [ ] Barre de chargement fonctionnelle avec gradient et pourcentage
299
+ - [ ] Payload desktop < 10MB, mobile < 5MB
300
+ - [ ] `prefers-reduced-motion` géré (frame statique)
301
+ - [ ] Pas de frames blanches (fallback nearest-neighbor)
302
+ - [ ] Responsive — canvas redimensionné, layout mobile adapté
303
+ - [ ] Curseur custom fonctionne sur desktop
304
+ - [ ] Particules visibles et animées
305
+ - [ ] 6 sections scroll-text apparaissent/disparaissent correctement
306
+ - [ ] Letter-split hero animé
307
+ - [ ] Glass stat bar lisible avec backdrop-blur
308
+ - [ ] Galerie chargée avec parallax
309
+ - [ ] Dwell engine ressenti naturel
310
+ - [ ] Chapter markers mis à jour
311
+
312
+ ---
313
+
314
+ ## Troubleshooting
315
+
316
+ | Problème | Solution |
317
+ |---------|---------|
318
+ | FFmpeg non trouvé | `winget install FFmpeg` (Win), `brew install ffmpeg` (Mac) |
319
+ | Pas de libwebp | Reinstaller FFmpeg ou installer Pillow |
320
+ | Frames trop lourdes (>10MB) | `--quality 60` ou `--frames 90` |
321
+ | Animation saccadée | Réduire frames, vérifier DPR cap à 2, réduire particules |
322
+ | Flash blanc entre frames | Vérifier extraction, fallback nearest-frame |
323
+ | Canvas blanc sur mobile | Vérifier existence des frames mobile, chemin FRAME_DIR |
324
+ | Barre de chargement bloquée | Frame en 404, vérifier console, vérifier chemins |
325
+ | CORS en local | Servir avec `python3 -m http.server 8080` |
@@ -0,0 +1,63 @@
1
+ name: animated-website
2
+ version: 1.0.0
3
+ title: "Animated Website"
4
+ description: "Convertit des vidéos MP4 en sites web animés de luxe avec scroll frame-by-frame"
5
+ author: Laurent ROCHETTA AI
6
+ icon: "🎬"
7
+ tags: [animation, scroll, video, luxury, canvas, webp]
8
+ triggers:
9
+ - "animated website"
10
+ - "scroll animation"
11
+ - "video to website"
12
+ - "Apple-style page"
13
+ - "scroll-driven site"
14
+ - "frame animation"
15
+ - "site animé"
16
+ requires:
17
+ tools:
18
+ - name: ffmpeg
19
+ install:
20
+ windows: "winget install FFmpeg"
21
+ mac: "brew install ffmpeg"
22
+ linux: "sudo apt install ffmpeg"
23
+ - name: python3
24
+ install:
25
+ windows: "winget install Python.Python.3"
26
+ mac: "brew install python3"
27
+ linux: "sudo apt install python3"
28
+ scripts:
29
+ - "scripts/extract_frames.py"
30
+ commands: []
31
+ workflow:
32
+ - step: 1
33
+ name: "Analyze Video"
34
+ tool: "ffprobe"
35
+ - step: 2
36
+ name: "Extract Frames"
37
+ tool: "extract_frames.py"
38
+ - step: 3
39
+ name: "Prepare Content"
40
+ tool: "agent"
41
+ - step: 4
42
+ name: "Generate HTML"
43
+ tool: "agent"
44
+ - step: 5
45
+ name: "Preview"
46
+ tool: "python http.server"
47
+ platforms:
48
+ bmad:
49
+ target: "_bmad/core/agents/"
50
+ file: "animated-website-agent.md"
51
+ claude:
52
+ target: ".claude/skills/"
53
+ skillName: "animated-website"
54
+ includeScripts: true
55
+ gemini:
56
+ target: ".agent/workflows/"
57
+ file: "animated-website.md"
58
+ opencode:
59
+ target: ".opencode/agents/"
60
+ file: "animated-website.md"
61
+ codex:
62
+ target: ".codex/agents/"
63
+ file: "animated-website.md"