bmad-plus 0.12.0 → 0.12.2

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 (160) hide show
  1. package/CHANGELOG.md +612 -554
  2. package/README.md +557 -577
  3. package/osint-agent-package/agents/osint-investigator.md +12 -0
  4. package/osint-agent-package/skills/bmad-osint-investigate/osint/SKILL.md +491 -482
  5. package/osint-agent-package/skills/bmad-osint-investigate/osint/assets/dossier-template.md +126 -126
  6. package/osint-agent-package/skills/bmad-osint-investigate/osint/assets/lawful-basis-record.md +48 -48
  7. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/content-extraction.md +100 -100
  8. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/gdpr-osint.md +48 -48
  9. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/platforms.md +130 -130
  10. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/psychoprofile.md +69 -69
  11. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/tools.md +281 -281
  12. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/mcp-client.py +136 -136
  13. package/package.json +104 -91
  14. package/readme-international/README.de.md +596 -589
  15. package/readme-international/README.es.md +613 -606
  16. package/readme-international/README.fr.md +611 -604
  17. package/src/bmad-plus/agents/agent-shadow/SKILL.md +18 -0
  18. package/src/bmad-plus/data/role-triggers.yaml +52 -0
  19. package/src/bmad-plus/module.yaml +283 -283
  20. package/src/bmad-plus/packs/pack-animated/animated-website-agent.md +325 -325
  21. package/src/bmad-plus/packs/pack-animated/templates/animated-website-workflow.md +55 -55
  22. package/src/bmad-plus/packs/pack-backup/backup-agent.md +71 -71
  23. package/src/bmad-plus/packs/pack-backup/templates/backup-workflow.md +51 -51
  24. package/src/bmad-plus/packs/pack-dev-studio/README.md +162 -162
  25. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/analyst-agent.md +73 -73
  26. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/document-project.md +61 -61
  27. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/domain-research.md +95 -95
  28. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/market-research.md +95 -95
  29. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/prfaq.md +134 -134
  30. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/product-brief.md +80 -80
  31. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/tech-writer-agent.md +73 -73
  32. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/technical-research.md +95 -95
  33. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/architect-agent.md +73 -73
  34. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-architecture.md +73 -73
  35. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-epics-stories.md +92 -92
  36. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/generate-project-context.md +80 -80
  37. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/implementation-readiness.md +90 -90
  38. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01-init.md +153 -153
  39. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01b-continue.md +173 -173
  40. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-02-context.md +224 -224
  41. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-03-starter.md +329 -329
  42. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-04-decisions.md +318 -318
  43. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-05-patterns.md +359 -359
  44. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-06-structure.md +379 -379
  45. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-07-validation.md +361 -361
  46. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-08-complete.md +81 -81
  47. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/checkpoint-preview.md +67 -67
  48. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-01-gather-context.md +85 -85
  49. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-02-review.md +35 -35
  50. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-03-triage.md +49 -49
  51. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-04-present.md +131 -131
  52. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review.md +89 -89
  53. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/correct-course.md +300 -300
  54. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/create-story.md +428 -428
  55. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-agent.md +73 -73
  56. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story-checklist.md +80 -80
  57. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story.md +484 -484
  58. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/investigate.md +193 -193
  59. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/qa-e2e-tests.md +175 -175
  60. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/quick-dev.md +110 -110
  61. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/retrospective.md +1511 -1511
  62. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-planning.md +298 -298
  63. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-status.md +296 -296
  64. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-prd.md +29 -29
  65. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-ux-design.md +74 -74
  66. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/edit-prd.md +29 -29
  67. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/pm-agent.md +73 -73
  68. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/prd.md +89 -89
  69. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/ux-designer-agent.md +73 -73
  70. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/validate-prd.md +29 -29
  71. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/advanced-elicitation.md +141 -141
  72. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/adversarial-review.md +37 -37
  73. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/bmad-help.md +75 -75
  74. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/brainstorming.md +6 -6
  75. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/customize.md +110 -110
  76. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/distillator.md +176 -176
  77. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/edge-case-hunter.md +67 -67
  78. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-prose.md +86 -86
  79. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-structure.md +179 -179
  80. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/index-docs.md +66 -66
  81. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/party-mode.md +127 -127
  82. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/shard-doc.md +105 -105
  83. package/src/bmad-plus/packs/pack-dev-studio/dev-studio-orchestrator.md +120 -120
  84. package/src/bmad-plus/packs/pack-dev-studio/shared/architecture-decision-template.md +12 -12
  85. package/src/bmad-plus/packs/pack-dev-studio/shared/bwml-spec.md +328 -328
  86. package/src/bmad-plus/packs/pack-dev-studio/shared/module-help.csv +32 -32
  87. package/src/bmad-plus/packs/pack-dev-studio/upstream-sync.yaml +81 -81
  88. package/src/bmad-plus/packs/pack-memory/shared/memory-protocol.md +14 -0
  89. package/src/bmad-plus/packs/pack-seo/SKILL.md +171 -171
  90. package/src/bmad-plus/packs/pack-seo/checklist.md +140 -140
  91. package/src/bmad-plus/packs/pack-seo/pagespeed-playbook.md +320 -320
  92. package/src/bmad-plus/packs/pack-seo/ref/audit-schema.json +187 -187
  93. package/src/bmad-plus/packs/pack-seo/ref/cwv-thresholds.md +87 -87
  94. package/src/bmad-plus/packs/pack-seo/ref/eeat-criteria.md +123 -123
  95. package/src/bmad-plus/packs/pack-seo/ref/geo-signals.md +167 -167
  96. package/src/bmad-plus/packs/pack-seo/ref/hreflang-rules.md +153 -153
  97. package/src/bmad-plus/packs/pack-seo/ref/quality-gates.md +133 -133
  98. package/src/bmad-plus/packs/pack-seo/ref/schema-catalog.md +91 -91
  99. package/src/bmad-plus/packs/pack-seo/ref/schema-templates.json +356 -356
  100. package/src/bmad-plus/packs/pack-seo/requirements.txt +17 -0
  101. package/src/bmad-plus/packs/pack-seo/scripts/seo_apis.py +456 -0
  102. package/src/bmad-plus/packs/pack-seo/scripts/seo_crawl.py +359 -0
  103. package/src/bmad-plus/packs/pack-seo/scripts/seo_fetch.py +304 -0
  104. package/src/bmad-plus/packs/pack-seo/scripts/seo_parse.py +255 -0
  105. package/src/bmad-plus/packs/pack-seo/scripts/seo_report.py +410 -0
  106. package/src/bmad-plus/packs/pack-seo/scripts/seo_screenshot.py +202 -0
  107. package/src/bmad-plus/packs/pack-seo/seo-chief.md +294 -294
  108. package/src/bmad-plus/packs/pack-seo/seo-judge.md +241 -241
  109. package/src/bmad-plus/packs/pack-seo/seo-scout.md +171 -171
  110. package/src/bmad-plus/packs/pack-seo/templates/seo-audit-workflow.md +241 -241
  111. package/src/bmad-plus/packs/pack-shield/README.md +6 -6
  112. package/src/bmad-plus/packs/pack-shield/SKILL.md +2 -2
  113. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/csrd-agent.md +11 -11
  114. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/section508-agent.md +11 -11
  115. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/wcag-agent.md +11 -11
  116. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/eu-ai-act-agent.md +11 -11
  117. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/iso42001-agent.md +11 -11
  118. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/nist-ai-rmf-agent.md +11 -11
  119. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/cis-controls-agent.md +11 -11
  120. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/ism-agent.md +11 -11
  121. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/iso27001-agent.md +11 -11
  122. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nis2-agent.md +11 -11
  123. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-800-53-agent.md +11 -11
  124. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-csf-agent.md +11 -11
  125. package/src/bmad-plus/packs/pack-shield/categories/defense-export/cmmc-agent.md +11 -11
  126. package/src/bmad-plus/packs/pack-shield/categories/defense-export/ear-agent.md +11 -11
  127. package/src/bmad-plus/packs/pack-shield/categories/defense-export/itar-agent.md +11 -11
  128. package/src/bmad-plus/packs/pack-shield/categories/defense-export/tsa-agent.md +11 -11
  129. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/dora-agent.md +11 -11
  130. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/fedramp-agent.md +11 -11
  131. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/hipaa-agent.md +11 -11
  132. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/pci-dss-agent.md +11 -11
  133. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/soc2-agent.md +11 -11
  134. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/swift-csp-agent.md +11 -11
  135. package/src/bmad-plus/packs/pack-shield/shield-orchestrator.md +1 -1
  136. package/tools/build/check-counts.js +628 -0
  137. package/tools/build/generated-adapters/.codex/AGENTS.md +1 -1
  138. package/tools/build/generated-adapters/.cursor/rules/bmad-plus.mdc +1 -1
  139. package/tools/build/generated-adapters/.opencode/AGENTS.md +1 -1
  140. package/tools/build/generated-adapters/AGENTS.md +1 -1
  141. package/tools/build/generated-adapters/CLAUDE.md +1 -1
  142. package/tools/build/generated-adapters/CONVENTIONS.md +1 -1
  143. package/tools/build/generated-adapters/GEMINI.md +1 -1
  144. package/tools/cli/commands/autoconfig.js +470 -472
  145. package/tools/cli/commands/doctor.js +233 -233
  146. package/tools/cli/commands/install.js +598 -495
  147. package/tools/cli/commands/memory-journal-cmd.js +311 -311
  148. package/tools/cli/commands/memory.js +195 -195
  149. package/tools/cli/commands/scan.js +348 -364
  150. package/tools/cli/commands/uninstall.js +101 -101
  151. package/tools/cli/commands/update.js +134 -134
  152. package/tools/cli/i18n.js +845 -845
  153. package/tools/cli/lib/README-memory-journal.md +125 -125
  154. package/tools/cli/lib/ide-config.js +267 -259
  155. package/tools/cli/lib/memory-init.js +204 -113
  156. package/tools/cli/lib/packs.js +209 -209
  157. package/tools/cli/lib/path-hash.js +39 -0
  158. package/tools/cli/lib/python-provision.js +508 -508
  159. package/tools/cli/lib/stack-detect.js +102 -102
  160. package/tools/cli/lib/validate.js +50 -50
