bmad-plus 0.12.1 → 0.13.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 (176) hide show
  1. package/CHANGELOG.md +637 -580
  2. package/README.md +123 -120
  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 +106 -91
  14. package/readme-international/README.de.md +625 -594
  15. package/readme-international/README.es.md +642 -611
  16. package/readme-international/README.fr.md +640 -609
  17. package/src/bmad-plus/agents/agent-orchestrator/SKILL.md +2 -0
  18. package/src/bmad-plus/agents/agent-shadow/SKILL.md +18 -0
  19. package/src/bmad-plus/data/role-triggers.yaml +52 -0
  20. package/src/bmad-plus/module.yaml +333 -283
  21. package/src/bmad-plus/packs/pack-animated/animated-website-agent.md +325 -325
  22. package/src/bmad-plus/packs/pack-animated/templates/animated-website-workflow.md +55 -55
  23. package/src/bmad-plus/packs/pack-backup/backup-agent.md +71 -71
  24. package/src/bmad-plus/packs/pack-backup/templates/backup-workflow.md +51 -51
  25. package/src/bmad-plus/packs/pack-dev-studio/README.md +162 -162
  26. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/analyst-agent.md +73 -73
  27. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/document-project.md +61 -61
  28. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/domain-research.md +95 -95
  29. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/market-research.md +95 -95
  30. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/prfaq.md +134 -134
  31. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/product-brief.md +80 -80
  32. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/tech-writer-agent.md +73 -73
  33. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/technical-research.md +95 -95
  34. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/architect-agent.md +73 -73
  35. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-architecture.md +73 -73
  36. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-epics-stories.md +92 -92
  37. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/generate-project-context.md +80 -80
  38. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/implementation-readiness.md +90 -90
  39. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01-init.md +153 -153
  40. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01b-continue.md +173 -173
  41. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-02-context.md +224 -224
  42. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-03-starter.md +329 -329
  43. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-04-decisions.md +318 -318
  44. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-05-patterns.md +359 -359
  45. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-06-structure.md +379 -379
  46. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-07-validation.md +361 -361
  47. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-08-complete.md +81 -81
  48. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/checkpoint-preview.md +67 -67
  49. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-01-gather-context.md +85 -85
  50. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-02-review.md +35 -35
  51. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-03-triage.md +49 -49
  52. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-04-present.md +131 -131
  53. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review.md +89 -89
  54. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/correct-course.md +300 -300
  55. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/create-story.md +428 -428
  56. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-agent.md +73 -73
  57. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story-checklist.md +80 -80
  58. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story.md +484 -484
  59. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/investigate.md +193 -193
  60. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/qa-e2e-tests.md +175 -175
  61. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/quick-dev.md +110 -110
  62. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/retrospective.md +1511 -1511
  63. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-planning.md +298 -298
  64. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-status.md +296 -296
  65. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-prd.md +29 -29
  66. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-ux-design.md +74 -74
  67. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/edit-prd.md +29 -29
  68. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/pm-agent.md +73 -73
  69. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/prd.md +89 -89
  70. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/ux-designer-agent.md +73 -73
  71. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/validate-prd.md +29 -29
  72. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/advanced-elicitation.md +141 -141
  73. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/adversarial-review.md +37 -37
  74. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/bmad-help.md +75 -75
  75. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/brainstorming.md +6 -6
  76. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/customize.md +110 -110
  77. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/distillator.md +176 -176
  78. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/edge-case-hunter.md +67 -67
  79. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-prose.md +86 -86
  80. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-structure.md +179 -179
  81. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/index-docs.md +66 -66
  82. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/party-mode.md +127 -127
  83. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/shard-doc.md +105 -105
  84. package/src/bmad-plus/packs/pack-dev-studio/dev-studio-orchestrator.md +120 -120
  85. package/src/bmad-plus/packs/pack-dev-studio/shared/architecture-decision-template.md +12 -12
  86. package/src/bmad-plus/packs/pack-dev-studio/shared/bwml-spec.md +328 -328
  87. package/src/bmad-plus/packs/pack-dev-studio/shared/module-help.csv +32 -32
  88. package/src/bmad-plus/packs/pack-dev-studio/upstream-sync.yaml +81 -81
  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 +303 -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 +409 -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/src/bmad-plus/skills/bmad-plus-autopilot/SKILL.md +1 -1
  137. package/tools/bmad-plus-npx.js +4 -2
  138. package/tools/build/adapters.config.js +60 -51
  139. package/tools/build/check-counts.js +626 -0
  140. package/tools/build/check-install-contract.js +298 -0
  141. package/tools/build/generate-adapters.js +252 -56
  142. package/tools/build/generate.js +187 -10
  143. package/tools/build/generated-adapters/.codex/AGENTS.md +20 -7
  144. package/tools/build/generated-adapters/.cursor/rules/bmad-plus.mdc +20 -7
  145. package/tools/build/generated-adapters/.opencode/AGENTS.md +20 -7
  146. package/tools/build/generated-adapters/AGENTS.md +20 -7
  147. package/tools/build/generated-adapters/CLAUDE.md +20 -7
  148. package/tools/build/generated-adapters/CONVENTIONS.md +20 -7
  149. package/tools/build/generated-adapters/GEMINI.md +20 -7
  150. package/tools/build/module.template.yaml +82 -0
  151. package/tools/cli/bmad-plus-cli.js +16 -1
  152. package/tools/cli/commands/autoconfig.js +470 -470
  153. package/tools/cli/commands/doctor.js +205 -233
  154. package/tools/cli/commands/install.js +543 -501
  155. package/tools/cli/commands/memory-journal-cmd.js +311 -311
  156. package/tools/cli/commands/memory.js +195 -195
  157. package/tools/cli/commands/scan.js +348 -348
  158. package/tools/cli/commands/uninstall.js +209 -101
  159. package/tools/cli/commands/update-check.js +31 -0
  160. package/tools/cli/commands/update-policy.js +39 -0
  161. package/tools/cli/commands/update.js +123 -134
  162. package/tools/cli/i18n.js +905 -845
  163. package/tools/cli/lib/README-memory-journal.md +125 -125
  164. package/tools/cli/lib/ide-config.js +10 -259
  165. package/tools/cli/lib/install-manifest.js +17 -0
  166. package/tools/cli/lib/installed-adapters.js +89 -0
  167. package/tools/cli/lib/npm-runner.js +177 -0
  168. package/tools/cli/lib/pack-copy.js +62 -66
  169. package/tools/cli/lib/packs.js +437 -3
  170. package/tools/cli/lib/python-provision.js +508 -508
  171. package/tools/cli/lib/stack-detect.js +102 -102
  172. package/tools/cli/lib/update-check.js +153 -0
  173. package/tools/cli/lib/update-dispatch.js +182 -0
  174. package/tools/cli/lib/update-policy.js +90 -0
  175. package/tools/cli/lib/update-transaction.js +334 -0
  176. 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.