@@ -1,241 +1,241 @@
1
- # SEO Audit Workflow — BMAD+ SEO Engine v2.0
2
-
3
- > Author: Laurent Rochetta | By Oveanet × Laurent Rochetta
4
-
5
- ## Overview
6
-
7
- This workflow orchestrates the 3 SEO Engine agents (Scout, Judge, Chief) through 6 phases to produce a comprehensive audit with scored results and actionable fixes.
8
-
9
- ---
10
-
11
- ## Phase 1 — Reconnaissance (Scout solo)
12
-
13
- **Duration**: ~2 min | **Agent**: Scout (Crawler role)
14
-
15
- 1. Fetch homepage + `/robots.txt` + `/sitemap.xml`
16
- 2. Detect business type (SaaS, e-commerce, local, publisher, agency)
17
- 3. Mini-crawl: discover 10–25 pages via sitemap + internal links
18
- 4. Detect rendering architecture (SSR / CSR / hybrid)
19
- 5. Check for `/llms.txt` and `/llms-full.txt`
20
-
21
- **Checkpoint**: "Identified a [type] site with [N] pages. Continue full audit?"
22
-
23
- **Tools**:
24
- ```bash
25
- python scripts/seo_fetch.py [URL] --json
26
- python scripts/seo_crawl.py [URL] --depth 2 --max 25 --json
27
- ```
28
-
29
- ---
30
-
31
- ## Phase 2 — Deep Scan (Scout + Judge in PARALLEL)
32
-
33
- **Duration**: ~5 min | **Agents**: Scout (Inspector) + Judge (Content Expert + Schema Master)
34
-
35
- ### Scout inspects (9 categories):
36
- 1. Crawlability (robots.txt, noindex, crawl depth)
37
- 2. Indexability (canonicals, duplicates, pagination)
38
- 3. Security (HTTPS, HSTS, CSP, X-Frame-Options)
39
- 4. URL Structure (clean URLs, redirects, trailing slashes)
40
- 5. Mobile (viewport, touch targets, font size)
41
- 6. Core Web Vitals signals from source HTML
42
- 7. Structured Data detection (pass to Judge)
43
- 8. JavaScript rendering (CSR/SSR, SPA detection)
44
- 9. IndexNow protocol
45
-
46
- ### Judge analyzes (in parallel):
47
- 1. E-E-A-T evaluation (Experience, Expertise, Authority, Trust)
48
- 2. Content quality (word count, readability, keyword optimization)
49
- 3. Schema validation (JSON-LD, types, deprecation status)
50
- 4. Image audit (alt text, dimensions, format, lazy loading)
51
- 5. Internal/external link analysis
52
- 6. AI content detection markers
53
-
54
- **Tools**:
55
- ```bash
56
- python scripts/seo_parse.py page.html --url [URL] --json
57
- python scripts/seo_screenshot.py [URL] --viewport mobile --json
58
- python scripts/seo_screenshot.py [URL] --viewport desktop --json
59
- ```
60
-
61
- ---
62
-
63
- ## Phase 3 — AI Readiness & GEO (Judge solo)
64
-
65
- **Duration**: ~3 min | **Agent**: Judge (GEO Analyst role)
66
-
67
- 1. Check AI crawler access (GPTBot, ClaudeBot, PerplexityBot, OAI-SearchBot)
68
- 2. Verify llms.txt compliance
69
- 3. Check RSL 1.0 licensing
70
- 4. Score passage-level citability (134–167 word blocks)
71
- 5. Analyze brand mention signals
72
- 6. Compute **AI Readiness Score (0–100)**
73
-
74
- Reference: `ref/geo-signals.md`
75
-
76
- ---
77
-
78
- ## Phase 4 — Scoring & Synthesis (Chief solo)
79
-
80
- **Duration**: ~2 min | **Agent**: Chief (Scorer role)
81
-
82
- Compute **SEO Health Score (0–100)** from weighted categories:
83
-
84
- | Category | Weight |
85
- |----------|--------|
86
- | Technical SEO | 20% |
87
- | Content & E-E-A-T | 22% |
88
- | On-Page SEO | 18% |
89
- | Schema | 10% |
90
- | Performance (CWV) | 12% |
91
- | AI Readiness (GEO) | 12% |
92
- | Images | 6% |
93
-
94
- Output: Score breakdown with visual indicators per category.
95
-
96
- ---
97
-
98
- ## Phase 5 — Action Plan & Auto-Fixes (Chief solo)
99
-
100
- **Duration**: ~3 min | **Agent**: Chief (Strategist role)
101
-
102
- 1. Classify all issues: 🔴 Critical → 🟠 High → 🟡 Medium → 🟢 Low
103
- 2. Identify Quick Wins (high impact / low effort)
104
- 3. Generate 30/60/90-day roadmap
105
- 4. **Auto-generate code fixes** for:
106
- - Missing/broken meta tags (title, description)
107
- - Schema JSON-LD blocks (from templates)
108
- - robots.txt improvements (AI crawler access)
109
- - llms.txt file generation
110
- - Image alt text suggestions
111
- 5. **Checkpoint**: "Here's the plan. Want me to apply the fixes automatically?"
112
-
113
- ---
114
-
115
- ## Phase 5b — PageSpeed Perfection Loop (Scout + Chief iterative)
116
-
117
- > **This is the battle-tested loop from our oveanet.ch optimization.**
118
- > Goal: Achieve **100% on all 4 PageSpeed Insights categories** (Performance, Accessibility, Best Practices, SEO).
119
-
120
- ### The Loop
121
-
122
- ```
123
- ┌─────────────────────────────────────┐
124
- │ 1. Run PageSpeed Insights audit │
125
- │ (via API or manual) │
126
- │ │ │
127
- │ ▼ │
128
- │ 2. Parse failing audits │
129
- │ Group by category + priority │
130
- │ │ │
131
- │ ▼ │
132
- │ 3. Apply top-priority fix │
133
- │ (one fix at a time) │
134
- │ │ │
135
- │ ▼ │
136
- │ 4. Re-run PageSpeed │
137
- │ Verify fix + no regressions │
138
- │ │ │
139
- │ ▼ │
140
- │ 5. Score improved? │
141
- │ YES → Continue to next fix │
142
- │ NO → Revert and try different │
143
- │ approach │
144
- │ │ │
145
- │ ▼ │
146
- │ 6. All 4 categories = 100%? │
147
- │ YES → Done ✅ │
148
- │ NO → Go to step 2 │
149
- └─────────────────────────────────────┘
150
- ```
151
-
152
- ### PageSpeed Fix Priority Order
153
- 1. **Performance** (hardest — tackle first):
154
- - Eliminate render-blocking resources
155
- - Properly size images (WebP/AVIF + responsive)
156
- - Reduce unused CSS/JS
157
- - Defer offscreen images
158
- - Minimize main-thread work
159
- - Reduce server response time (TTFB)
160
- - Preload LCP image
161
-
162
- 2. **Accessibility** (usually quick wins):
163
- - Add alt text to all images
164
- - Fix color contrast ratios (4.5:1 minimum)
165
- - Add ARIA labels to interactive elements
166
- - Ensure heading hierarchy
167
- - Add lang attribute to HTML
168
- - Ensure form labels
169
-
170
- 3. **Best Practices**:
171
- - HTTPS + no mixed content
172
- - No browser errors in console
173
- - Remove deprecated APIs
174
- - Add proper CSP headers
175
-
176
- 4. **SEO** (usually easiest):
177
- - Add meta description
178
- - Ensure crawlable links
179
- - Valid robots.txt
180
- - Proper viewport meta
181
- - Descriptive link text
182
-
183
- ### Key Rules
184
- - **One fix at a time** — never batch multiple changes, you need to isolate impact
185
- - **Always re-test** — PageSpeed scores can regress with seemingly unrelated changes
186
- - **Mobile first** — always test mobile viewport (Google uses mobile for indexing)
187
- - **Field vs Lab** — Lab scores (Lighthouse) can differ from field data (CrUX). Target lab 100% first
188
-
189
- ---
190
-
191
- ## Phase 6 — Monitoring (Scout, optional)
192
-
193
- **Duration**: ongoing | **Agent**: Scout (Crawler role)
194
-
195
- 1. Save audit results to `.bmad-seo/history/[domain]-[date].json`
196
- 2. On re-audit: compare with previous results
197
- 3. Track: issues resolved, new issues, score evolution
198
- 4. Generate progress report with deltas
199
-
200
- ---
201
-
202
- ## Command Quick Reference
203
-
204
- ```bash
205
- # Full audit (all 6 phases)
206
- /seo full https://example.com
207
-
208
- # Quick audit (Phases 1-4 only)
209
- /seo quick https://example.com
210
-
211
- # Individual commands
212
- /seo technical https://example.com
213
- /seo content https://example.com
214
- /seo geo https://example.com
215
- /seo schema https://example.com
216
- /seo images https://example.com
217
- /seo hreflang https://example.com
218
-
219
- # PageSpeed perfection loop
220
- /seo pagespeed https://example.com
221
-
222
- # Strategic planning
223
- /seo plan saas|ecommerce|local|publisher|agency
224
-
225
- # Auto-fix generation
226
- /seo fix
227
-
228
- # Monitoring
229
- /seo history
230
- /seo compare
231
- ```
232
-
233
- ---
234
-
235
- ## Tips for Best Results
236
-
237
- 1. **Start with `/seo full`** for the first audit — it gives you the complete picture
238
- 2. **Use `/seo pagespeed`** after fixing major issues to chase 100% scores
239
- 3. **Re-run monthly** with `/seo compare` to track progress
240
- 4. **Feed the AI crawlers**: Allow GPTBot + ClaudeBot + PerplexityBot in robots.txt
241
- 5. **Check GEO separately**: AI search visibility evolves fast, audit quarterly with `/seo geo`
1
+ # SEO Audit Workflow — BMAD+ SEO Engine v2.0
2
+
3
+ > Author: Laurent Rochetta | By Oveanet × Laurent Rochetta
4
+
5
+ ## Overview
6
+
7
+ This workflow orchestrates the 3 SEO Engine agents (Scout, Judge, Chief) through 6 phases to produce a comprehensive audit with scored results and actionable fixes.
8
+
9
+ ---
10
+
11
+ ## Phase 1 — Reconnaissance (Scout solo)
12
+
13
+ **Duration**: ~2 min | **Agent**: Scout (Crawler role)
14
+
15
+ 1. Fetch homepage + `/robots.txt` + `/sitemap.xml`
16
+ 2. Detect business type (SaaS, e-commerce, local, publisher, agency)
17
+ 3. Mini-crawl: discover 10–25 pages via sitemap + internal links
18
+ 4. Detect rendering architecture (SSR / CSR / hybrid)
19
+ 5. Check for `/llms.txt` and `/llms-full.txt`
20
+
21
+ **Checkpoint**: "Identified a [type] site with [N] pages. Continue full audit?"
22
+
23
+ **Tools**:
24
+ ```bash
25
+ python scripts/seo_fetch.py [URL] --json
26
+ python scripts/seo_crawl.py [URL] --depth 2 --max 25 --json
27
+ ```
28
+
29
+ ---
30
+
31
+ ## Phase 2 — Deep Scan (Scout + Judge in PARALLEL)
32
+
33
+ **Duration**: ~5 min | **Agents**: Scout (Inspector) + Judge (Content Expert + Schema Master)
34
+
35
+ ### Scout inspects (9 categories):
36
+ 1. Crawlability (robots.txt, noindex, crawl depth)
37
+ 2. Indexability (canonicals, duplicates, pagination)
38
+ 3. Security (HTTPS, HSTS, CSP, X-Frame-Options)
39
+ 4. URL Structure (clean URLs, redirects, trailing slashes)
40
+ 5. Mobile (viewport, touch targets, font size)
41
+ 6. Core Web Vitals signals from source HTML
42
+ 7. Structured Data detection (pass to Judge)
43
+ 8. JavaScript rendering (CSR/SSR, SPA detection)
44
+ 9. IndexNow protocol
45
+
46
+ ### Judge analyzes (in parallel):
47
+ 1. E-E-A-T evaluation (Experience, Expertise, Authority, Trust)
48
+ 2. Content quality (word count, readability, keyword optimization)
49
+ 3. Schema validation (JSON-LD, types, deprecation status)
50
+ 4. Image audit (alt text, dimensions, format, lazy loading)
51
+ 5. Internal/external link analysis
52
+ 6. AI content detection markers
53
+
54
+ **Tools**:
55
+ ```bash
56
+ python scripts/seo_parse.py page.html --url [URL] --json
57
+ python scripts/seo_screenshot.py [URL] --viewport mobile --json
58
+ python scripts/seo_screenshot.py [URL] --viewport desktop --json
59
+ ```
60
+
61
+ ---
62
+
63
+ ## Phase 3 — AI Readiness & GEO (Judge solo)
64
+
65
+ **Duration**: ~3 min | **Agent**: Judge (GEO Analyst role)
66
+
67
+ 1. Check AI crawler access (GPTBot, ClaudeBot, PerplexityBot, OAI-SearchBot)
68
+ 2. Verify llms.txt compliance
69
+ 3. Check RSL 1.0 licensing
70
+ 4. Score passage-level citability (134–167 word blocks)
71
+ 5. Analyze brand mention signals
72
+ 6. Compute **AI Readiness Score (0–100)**
73
+
74
+ Reference: `ref/geo-signals.md`
75
+
76
+ ---
77
+
78
+ ## Phase 4 — Scoring & Synthesis (Chief solo)
79
+
80
+ **Duration**: ~2 min | **Agent**: Chief (Scorer role)
81
+
82
+ Compute **SEO Health Score (0–100)** from weighted categories:
83
+
84
+ | Category | Weight |
85
+ |----------|--------|
86
+ | Technical SEO | 20% |
87
+ | Content & E-E-A-T | 22% |
88
+ | On-Page SEO | 18% |
89
+ | Schema | 10% |
90
+ | Performance (CWV) | 12% |
91
+ | AI Readiness (GEO) | 12% |
92
+ | Images | 6% |
93
+
94
+ Output: Score breakdown with visual indicators per category.
95
+
96
+ ---
97
+
98
+ ## Phase 5 — Action Plan & Auto-Fixes (Chief solo)
99
+
100
+ **Duration**: ~3 min | **Agent**: Chief (Strategist role)
101
+
102
+ 1. Classify all issues: 🔴 Critical → 🟠 High → 🟡 Medium → 🟢 Low
103
+ 2. Identify Quick Wins (high impact / low effort)
104
+ 3. Generate 30/60/90-day roadmap
105
+ 4. **Auto-generate code fixes** for:
106
+ - Missing/broken meta tags (title, description)
107
+ - Schema JSON-LD blocks (from templates)
108
+ - robots.txt improvements (AI crawler access)
109
+ - llms.txt file generation
110
+ - Image alt text suggestions
111
+ 5. **Checkpoint**: "Here's the plan. Want me to apply the fixes automatically?"
112
+
113
+ ---
114
+
115
+ ## Phase 5b — PageSpeed Perfection Loop (Scout + Chief iterative)
116
+
117
+ > **This is the battle-tested loop from our oveanet.ch optimization.**
118
+ > Goal: Achieve **100% on all 4 PageSpeed Insights categories** (Performance, Accessibility, Best Practices, SEO).
119
+
120
+ ### The Loop
121
+
122
+ ```
123
+ ┌─────────────────────────────────────┐
124
+ │ 1. Run PageSpeed Insights audit │
125
+ │ (via API or manual) │
126
+ │ │ │
127
+ │ ▼ │
128
+ │ 2. Parse failing audits │
129
+ │ Group by category + priority │
130
+ │ │ │
131
+ │ ▼ │
132
+ │ 3. Apply top-priority fix │
133
+ │ (one fix at a time) │
134
+ │ │ │
135
+ │ ▼ │
136
+ │ 4. Re-run PageSpeed │
137
+ │ Verify fix + no regressions │
138
+ │ │ │
139
+ │ ▼ │
140
+ │ 5. Score improved? │
141
+ │ YES → Continue to next fix │
142
+ │ NO → Revert and try different │
143
+ │ approach │
144
+ │ │ │
145
+ │ ▼ │
146
+ │ 6. All 4 categories = 100%? │
147
+ │ YES → Done ✅ │
148
+ │ NO → Go to step 2 │
149
+ └─────────────────────────────────────┘
150
+ ```
151
+
152
+ ### PageSpeed Fix Priority Order
153
+ 1. **Performance** (hardest — tackle first):
154
+ - Eliminate render-blocking resources
155
+ - Properly size images (WebP/AVIF + responsive)
156
+ - Reduce unused CSS/JS
157
+ - Defer offscreen images
158
+ - Minimize main-thread work
159
+ - Reduce server response time (TTFB)
160
+ - Preload LCP image
161
+
162
+ 2. **Accessibility** (usually quick wins):
163
+ - Add alt text to all images
164
+ - Fix color contrast ratios (4.5:1 minimum)
165
+ - Add ARIA labels to interactive elements
166
+ - Ensure heading hierarchy
167
+ - Add lang attribute to HTML
168
+ - Ensure form labels
169
+
170
+ 3. **Best Practices**:
171
+ - HTTPS + no mixed content
172
+ - No browser errors in console
173
+ - Remove deprecated APIs
174
+ - Add proper CSP headers
175
+
176
+ 4. **SEO** (usually easiest):
177
+ - Add meta description
178
+ - Ensure crawlable links
179
+ - Valid robots.txt
180
+ - Proper viewport meta
181
+ - Descriptive link text
182
+
183
+ ### Key Rules
184
+ - **One fix at a time** — never batch multiple changes, you need to isolate impact
185
+ - **Always re-test** — PageSpeed scores can regress with seemingly unrelated changes
186
+ - **Mobile first** — always test mobile viewport (Google uses mobile for indexing)
187
+ - **Field vs Lab** — Lab scores (Lighthouse) can differ from field data (CrUX). Target lab 100% first
188
+
189
+ ---
190
+
191
+ ## Phase 6 — Monitoring (Scout, optional)
192
+
193
+ **Duration**: ongoing | **Agent**: Scout (Crawler role)
194
+
195
+ 1. Save audit results to `.bmad-seo/history/[domain]-[date].json`
196
+ 2. On re-audit: compare with previous results
197
+ 3. Track: issues resolved, new issues, score evolution
198
+ 4. Generate progress report with deltas
199
+
200
+ ---
201
+
202
+ ## Command Quick Reference
203
+
204
+ ```bash
205
+ # Full audit (all 6 phases)
206
+ /seo full https://example.com
207
+
208
+ # Quick audit (Phases 1-4 only)
209
+ /seo quick https://example.com
210
+
211
+ # Individual commands
212
+ /seo technical https://example.com
213
+ /seo content https://example.com
214
+ /seo geo https://example.com
215
+ /seo schema https://example.com
216
+ /seo images https://example.com
217
+ /seo hreflang https://example.com
218
+
219
+ # PageSpeed perfection loop
220
+ /seo pagespeed https://example.com
221
+
222
+ # Strategic planning
223
+ /seo plan saas|ecommerce|local|publisher|agency
224
+
225
+ # Auto-fix generation
226
+ /seo fix
227
+
228
+ # Monitoring
229
+ /seo history
230
+ /seo compare
231
+ ```
232
+
233
+ ---
234
+
235
+ ## Tips for Best Results
236
+
237
+ 1. **Start with `/seo full`** for the first audit — it gives you the complete picture
238
+ 2. **Use `/seo pagespeed`** after fixing major issues to chase 100% scores
239
+ 3. **Re-run monthly** with `/seo compare` to track progress
240
+ 4. **Feed the AI crawlers**: Allow GPTBot + ClaudeBot + PerplexityBot in robots.txt
241
+ 5. **Check GEO separately**: AI search visibility evolves fast, audit quarterly with `/seo geo`
@@ -1,6 +1,6 @@
1
1
  # 🛡️ Pack Shield — GRC Compliance Agents
2
2
 
3
- > **38 expert compliance agents** + 1 orchestrator covering Data Privacy, Cybersecurity, Industry Compliance, Defense & Export, AI Governance, Accessibility & ESG, and GDPR/AI Act Workflows.
3
+ > **27 compliance agents across 6 categories, plus 11 GDPR & AI Act workflows** + 1 orchestrator covering Data Privacy, Cybersecurity, Industry Compliance, Defense & Export, AI Governance, and Accessibility & ESG.
4
4
 
5
5
  ## Overview
6
6
 
@@ -12,7 +12,7 @@ Pack Shield transforms BMAD+ into a comprehensive GRC (Governance, Risk & Compli
12
12
  - 📊 **Standardized Templates** — Gap analysis and audit reports
13
13
  - 🌍 **Multi-LLM Compatible** — Standard `.md` format works with any LLM
14
14
  - 📦 **Modular Installation** — Install by category or individual agent
15
- - 📁 **85 Reference Files** — Deep regulatory knowledge from upstream sources
15
+ - 📁 **79 Reference Files** — Deep regulatory knowledge from upstream sources
16
16
 
17
17
  ## Categories
18
18
 
@@ -67,9 +67,9 @@ Pack Shield transforms BMAD+ into a comprehensive GRC (Governance, Risk & Compli
67
67
  | `section508-agent` | Section 508 | US Federal |
68
68
  | `csrd-agent` | CSRD | EU |
69
69
 
70
- ### 📋 GDPR & AI Act Workflows (11 agents)
71
- | Agent | Workflow | Focus |
72
- |-------|---------|-------|
70
+ ### 📋 GDPR & AI Act Workflows (11 workflows)
71
+ | Workflow | Purpose | Focus |
72
+ |----------|---------|-------|
73
73
  | `dpia-sentinel` | DPIA Impact Assessment | Art. 35 GDPR — AI-specific considerations |
74
74
  | `breach-sentinel` | Breach 72h Response | Art. 33/34 — Severity classification, notifications |
75
75
  | `legitimate-interest` | LIA Three-Part Test | Art. 6(1)(f) — Purpose, necessity, balancing |
@@ -88,7 +88,7 @@ Pack Shield transforms BMAD+ into a comprehensive GRC (Governance, Risk & Compli
88
88
  - `shared/audit-report-template.md` — Compliance audit report format
89
89
 
90
90
  ## Reference Files
91
- - `references/` — 85 regulatory reference files extracted from upstream skills
91
+ - `references/` — 79 regulatory reference files extracted from upstream skills
92
92
  - Organized by framework (gdpr-compliance, iso27001, soc2, etc.)
93
93
  - Contains templates, control mappings, article references, and compliance programs
94
94
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  ## Overview
8
8
 
9
- Shield transforms BMAD+ into a comprehensive GRC (Governance, Risk & Compliance) assistant. It serves as an intelligent orchestrator for 38 compliance agents across 7 categories, covering 25+ regulatory frameworks. Route requests to the appropriate specialist agent, combine insights for cross-framework analysis, and provide consolidated compliance reports.
9
+ Shield transforms BMAD+ into a comprehensive GRC (Governance, Risk & Compliance) assistant. It serves as an intelligent orchestrator for 27 compliance agents across 6 categories, plus 11 GDPR & AI Act workflows, covering 25+ regulatory frameworks. Route requests to the appropriate specialist agent, combine insights for cross-framework analysis, and provide consolidated compliance reports.
10
10
 
11
11
  ## Capabilities
12
12
 
@@ -72,7 +72,7 @@ Then invoke the orchestrator from any conversation:
72
72
 
73
73
  - `shield-orchestrator.md` — Intelligent routing entry point
74
74
  - `categories/` — Framework-specific agent prompts
75
- - `references/` — 85 regulatory reference files
75
+ - `references/` — 79 regulatory reference files
76
76
  - `shared/` — Cross-framework mapper, gap analysis & audit templates
77
77
 
78
78
  ## Attribution
@@ -1,14 +1,14 @@
1
- # CSRD Compliance Agent
2
-
3
- > **Pack:** Shield (GRC Audit) -- Accessibility and ESG
4
- > **Framework:** Corporate Sustainability Reporting Directive EU 2022/2464
5
- > **Version:** 1.0.0
6
- > **Based on:** Claude Skills for GRC by Hemant Naik (Sushegaad) -- MIT License
7
- > **Upstream:** https://github.com/Sushegaad/Claude-Skills-Governance-Risk-and-Compliance
8
- > **Adapted for BMAD+ by:** Laurent Rochetta -- https://github.com/lrochetta/BMAD-PLUS
9
-
10
- ---
11
-
1
+ # CSRD Compliance Agent
2
+
3
+ > **Pack:** Shield (GRC Audit) -- Accessibility and ESG
4
+ > **Framework:** Corporate Sustainability Reporting Directive EU 2022/2464
5
+ > **Version:** 1.0.0
6
+ > **Based on:** Claude Skills for GRC by Hemant Naik (Sushegaad) -- MIT License
7
+ > **Upstream:** https://github.com/Sushegaad/Claude-Skills-Governance-Risk-and-Compliance
8
+ > **Adapted for BMAD+ by:** Laurent Rochetta -- https://github.com/lrochetta/BMAD-PLUS
9
+
10
+ ---
11
+
12
12
  # CSRD Compliance Skill
13
13
 
14
14
  You are an expert EU sustainability reporting advisor with deep knowledge of the **Corporate Sustainability Reporting Directive (CSRD)** — Directive (EU) 2022/2464 — and the **European Sustainability Reporting Standards (ESRS)** issued by EFRAG under Commission Delegated Regulation (EU) 2023/2772. You assist finance, legal, sustainability, and compliance teams preparing for CSRD obligations.
@@ -1,14 +1,14 @@
1
- # Section 508 Compliance Agent
2
-
3
- > **Pack:** Shield (GRC Audit) -- Accessibility and ESG
4
- > **Framework:** Section 508 US Federal Accessibility
5
- > **Version:** 1.0.0
6
- > **Based on:** Claude Skills for GRC by Hemant Naik (Sushegaad) -- MIT License
7
- > **Upstream:** https://github.com/Sushegaad/Claude-Skills-Governance-Risk-and-Compliance
8
- > **Adapted for BMAD+ by:** Laurent Rochetta -- https://github.com/lrochetta/BMAD-PLUS
9
-
10
- ---
11
-
1
+ # Section 508 Compliance Agent
2
+
3
+ > **Pack:** Shield (GRC Audit) -- Accessibility and ESG
4
+ > **Framework:** Section 508 US Federal Accessibility
5
+ > **Version:** 1.0.0
6
+ > **Based on:** Claude Skills for GRC by Hemant Naik (Sushegaad) -- MIT License
7
+ > **Upstream:** https://github.com/Sushegaad/Claude-Skills-Governance-Risk-and-Compliance
8
+ > **Adapted for BMAD+ by:** Laurent Rochetta -- https://github.com/lrochetta/BMAD-PLUS
9
+
10
+ ---
11
+
12
12
  # Section 508 Compliance Skill
13
13
 
14
14
  You are an expert advisor on **Section 508 of the Rehabilitation Act of 1973** (29 U.S.C. § 794d), as amended by the Workforce Investment Act of 1998, with the **Revised Section 508 Standards** in effect from **January 18, 2018** (36 CFR Part 1194). You help federal agencies, federal contractors, and ICT vendors achieve and demonstrate accessibility compliance.
@@ -1,14 +1,14 @@
1
- # WCAG Compliance Agent
2
-
3
- > **Pack:** Shield (GRC Audit) -- Accessibility and ESG
4
- > **Framework:** Web Content Accessibility Guidelines 2.2
5
- > **Version:** 1.0.0
6
- > **Based on:** Claude Skills for GRC by Hemant Naik (Sushegaad) -- MIT License
7
- > **Upstream:** https://github.com/Sushegaad/Claude-Skills-Governance-Risk-and-Compliance
8
- > **Adapted for BMAD+ by:** Laurent Rochetta -- https://github.com/lrochetta/BMAD-PLUS
9
-
10
- ---
11
-
1
+ # WCAG Compliance Agent
2
+
3
+ > **Pack:** Shield (GRC Audit) -- Accessibility and ESG
4
+ > **Framework:** Web Content Accessibility Guidelines 2.2
5
+ > **Version:** 1.0.0
6
+ > **Based on:** Claude Skills for GRC by Hemant Naik (Sushegaad) -- MIT License
7
+ > **Upstream:** https://github.com/Sushegaad/Claude-Skills-Governance-Risk-and-Compliance
8
+ > **Adapted for BMAD+ by:** Laurent Rochetta -- https://github.com/lrochetta/BMAD-PLUS
9
+
10
+ ---
11
+
12
12
  # Web Content Accessibility Guidelines (WCAG) Skill
13
13
 
14
14
  You are an expert advisor on the **Web Content Accessibility Guidelines (WCAG)** — the W3C international standard for digital accessibility, developed by the Web Accessibility Initiative (WAI). You help developers, designers, product owners, and compliance teams understand, audit, and implement WCAG across web, mobile, and digital content.
@@ -1,14 +1,14 @@
1
- # EU AI Act Compliance Agent
2
-
3
- > **Pack:** Shield (GRC Audit) -- AI Governance
4
- > **Framework:** EU AI Act Regulation 2024/1689
5
- > **Version:** 1.0.0
6
- > **Based on:** Claude Skills for GRC by Hemant Naik (Sushegaad) -- MIT License
7
- > **Upstream:** https://github.com/Sushegaad/Claude-Skills-Governance-Risk-and-Compliance
8
- > **Adapted for BMAD+ by:** Laurent Rochetta -- https://github.com/lrochetta/BMAD-PLUS
9
-
10
- ---
11
-
1
+ # EU AI Act Compliance Agent
2
+
3
+ > **Pack:** Shield (GRC Audit) -- AI Governance
4
+ > **Framework:** EU AI Act Regulation 2024/1689
5
+ > **Version:** 1.0.0
6
+ > **Based on:** Claude Skills for GRC by Hemant Naik (Sushegaad) -- MIT License
7
+ > **Upstream:** https://github.com/Sushegaad/Claude-Skills-Governance-Risk-and-Compliance
8
+ > **Adapted for BMAD+ by:** Laurent Rochetta -- https://github.com/lrochetta/BMAD-PLUS
9
+
10
+ ---
11
+
12
12
  # EU AI Act — Compliance Advisor
13
13
 
14
14
  You are an expert EU AI Act compliance advisor with deep knowledge of **Regulation (EU) 2024/1689**, its Annexes, Recitals, and all implementing measures. Every response cites the governing Article, Annex, or Recital.