bmad-plus 0.7.4 → 0.8.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 (294) hide show
  1. package/CHANGELOG.md +450 -407
  2. package/LICENSE +21 -0
  3. package/README.md +555 -446
  4. package/osint-agent-package/README.md +88 -88
  5. package/osint-agent-package/SETUP_KEYS.md +108 -108
  6. package/osint-agent-package/agents/osint-investigator.md +80 -80
  7. package/osint-agent-package/install.ps1 +87 -87
  8. package/osint-agent-package/install.sh +76 -76
  9. package/osint-agent-package/skills/bmad-osint-investigate/SKILL.md +147 -147
  10. package/osint-agent-package/skills/bmad-osint-investigate/osint/SKILL.md +452 -452
  11. package/osint-agent-package/skills/bmad-osint-investigate/osint/assets/dossier-template.md +116 -116
  12. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/content-extraction.md +100 -100
  13. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/enrichment-databases-fr.md +148 -148
  14. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/platforms.md +130 -130
  15. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/psychoprofile.md +69 -69
  16. package/osint-agent-package/skills/bmad-osint-investigate/osint/references/tools.md +281 -281
  17. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/_http.py +101 -101
  18. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/apify.py +266 -260
  19. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/brightdata.py +101 -101
  20. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/diagnose.py +141 -141
  21. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/exa.py +79 -79
  22. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/jina.py +71 -71
  23. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/mcp-client.py +136 -136
  24. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/parallel.py +85 -85
  25. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/perplexity.py +102 -102
  26. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/tavily.py +72 -72
  27. package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/volley.py +208 -208
  28. package/osint-agent-package/skills/bmad-osint-investigator/SKILL.md +15 -15
  29. package/package.json +62 -57
  30. package/readme-international/README.de.md +576 -426
  31. package/readme-international/README.es.md +578 -518
  32. package/readme-international/README.fr.md +576 -516
  33. package/src/bmad-plus/agents/agent-architect-dev/SKILL.md +96 -96
  34. package/src/bmad-plus/agents/agent-architect-dev/bmad-skill-manifest.yaml +13 -13
  35. package/src/bmad-plus/agents/agent-maker/SKILL.md +201 -201
  36. package/src/bmad-plus/agents/agent-maker/bmad-skill-manifest.yaml +13 -13
  37. package/src/bmad-plus/agents/agent-orchestrator/SKILL.md +137 -137
  38. package/src/bmad-plus/agents/agent-orchestrator/bmad-skill-manifest.yaml +13 -13
  39. package/src/bmad-plus/agents/agent-quality/SKILL.md +83 -83
  40. package/src/bmad-plus/agents/agent-quality/bmad-skill-manifest.yaml +13 -13
  41. package/src/bmad-plus/agents/agent-shadow/SKILL.md +71 -71
  42. package/src/bmad-plus/agents/agent-shadow/bmad-skill-manifest.yaml +13 -13
  43. package/src/bmad-plus/agents/agent-strategist/SKILL.md +80 -80
  44. package/src/bmad-plus/agents/agent-strategist/bmad-skill-manifest.yaml +13 -13
  45. package/src/bmad-plus/agents/pack-animated/animated-website-agent.md +325 -325
  46. package/src/bmad-plus/agents/pack-animated/templates/animated-website-workflow.md +55 -55
  47. package/src/bmad-plus/agents/pack-backup/backup-agent.md +71 -71
  48. package/src/bmad-plus/agents/pack-backup/templates/backup-workflow.md +51 -51
  49. package/src/bmad-plus/agents/pack-seo/SKILL.md +171 -171
  50. package/src/bmad-plus/agents/pack-seo/checklist.md +140 -140
  51. package/src/bmad-plus/agents/pack-seo/pagespeed-playbook.md +320 -320
  52. package/src/bmad-plus/agents/pack-seo/ref/audit-schema.json +187 -187
  53. package/src/bmad-plus/agents/pack-seo/ref/cwv-thresholds.md +87 -87
  54. package/src/bmad-plus/agents/pack-seo/ref/eeat-criteria.md +123 -123
  55. package/src/bmad-plus/agents/pack-seo/ref/geo-signals.md +167 -167
  56. package/src/bmad-plus/agents/pack-seo/ref/hreflang-rules.md +153 -153
  57. package/src/bmad-plus/agents/pack-seo/ref/quality-gates.md +133 -133
  58. package/src/bmad-plus/agents/pack-seo/ref/schema-catalog.md +91 -91
  59. package/src/bmad-plus/agents/pack-seo/ref/schema-templates.json +356 -356
  60. package/src/bmad-plus/agents/pack-seo/seo-chief.md +294 -294
  61. package/src/bmad-plus/agents/pack-seo/seo-judge.md +241 -241
  62. package/src/bmad-plus/agents/pack-seo/seo-scout.md +171 -171
  63. package/src/bmad-plus/agents/pack-seo/templates/seo-audit-workflow.md +241 -241
  64. package/src/bmad-plus/data/role-triggers.yaml +209 -209
  65. package/src/bmad-plus/module-help.csv +10 -10
  66. package/src/bmad-plus/module.yaml +283 -280
  67. package/src/bmad-plus/packs/pack-animated/animated-website-agent.md +325 -0
  68. package/src/bmad-plus/packs/pack-animated/templates/animated-website-workflow.md +55 -0
  69. package/src/bmad-plus/packs/pack-backup/backup-agent.md +71 -0
  70. package/src/bmad-plus/packs/pack-backup/templates/backup-workflow.md +51 -0
  71. package/src/bmad-plus/packs/pack-dev-studio/README.md +162 -162
  72. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/analyst-agent.md +73 -73
  73. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/document-project.md +61 -61
  74. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/domain-research.md +95 -95
  75. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/market-research.md +95 -95
  76. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/prfaq.md +134 -134
  77. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/product-brief.md +80 -80
  78. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/tech-writer-agent.md +73 -73
  79. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/technical-research.md +95 -95
  80. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/architect-agent.md +73 -73
  81. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-architecture.md +73 -73
  82. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-epics-stories.md +92 -92
  83. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/generate-project-context.md +80 -80
  84. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/implementation-readiness.md +90 -90
  85. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01-init.md +153 -153
  86. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01b-continue.md +173 -173
  87. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-02-context.md +224 -224
  88. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-03-starter.md +329 -329
  89. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-04-decisions.md +318 -318
  90. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-05-patterns.md +359 -359
  91. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-06-structure.md +379 -379
  92. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-07-validation.md +361 -361
  93. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-08-complete.md +81 -81
  94. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/checkpoint-preview.md +67 -67
  95. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-01-gather-context.md +85 -85
  96. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-02-review.md +35 -35
  97. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-03-triage.md +49 -49
  98. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-04-present.md +131 -131
  99. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review.md +89 -89
  100. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/correct-course.md +300 -300
  101. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/create-story.md +428 -428
  102. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-agent.md +73 -73
  103. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story-checklist.md +80 -80
  104. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story.md +484 -484
  105. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/investigate.md +193 -193
  106. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/qa-e2e-tests.md +175 -175
  107. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/quick-dev.md +110 -110
  108. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/retrospective.md +1511 -1511
  109. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-planning.md +298 -298
  110. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-status.md +296 -296
  111. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-prd.md +29 -29
  112. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-ux-design.md +74 -74
  113. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/edit-prd.md +29 -29
  114. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/pm-agent.md +73 -73
  115. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/prd.md +89 -89
  116. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/ux-designer-agent.md +73 -73
  117. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/validate-prd.md +29 -29
  118. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/advanced-elicitation.md +141 -141
  119. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/adversarial-review.md +37 -37
  120. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/bmad-help.md +75 -75
  121. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/brainstorming.md +6 -6
  122. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/customize.md +110 -110
  123. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/distillator.md +176 -176
  124. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/edge-case-hunter.md +67 -67
  125. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-prose.md +86 -86
  126. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-structure.md +179 -179
  127. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/index-docs.md +66 -66
  128. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/party-mode.md +127 -127
  129. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/shard-doc.md +105 -105
  130. package/src/bmad-plus/packs/pack-dev-studio/dev-studio-orchestrator.md +120 -120
  131. package/src/bmad-plus/packs/pack-dev-studio/shared/architecture-decision-template.md +12 -12
  132. package/src/bmad-plus/packs/pack-dev-studio/shared/bwml-spec.md +328 -328
  133. package/src/bmad-plus/packs/pack-dev-studio/shared/module-help.csv +32 -32
  134. package/src/bmad-plus/packs/pack-dev-studio/upstream-sync.yaml +81 -81
  135. package/src/bmad-plus/packs/pack-memory/README.md +106 -106
  136. package/src/bmad-plus/packs/pack-memory/memory-orchestrator.md +79 -79
  137. package/src/bmad-plus/packs/pack-memory/shared/karpathy-guardrails.md +86 -86
  138. package/src/bmad-plus/packs/pack-memory/shared/memory-protocol.md +143 -143
  139. package/src/bmad-plus/packs/pack-memory/templates/context.md +39 -39
  140. package/src/bmad-plus/packs/pack-memory/templates/decisions.md +25 -25
  141. package/src/bmad-plus/packs/pack-memory/templates/identity.yaml +39 -39
  142. package/src/bmad-plus/packs/pack-memory/templates/lessons.md +31 -31
  143. package/src/bmad-plus/packs/pack-memory/templates/patterns.md +24 -24
  144. package/src/bmad-plus/packs/pack-memory/templates/session-handoff.md +25 -25
  145. package/src/bmad-plus/packs/pack-memory/zecher-agent.md +157 -157
  146. package/src/bmad-plus/packs/pack-seo/SKILL.md +171 -0
  147. package/src/bmad-plus/packs/pack-seo/checklist.md +140 -0
  148. package/src/bmad-plus/packs/pack-seo/pagespeed-playbook.md +320 -0
  149. package/src/bmad-plus/packs/pack-seo/ref/audit-schema.json +187 -0
  150. package/src/bmad-plus/packs/pack-seo/ref/cwv-thresholds.md +87 -0
  151. package/src/bmad-plus/packs/pack-seo/ref/eeat-criteria.md +123 -0
  152. package/src/bmad-plus/packs/pack-seo/ref/geo-signals.md +167 -0
  153. package/src/bmad-plus/packs/pack-seo/ref/hreflang-rules.md +153 -0
  154. package/src/bmad-plus/packs/pack-seo/ref/quality-gates.md +133 -0
  155. package/src/bmad-plus/packs/pack-seo/ref/schema-catalog.md +91 -0
  156. package/src/bmad-plus/packs/pack-seo/ref/schema-templates.json +356 -0
  157. package/src/bmad-plus/packs/pack-seo/seo-chief.md +294 -0
  158. package/src/bmad-plus/packs/pack-seo/seo-judge.md +241 -0
  159. package/src/bmad-plus/packs/pack-seo/seo-scout.md +171 -0
  160. package/src/bmad-plus/packs/pack-seo/templates/seo-audit-workflow.md +241 -0
  161. package/src/bmad-plus/packs/pack-shield/README.md +110 -110
  162. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/csrd-agent.md +262 -262
  163. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/section508-agent.md +179 -179
  164. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/wcag-agent.md +201 -201
  165. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/eu-ai-act-agent.md +97 -97
  166. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/iso42001-agent.md +251 -251
  167. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/nist-ai-rmf-agent.md +133 -133
  168. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/cis-controls-agent.md +221 -221
  169. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/ism-agent.md +150 -150
  170. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/iso27001-agent.md +167 -167
  171. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nis2-agent.md +83 -83
  172. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-800-53-agent.md +250 -250
  173. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-csf-agent.md +218 -218
  174. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/ccpa-agent.md +94 -94
  175. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/dpdpa-agent.md +136 -136
  176. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/gdpr-agent.md +296 -296
  177. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/iso27701-agent.md +134 -134
  178. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/lgpd-agent.md +129 -129
  179. package/src/bmad-plus/packs/pack-shield/categories/defense-export/cmmc-agent.md +127 -127
  180. package/src/bmad-plus/packs/pack-shield/categories/defense-export/ear-agent.md +272 -272
  181. package/src/bmad-plus/packs/pack-shield/categories/defense-export/itar-agent.md +202 -202
  182. package/src/bmad-plus/packs/pack-shield/categories/defense-export/tsa-agent.md +367 -367
  183. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/dora-agent.md +510 -510
  184. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/fedramp-agent.md +247 -247
  185. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/hipaa-agent.md +173 -173
  186. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/pci-dss-agent.md +239 -239
  187. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/soc2-agent.md +266 -266
  188. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/swift-csp-agent.md +164 -164
  189. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-classifier.md +131 -131
  190. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-fria.md +155 -155
  191. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-incidents.md +187 -187
  192. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-roles.md +113 -113
  193. package/src/bmad-plus/packs/pack-shield/categories/workflows/breach-sentinel.md +197 -197
  194. package/src/bmad-plus/packs/pack-shield/categories/workflows/cookie-policy-gen.md +180 -180
  195. package/src/bmad-plus/packs/pack-shield/categories/workflows/dpia-sentinel.md +235 -235
  196. package/src/bmad-plus/packs/pack-shield/categories/workflows/legitimate-interest.md +159 -159
  197. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-advisor.md +133 -133
  198. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-notice-gen.md +160 -160
  199. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-policy-gen.md +135 -135
  200. package/src/bmad-plus/packs/pack-shield/references/ccpa/ccpa-gdpr-comparison.md +117 -117
  201. package/src/bmad-plus/packs/pack-shield/references/ccpa/consumer-rights-workflows.md +177 -177
  202. package/src/bmad-plus/packs/pack-shield/references/cis-controls/framework-mappings.md +162 -162
  203. package/src/bmad-plus/packs/pack-shield/references/cis-controls/implementation-guidance.md +235 -235
  204. package/src/bmad-plus/packs/pack-shield/references/cis-controls/safeguards-detail.md +252 -252
  205. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-assessment.md +170 -170
  206. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-levels.md +113 -113
  207. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-practices.md +211 -211
  208. package/src/bmad-plus/packs/pack-shield/references/csrd/compliance-program.md +281 -281
  209. package/src/bmad-plus/packs/pack-shield/references/csrd/double-materiality.md +253 -253
  210. package/src/bmad-plus/packs/pack-shield/references/csrd/esrs-standards.md +401 -401
  211. package/src/bmad-plus/packs/pack-shield/references/dora/article-reference.md +441 -441
  212. package/src/bmad-plus/packs/pack-shield/references/dora/incident-classification.md +297 -297
  213. package/src/bmad-plus/packs/pack-shield/references/dora/rts-its-guide.md +306 -306
  214. package/src/bmad-plus/packs/pack-shield/references/dora/third-party-risk.md +349 -349
  215. package/src/bmad-plus/packs/pack-shield/references/dpdpa/gdpr-comparison.md +173 -173
  216. package/src/bmad-plus/packs/pack-shield/references/dpdpa/rights-and-obligations.md +426 -426
  217. package/src/bmad-plus/packs/pack-shield/references/dpdpa/rules-2025.md +599 -599
  218. package/src/bmad-plus/packs/pack-shield/references/dpdpa/sections-reference.md +319 -319
  219. package/src/bmad-plus/packs/pack-shield/references/ear/ccl-eccn-guide.md +250 -250
  220. package/src/bmad-plus/packs/pack-shield/references/ear/compliance-program.md +280 -280
  221. package/src/bmad-plus/packs/pack-shield/references/ear/license-exceptions.md +207 -207
  222. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/gpai-governance.md +267 -267
  223. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/obligations-high-risk.md +287 -287
  224. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/risk-classification.md +182 -182
  225. package/src/bmad-plus/packs/pack-shield/references/fedramp/appendices-guide.md +209 -209
  226. package/src/bmad-plus/packs/pack-shield/references/fedramp/control-families.md +281 -281
  227. package/src/bmad-plus/packs/pack-shield/references/fedramp/poam-guide.md +93 -93
  228. package/src/bmad-plus/packs/pack-shield/references/fedramp/readiness-checklist.md +134 -134
  229. package/src/bmad-plus/packs/pack-shield/references/fedramp/sap-sar-guide.md +86 -86
  230. package/src/bmad-plus/packs/pack-shield/references/fedramp/ssp-guide.md +129 -129
  231. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/documents.md +192 -192
  232. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/dpa-template.md +121 -121
  233. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/privacy-notice.md +87 -87
  234. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/breach-notification.md +293 -293
  235. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/privacy-rule.md +276 -276
  236. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/security-rule.md +299 -299
  237. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/templates.md +568 -568
  238. package/src/bmad-plus/packs/pack-shield/references/ism/control-applicability.md +181 -181
  239. package/src/bmad-plus/packs/pack-shield/references/ism/guidelines-overview.md +183 -183
  240. package/src/bmad-plus/packs/pack-shield/references/iso27001/annex-a-2013.md +203 -203
  241. package/src/bmad-plus/packs/pack-shield/references/iso27001/annex-a-2022.md +132 -132
  242. package/src/bmad-plus/packs/pack-shield/references/iso27001/control-mapping.md +153 -153
  243. package/src/bmad-plus/packs/pack-shield/references/iso27701/annex-a-controls.md +195 -195
  244. package/src/bmad-plus/packs/pack-shield/references/iso27701/regulatory-mapping.md +229 -229
  245. package/src/bmad-plus/packs/pack-shield/references/iso27701/transition-guide.md +219 -219
  246. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-ai-risk-assessment.md +258 -258
  247. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-clauses-requirements.md +279 -279
  248. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-controls-annex-a.md +155 -155
  249. package/src/bmad-plus/packs/pack-shield/references/itar/compliance-program.md +174 -174
  250. package/src/bmad-plus/packs/pack-shield/references/itar/licensing-guide.md +146 -146
  251. package/src/bmad-plus/packs/pack-shield/references/itar/usml-categories.md +93 -93
  252. package/src/bmad-plus/packs/pack-shield/references/lgpd/anpd-enforcement.md +147 -147
  253. package/src/bmad-plus/packs/pack-shield/references/lgpd/compliance-program.md +272 -272
  254. package/src/bmad-plus/packs/pack-shield/references/lgpd/lgpd-articles.md +271 -271
  255. package/src/bmad-plus/packs/pack-shield/references/nis2/article-21-measures.md +153 -153
  256. package/src/bmad-plus/packs/pack-shield/references/nis2/iso27001-nis2-mapping.md +68 -68
  257. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/assessment-rmf.md +349 -349
  258. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/baselines-tailoring.md +277 -277
  259. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/control-families.md +450 -450
  260. package/src/bmad-plus/packs/pack-shield/references/nist-ai-rmf/rmf-core.md +361 -361
  261. package/src/bmad-plus/packs/pack-shield/references/nist-ai-rmf/rmf-profiles.md +192 -192
  262. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-10-to-20-mapping.md +143 -143
  263. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-20-functions-categories.md +278 -278
  264. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-implementation-tiers.md +135 -135
  265. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-requirements.md +366 -366
  266. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-saq-guide.md +217 -217
  267. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-v4-changes.md +190 -190
  268. package/src/bmad-plus/packs/pack-shield/references/section-508/wcag-mapping.md +160 -160
  269. package/src/bmad-plus/packs/pack-shield/references/soc2/controls.md +241 -241
  270. package/src/bmad-plus/packs/pack-shield/references/soc2/evidence.md +236 -236
  271. package/src/bmad-plus/packs/pack-shield/references/soc2/policies.md +254 -254
  272. package/src/bmad-plus/packs/pack-shield/references/soc2/vendor.md +276 -276
  273. package/src/bmad-plus/packs/pack-shield/references/swift-csp/swift-assessment.md +202 -202
  274. package/src/bmad-plus/packs/pack-shield/references/swift-csp/swift-controls.md +545 -545
  275. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-crmp-requirements.md +359 -359
  276. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-directives-overview.md +187 -187
  277. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-incident-reporting.md +187 -187
  278. package/src/bmad-plus/packs/pack-shield/references/wcag/criteria-detail.md +510 -510
  279. package/src/bmad-plus/packs/pack-shield/shared/audit-report-template.md +103 -103
  280. package/src/bmad-plus/packs/pack-shield/shared/cross-framework-mapper.md +103 -103
  281. package/src/bmad-plus/packs/pack-shield/shared/gap-analysis-template.md +83 -83
  282. package/src/bmad-plus/packs/pack-shield/shield-orchestrator.md +229 -229
  283. package/src/bmad-plus/packs/pack-shield/upstream-sync.yaml +68 -68
  284. package/src/bmad-plus/skills/bmad-plus-autopilot/SKILL.md +99 -99
  285. package/src/bmad-plus/skills/bmad-plus-parallel/SKILL.md +93 -93
  286. package/src/bmad-plus/skills/bmad-plus-sync/SKILL.md +69 -69
  287. package/tools/cli/commands/autoconfig.js +498 -489
  288. package/tools/cli/commands/doctor.js +222 -175
  289. package/tools/cli/commands/install.js +739 -739
  290. package/tools/cli/commands/memory.js +194 -194
  291. package/tools/cli/commands/scan.js +360 -350
  292. package/tools/cli/commands/uninstall.js +96 -96
  293. package/tools/cli/commands/update.js +174 -174
  294. package/tools/cli/i18n.js +763 -763
@@ -1,320 +1,320 @@
1
- # 🎯 PageSpeed Perfection Playbook — Battle-Tested Guide
2
-
3
- > **Version 1.0.0** — Based on 6+ real-world iterations achieving 99-100% on oveanet.ch, montpellier.ai, and oveanet.fr
4
- > By Laurent ROCHETTA × AI
5
-
6
- ---
7
-
8
- ## 📐 Architecture: The 4-Phase Protocol
9
-
10
- ```
11
- Phase 1: DIAGNOSTIC → Extract scores, identify all failing audits
12
- Phase 2: PERFORMANCE → Self-host fonts → Inline CSS → Cache → CLS
13
- Phase 3: ACCESSIBILITY → WCAG AA contrast fixes (systematic)
14
- Phase 4: BEST PRACTICES & SEO → Console errors, security, meta tags
15
- ```
16
-
17
- Each phase runs sequentially. **Backup before each phase.** Re-test after each phase.
18
-
19
- ---
20
-
21
- ## ⚠️ Anti-Patterns — Things That BREAK Scores
22
-
23
- > [!CAUTION]
24
- > These are real mistakes made during optimization that caused score REGRESSIONS.
25
-
26
- ### 🔴 NEVER: Async CSS Loading
27
- ```html
28
- <!-- ❌ DISASTER — causes CLS 0.936 on mobile -->
29
- <link rel="stylesheet" href="styles.css" media="print" onload="this.media='all'"/>
30
- <noscript><link rel="stylesheet" href="styles.css"/></noscript>
31
- ```
32
- **What happens:** The page renders with no styles, then FLASHES when CSS loads. PageSpeed measures this as a massive Cumulative Layout Shift (0.936 — nearly maximum). Performance dropped from 86 to 75.
33
-
34
- **Fix:** Either load CSS synchronously or inline it entirely.
35
-
36
- ### 🔴 NEVER: External Font CDN Without Fallback
37
- ```html
38
- <!-- ❌ Adds 300-800ms to LCP on mobile 4G -->
39
- <link href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;600;700" rel="stylesheet"/>
40
- ```
41
- **What happens:** DNS lookup + TLS handshake to `fonts.googleapis.com`, then another to `fonts.gstatic.com`. On 4G simulation, this adds 500ms+ to LCP.
42
-
43
- ### 🔴 NEVER: Images Without Dimensions
44
- ```html
45
- <!-- ❌ Causes CLS because browser doesn't know the space to reserve -->
46
- <img src="logo.svg" alt="Logo"/>
47
- ```
48
- **Fix:** Always add `width` and `height`:
49
- ```html
50
- <img src="logo.svg" alt="Logo" width="100" height="20"/>
51
- ```
52
-
53
- ---
54
-
55
- ## 🏆 Technique Catalog — Ordered by Impact
56
-
57
- ### [P1] Self-Host Fonts (Biggest LCP Win)
58
-
59
- **Impact:** LCP -30-50% on mobile, eliminates 2 external requests
60
-
61
- **Step 1:** Download fonts from Google Fonts API or copy from existing projects:
62
- ```
63
- fonts/
64
- ├── space-grotesk-400-latin.woff2
65
- ├── space-grotesk-600-latin.woff2
66
- └── space-grotesk-700-latin.woff2
67
- ```
68
-
69
- **Step 2:** Update CSS `@font-face` declarations:
70
- ```css
71
- /* ✅ Self-hosted — zero external requests */
72
- @font-face {
73
- font-family: 'Space Grotesk';
74
- font-style: normal;
75
- font-weight: 400;
76
- font-display: swap;
77
- src: url('fonts/space-grotesk-400-latin.woff2') format('woff2');
78
- }
79
- @font-face {
80
- font-family: 'Space Grotesk';
81
- font-style: normal;
82
- font-weight: 600;
83
- font-display: swap;
84
- src: url('fonts/space-grotesk-600-latin.woff2') format('woff2');
85
- }
86
- @font-face {
87
- font-family: 'Space Grotesk';
88
- font-style: normal;
89
- font-weight: 700;
90
- font-display: swap;
91
- src: url('fonts/space-grotesk-700-latin.woff2') format('woff2');
92
- }
93
- ```
94
-
95
- **Step 3:** Preload critical fonts in HTML `<head>`:
96
- ```html
97
- <link rel="preload" href="fonts/space-grotesk-400-latin.woff2"
98
- as="font" type="font/woff2" crossorigin fetchpriority="high"/>
99
- <link rel="preload" href="fonts/space-grotesk-600-latin.woff2"
100
- as="font" type="font/woff2" crossorigin/>
101
- ```
102
-
103
- **Step 4:** Remove ALL Google Fonts CDN references:
104
- ```diff
105
- -<link rel="preconnect" href="https://fonts.googleapis.com"/>
106
- -<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin/>
107
- -<link href="https://fonts.googleapis.com/css2?..." rel="stylesheet"/>
108
- +<!-- Fonts are self-hosted, no external CDN needed -->
109
- ```
110
-
111
- ### How to get woff2 files from Google Fonts:
112
- ```bash
113
- # Method 1: Use google-webfonts-helper
114
- # https://gwfh.mranftl.com/fonts
115
-
116
- # Method 2: Direct download with curl (set woff2 user-agent)
117
- curl -H "User-Agent: Mozilla/5.0" \
118
- "https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;600;700&display=swap" \
119
- | grep -oP 'url\(\K[^)]+' | while read url; do
120
- wget "$url" -P fonts/
121
- done
122
- ```
123
-
124
- ---
125
-
126
- ### [P2] Inline ALL CSS (Zero Render-Blocking)
127
-
128
- **Impact:** Eliminates render-blocking CSS request, reduces FCP by 100-300ms
129
-
130
- **For PHP sites** (like montpellier.ai):
131
- ```php
132
- <!-- ✅ CSS inlined at build time — zero render-blocking -->
133
- <style><?php echo file_get_contents(__DIR__ . '/styles.css'); ?></style>
134
- ```
135
-
136
- **For static HTML sites** (build script):
137
-
138
- PowerShell build script:
139
- ```powershell
140
- # build-dist.ps1 — Inline CSS into HTML for production
141
- $css = Get-Content "styles.css" -Raw
142
- $html = Get-Content "index.html" -Raw
143
-
144
- $cssInline = " <style>`n$css`n </style>"
145
-
146
- # Replace the critical CSS + external link with full inline
147
- $pattern = ' <!-- Critical CSS.*?</style>\s*\r?\n.*?<link rel="stylesheet" href="styles.css"/>'
148
- $html = $html -replace $pattern, $cssInline
149
-
150
- $html | Set-Content "dist/index.html" -Encoding UTF8
151
- ```
152
-
153
- Bash build script:
154
- ```bash
155
- #!/bin/bash
156
- # build-dist.sh — Inline CSS into HTML for production
157
- CSS=$(cat styles.css)
158
- sed -e '/<!-- Critical CSS/,/<link rel="stylesheet"/c\ <style>'"$CSS"'</style>' \
159
- index.html > dist/index.html
160
- ```
161
-
162
- > [!IMPORTANT]
163
- > Keep source files separate (index.html + styles.css) for development.
164
- > Only the dist/ version gets the inlined CSS for production.
165
-
166
- ---
167
-
168
- ### [P3] Cache Headers (.htaccess Template)
169
-
170
- **Impact:** Fixes "Use efficient cache policy" audit
171
-
172
- ```apache
173
- # === PageSpeed Cache & Compression — Ready to Deploy ===
174
-
175
- <IfModule mod_expires.c>
176
- ExpiresActive On
177
- ExpiresDefault "access plus 1 month"
178
- ExpiresByType text/html "access plus 1 hour"
179
- ExpiresByType text/css "access plus 1 year"
180
- ExpiresByType application/javascript "access plus 1 year"
181
- ExpiresByType image/svg+xml "access plus 1 year"
182
- ExpiresByType image/png "access plus 1 year"
183
- ExpiresByType image/webp "access plus 1 year"
184
- ExpiresByType font/woff2 "access plus 1 year"
185
- ExpiresByType application/font-woff2 "access plus 1 year"
186
- </IfModule>
187
-
188
- <IfModule mod_headers.c>
189
- <FilesMatch "\.(css|js|svg|png|webp|woff2|ico)$">
190
- Header set Cache-Control "public, max-age=31536000, immutable"
191
- </FilesMatch>
192
- <FilesMatch "\.(html|php)$">
193
- Header set Cache-Control "public, max-age=3600, must-revalidate"
194
- </FilesMatch>
195
- <FilesMatch "\.(txt|xml)$">
196
- Header set Cache-Control "public, max-age=86400"
197
- </FilesMatch>
198
- </IfModule>
199
-
200
- # Gzip Compression
201
- <IfModule mod_deflate.c>
202
- AddOutputFilterByType DEFLATE text/html text/css application/javascript
203
- AddOutputFilterByType DEFLATE text/javascript application/json text/xml
204
- AddOutputFilterByType DEFLATE image/svg+xml text/plain
205
- </IfModule>
206
- ```
207
-
208
- ---
209
-
210
- ### [P4] CLS Prevention Checklist
211
-
212
- | Element | Required Fix |
213
- |---------|-------------|
214
- | `<img>` tags | Add `width` and `height` attributes |
215
- | CSS-loaded fonts | Use `font-display: swap` |
216
- | CSS loading | NEVER use `media="print" onload` trick |
217
- | Dynamic content | Reserve space with min-height |
218
- | Embeds/iframes | Set explicit dimensions |
219
-
220
- ---
221
-
222
- ## 🎨 Accessibility — Contrast Ratio Reference
223
-
224
- ### The Rule
225
- WCAG AA requires **4.5:1** contrast ratio for normal text, **3:1** for large text (18px+ or 14px+ bold).
226
-
227
- ### Common Color Combos on Dark Backgrounds (#0B0C15)
228
-
229
- | Text Color | Hex | Ratio vs #0B0C15 | Pass? |
230
- |-----------|-----|:-----------------:|:-----:|
231
- | Pure white | `#ffffff` | 19.2:1 | ✅ |
232
- | Light gray | `#d4dde3` | 12.5:1 | ✅ |
233
- | Medium gray | `#a0b0b8` | 6.5:1 | ✅ |
234
- | Muted gray | `#b0bec5` | 8.0:1 | ✅ |
235
- | Dim gray | `#6b7b8a` | 3.7:1 | ❌ |
236
- | Very dim | `#4a5568` | 2.3:1 | ❌ |
237
-
238
- ### Common Color Combos on Orange (#E8632B)
239
-
240
- | Text Color | Hex | Ratio vs #E8632B | Pass? |
241
- |-----------|-----|:-----------------:|:-----:|
242
- | White | `#ffffff` | 3.3:1 | ❌ FAIL |
243
- | Light cream | `#fff5e6` | 3.1:1 | ❌ FAIL |
244
- | Dark brown | `#1a0800` | 8.5:1 | ✅ |
245
- | Black | `#000000` | 4.0:1 | ✅ (large) |
246
-
247
- > [!WARNING]
248
- > **White text on orange buttons is a classic fail.** Ratio is only 3.3:1.
249
- > Use dark text (`#1a0800`) instead for buttons, badges, and active states with orange backgrounds.
250
-
251
- ### Elements Commonly Flagged by PageSpeed
252
- 1. **CTA buttons** (`.btn-primary`) — white on primary color
253
- 2. **Active language buttons** (`.lang-btn.active`) — white on primary
254
- 3. **Pricing badges** ("Most Popular") — white on primary
255
- 4. **Footer text** — dim on very dark background
256
- 5. **Form labels** — muted on dark
257
- 6. **Badge text** (partner badges, sponsor badges) — muted on dark with transparency
258
-
259
- ---
260
-
261
- ## 📊 Score Tracking Template
262
-
263
- ```markdown
264
- | Iteration | Perf (M) | A11y (M) | Perf (D) | A11y (D) | BP | SEO | Changes |
265
- |:---------:|:--------:|:--------:|:--------:|:--------:|:---:|:---:|---------|
266
- | Baseline | ? | ? | ? | ? | ? | ? | Initial |
267
- | #1 | | | | | | | |
268
- | #2 | | | | | | | |
269
- ```
270
-
271
- ---
272
-
273
- ## 🔧 PageSpeed JavaScript Extraction Snippets
274
-
275
- Use these in the browser to extract structured data from PageSpeed results:
276
-
277
- ### Extract All Scores
278
- ```javascript
279
- JSON.stringify({
280
- gauges: Array.from(document.querySelectorAll('.lh-gauge__percentage'))
281
- .map(g => g.textContent.trim()),
282
- labels: Array.from(document.querySelectorAll('.lh-gauge__label'))
283
- .map(l => l.textContent.trim())
284
- });
285
- ```
286
-
287
- ### Extract Core Web Vitals
288
- ```javascript
289
- JSON.stringify({
290
- metrics: Array.from(document.querySelectorAll('.lh-metric'))
291
- .map(m => ({
292
- name: m.querySelector('.lh-metric__title')?.textContent?.trim(),
293
- value: m.querySelector('.lh-metric__value')?.textContent?.trim()
294
- }))
295
- });
296
- ```
297
-
298
- ### Extract Failing Audits
299
- ```javascript
300
- JSON.stringify({
301
- failed: Array.from(document.querySelectorAll('.lh-audit--fail .lh-audit__title'))
302
- .map(a => a.textContent.trim().substring(0, 150)),
303
- warnings: Array.from(document.querySelectorAll('.lh-audit--average .lh-audit__title'))
304
- .map(a => a.textContent.trim().substring(0, 150))
305
- });
306
- ```
307
-
308
- ---
309
-
310
- ## 🏁 Exit Conditions
311
-
312
- The PageSpeed Perfection Loop STOPS when:
313
- - ✅ **ALL 4 scores = 100/100** → Perfection achieved
314
- - ⚠️ **After 8 iterations** → Report remaining issues with root cause analysis
315
- - 🟡 **Only server-side issues remain** (TTFB, CDN, HTTP/2) → Report as "requires server-side changes"
316
- - 🟡 **Only third-party script issues remain** (Cloudflare Turnstile, analytics) → Report as "not fixable client-side"
317
-
318
- ---
319
-
320
- *Built with ❤️ in Montpellier, France — by Laurent ROCHETTA × AI*
1
+ # 🎯 PageSpeed Perfection Playbook — Battle-Tested Guide
2
+
3
+ > **Version 1.0.0** — Based on 6+ real-world iterations achieving 99-100% on oveanet.ch, montpellier.ai, and oveanet.fr
4
+ > By Laurent ROCHETTA × AI
5
+
6
+ ---
7
+
8
+ ## 📐 Architecture: The 4-Phase Protocol
9
+
10
+ ```
11
+ Phase 1: DIAGNOSTIC → Extract scores, identify all failing audits
12
+ Phase 2: PERFORMANCE → Self-host fonts → Inline CSS → Cache → CLS
13
+ Phase 3: ACCESSIBILITY → WCAG AA contrast fixes (systematic)
14
+ Phase 4: BEST PRACTICES & SEO → Console errors, security, meta tags
15
+ ```
16
+
17
+ Each phase runs sequentially. **Backup before each phase.** Re-test after each phase.
18
+
19
+ ---
20
+
21
+ ## ⚠️ Anti-Patterns — Things That BREAK Scores
22
+
23
+ > [!CAUTION]
24
+ > These are real mistakes made during optimization that caused score REGRESSIONS.
25
+
26
+ ### 🔴 NEVER: Async CSS Loading
27
+ ```html
28
+ <!-- ❌ DISASTER — causes CLS 0.936 on mobile -->
29
+ <link rel="stylesheet" href="styles.css" media="print" onload="this.media='all'"/>
30
+ <noscript><link rel="stylesheet" href="styles.css"/></noscript>
31
+ ```
32
+ **What happens:** The page renders with no styles, then FLASHES when CSS loads. PageSpeed measures this as a massive Cumulative Layout Shift (0.936 — nearly maximum). Performance dropped from 86 to 75.
33
+
34
+ **Fix:** Either load CSS synchronously or inline it entirely.
35
+
36
+ ### 🔴 NEVER: External Font CDN Without Fallback
37
+ ```html
38
+ <!-- ❌ Adds 300-800ms to LCP on mobile 4G -->
39
+ <link href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;600;700" rel="stylesheet"/>
40
+ ```
41
+ **What happens:** DNS lookup + TLS handshake to `fonts.googleapis.com`, then another to `fonts.gstatic.com`. On 4G simulation, this adds 500ms+ to LCP.
42
+
43
+ ### 🔴 NEVER: Images Without Dimensions
44
+ ```html
45
+ <!-- ❌ Causes CLS because browser doesn't know the space to reserve -->
46
+ <img src="logo.svg" alt="Logo"/>
47
+ ```
48
+ **Fix:** Always add `width` and `height`:
49
+ ```html
50
+ <img src="logo.svg" alt="Logo" width="100" height="20"/>
51
+ ```
52
+
53
+ ---
54
+
55
+ ## 🏆 Technique Catalog — Ordered by Impact
56
+
57
+ ### [P1] Self-Host Fonts (Biggest LCP Win)
58
+
59
+ **Impact:** LCP -30-50% on mobile, eliminates 2 external requests
60
+
61
+ **Step 1:** Download fonts from Google Fonts API or copy from existing projects:
62
+ ```
63
+ fonts/
64
+ ├── space-grotesk-400-latin.woff2
65
+ ├── space-grotesk-600-latin.woff2
66
+ └── space-grotesk-700-latin.woff2
67
+ ```
68
+
69
+ **Step 2:** Update CSS `@font-face` declarations:
70
+ ```css
71
+ /* ✅ Self-hosted — zero external requests */
72
+ @font-face {
73
+ font-family: 'Space Grotesk';
74
+ font-style: normal;
75
+ font-weight: 400;
76
+ font-display: swap;
77
+ src: url('fonts/space-grotesk-400-latin.woff2') format('woff2');
78
+ }
79
+ @font-face {
80
+ font-family: 'Space Grotesk';
81
+ font-style: normal;
82
+ font-weight: 600;
83
+ font-display: swap;
84
+ src: url('fonts/space-grotesk-600-latin.woff2') format('woff2');
85
+ }
86
+ @font-face {
87
+ font-family: 'Space Grotesk';
88
+ font-style: normal;
89
+ font-weight: 700;
90
+ font-display: swap;
91
+ src: url('fonts/space-grotesk-700-latin.woff2') format('woff2');
92
+ }
93
+ ```
94
+
95
+ **Step 3:** Preload critical fonts in HTML `<head>`:
96
+ ```html
97
+ <link rel="preload" href="fonts/space-grotesk-400-latin.woff2"
98
+ as="font" type="font/woff2" crossorigin fetchpriority="high"/>
99
+ <link rel="preload" href="fonts/space-grotesk-600-latin.woff2"
100
+ as="font" type="font/woff2" crossorigin/>
101
+ ```
102
+
103
+ **Step 4:** Remove ALL Google Fonts CDN references:
104
+ ```diff
105
+ -<link rel="preconnect" href="https://fonts.googleapis.com"/>
106
+ -<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin/>
107
+ -<link href="https://fonts.googleapis.com/css2?..." rel="stylesheet"/>
108
+ +<!-- Fonts are self-hosted, no external CDN needed -->
109
+ ```
110
+
111
+ ### How to get woff2 files from Google Fonts:
112
+ ```bash
113
+ # Method 1: Use google-webfonts-helper
114
+ # https://gwfh.mranftl.com/fonts
115
+
116
+ # Method 2: Direct download with curl (set woff2 user-agent)
117
+ curl -H "User-Agent: Mozilla/5.0" \
118
+ "https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;600;700&display=swap" \
119
+ | grep -oP 'url\(\K[^)]+' | while read url; do
120
+ wget "$url" -P fonts/
121
+ done
122
+ ```
123
+
124
+ ---
125
+
126
+ ### [P2] Inline ALL CSS (Zero Render-Blocking)
127
+
128
+ **Impact:** Eliminates render-blocking CSS request, reduces FCP by 100-300ms
129
+
130
+ **For PHP sites** (like montpellier.ai):
131
+ ```php
132
+ <!-- ✅ CSS inlined at build time — zero render-blocking -->
133
+ <style><?php echo file_get_contents(__DIR__ . '/styles.css'); ?></style>
134
+ ```
135
+
136
+ **For static HTML sites** (build script):
137
+
138
+ PowerShell build script:
139
+ ```powershell
140
+ # build-dist.ps1 — Inline CSS into HTML for production
141
+ $css = Get-Content "styles.css" -Raw
142
+ $html = Get-Content "index.html" -Raw
143
+
144
+ $cssInline = " <style>`n$css`n </style>"
145
+
146
+ # Replace the critical CSS + external link with full inline
147
+ $pattern = ' <!-- Critical CSS.*?</style>\s*\r?\n.*?<link rel="stylesheet" href="styles.css"/>'
148
+ $html = $html -replace $pattern, $cssInline
149
+
150
+ $html | Set-Content "dist/index.html" -Encoding UTF8
151
+ ```
152
+
153
+ Bash build script:
154
+ ```bash
155
+ #!/bin/bash
156
+ # build-dist.sh — Inline CSS into HTML for production
157
+ CSS=$(cat styles.css)
158
+ sed -e '/<!-- Critical CSS/,/<link rel="stylesheet"/c\ <style>'"$CSS"'</style>' \
159
+ index.html > dist/index.html
160
+ ```
161
+
162
+ > [!IMPORTANT]
163
+ > Keep source files separate (index.html + styles.css) for development.
164
+ > Only the dist/ version gets the inlined CSS for production.
165
+
166
+ ---
167
+
168
+ ### [P3] Cache Headers (.htaccess Template)
169
+
170
+ **Impact:** Fixes "Use efficient cache policy" audit
171
+
172
+ ```apache
173
+ # === PageSpeed Cache & Compression — Ready to Deploy ===
174
+
175
+ <IfModule mod_expires.c>
176
+ ExpiresActive On
177
+ ExpiresDefault "access plus 1 month"
178
+ ExpiresByType text/html "access plus 1 hour"
179
+ ExpiresByType text/css "access plus 1 year"
180
+ ExpiresByType application/javascript "access plus 1 year"
181
+ ExpiresByType image/svg+xml "access plus 1 year"
182
+ ExpiresByType image/png "access plus 1 year"
183
+ ExpiresByType image/webp "access plus 1 year"
184
+ ExpiresByType font/woff2 "access plus 1 year"
185
+ ExpiresByType application/font-woff2 "access plus 1 year"
186
+ </IfModule>
187
+
188
+ <IfModule mod_headers.c>
189
+ <FilesMatch "\.(css|js|svg|png|webp|woff2|ico)$">
190
+ Header set Cache-Control "public, max-age=31536000, immutable"
191
+ </FilesMatch>
192
+ <FilesMatch "\.(html|php)$">
193
+ Header set Cache-Control "public, max-age=3600, must-revalidate"
194
+ </FilesMatch>
195
+ <FilesMatch "\.(txt|xml)$">
196
+ Header set Cache-Control "public, max-age=86400"
197
+ </FilesMatch>
198
+ </IfModule>
199
+
200
+ # Gzip Compression
201
+ <IfModule mod_deflate.c>
202
+ AddOutputFilterByType DEFLATE text/html text/css application/javascript
203
+ AddOutputFilterByType DEFLATE text/javascript application/json text/xml
204
+ AddOutputFilterByType DEFLATE image/svg+xml text/plain
205
+ </IfModule>
206
+ ```
207
+
208
+ ---
209
+
210
+ ### [P4] CLS Prevention Checklist
211
+
212
+ | Element | Required Fix |
213
+ |---------|-------------|
214
+ | `<img>` tags | Add `width` and `height` attributes |
215
+ | CSS-loaded fonts | Use `font-display: swap` |
216
+ | CSS loading | NEVER use `media="print" onload` trick |
217
+ | Dynamic content | Reserve space with min-height |
218
+ | Embeds/iframes | Set explicit dimensions |
219
+
220
+ ---
221
+
222
+ ## 🎨 Accessibility — Contrast Ratio Reference
223
+
224
+ ### The Rule
225
+ WCAG AA requires **4.5:1** contrast ratio for normal text, **3:1** for large text (18px+ or 14px+ bold).
226
+
227
+ ### Common Color Combos on Dark Backgrounds (#0B0C15)
228
+
229
+ | Text Color | Hex | Ratio vs #0B0C15 | Pass? |
230
+ |-----------|-----|:-----------------:|:-----:|
231
+ | Pure white | `#ffffff` | 19.2:1 | ✅ |
232
+ | Light gray | `#d4dde3` | 12.5:1 | ✅ |
233
+ | Medium gray | `#a0b0b8` | 6.5:1 | ✅ |
234
+ | Muted gray | `#b0bec5` | 8.0:1 | ✅ |
235
+ | Dim gray | `#6b7b8a` | 3.7:1 | ❌ |
236
+ | Very dim | `#4a5568` | 2.3:1 | ❌ |
237
+
238
+ ### Common Color Combos on Orange (#E8632B)
239
+
240
+ | Text Color | Hex | Ratio vs #E8632B | Pass? |
241
+ |-----------|-----|:-----------------:|:-----:|
242
+ | White | `#ffffff` | 3.3:1 | ❌ FAIL |
243
+ | Light cream | `#fff5e6` | 3.1:1 | ❌ FAIL |
244
+ | Dark brown | `#1a0800` | 8.5:1 | ✅ |
245
+ | Black | `#000000` | 4.0:1 | ✅ (large) |
246
+
247
+ > [!WARNING]
248
+ > **White text on orange buttons is a classic fail.** Ratio is only 3.3:1.
249
+ > Use dark text (`#1a0800`) instead for buttons, badges, and active states with orange backgrounds.
250
+
251
+ ### Elements Commonly Flagged by PageSpeed
252
+ 1. **CTA buttons** (`.btn-primary`) — white on primary color
253
+ 2. **Active language buttons** (`.lang-btn.active`) — white on primary
254
+ 3. **Pricing badges** ("Most Popular") — white on primary
255
+ 4. **Footer text** — dim on very dark background
256
+ 5. **Form labels** — muted on dark
257
+ 6. **Badge text** (partner badges, sponsor badges) — muted on dark with transparency
258
+
259
+ ---
260
+
261
+ ## 📊 Score Tracking Template
262
+
263
+ ```markdown
264
+ | Iteration | Perf (M) | A11y (M) | Perf (D) | A11y (D) | BP | SEO | Changes |
265
+ |:---------:|:--------:|:--------:|:--------:|:--------:|:---:|:---:|---------|
266
+ | Baseline | ? | ? | ? | ? | ? | ? | Initial |
267
+ | #1 | | | | | | | |
268
+ | #2 | | | | | | | |
269
+ ```
270
+
271
+ ---
272
+
273
+ ## 🔧 PageSpeed JavaScript Extraction Snippets
274
+
275
+ Use these in the browser to extract structured data from PageSpeed results:
276
+
277
+ ### Extract All Scores
278
+ ```javascript
279
+ JSON.stringify({
280
+ gauges: Array.from(document.querySelectorAll('.lh-gauge__percentage'))
281
+ .map(g => g.textContent.trim()),
282
+ labels: Array.from(document.querySelectorAll('.lh-gauge__label'))
283
+ .map(l => l.textContent.trim())
284
+ });
285
+ ```
286
+
287
+ ### Extract Core Web Vitals
288
+ ```javascript
289
+ JSON.stringify({
290
+ metrics: Array.from(document.querySelectorAll('.lh-metric'))
291
+ .map(m => ({
292
+ name: m.querySelector('.lh-metric__title')?.textContent?.trim(),
293
+ value: m.querySelector('.lh-metric__value')?.textContent?.trim()
294
+ }))
295
+ });
296
+ ```
297
+
298
+ ### Extract Failing Audits
299
+ ```javascript
300
+ JSON.stringify({
301
+ failed: Array.from(document.querySelectorAll('.lh-audit--fail .lh-audit__title'))
302
+ .map(a => a.textContent.trim().substring(0, 150)),
303
+ warnings: Array.from(document.querySelectorAll('.lh-audit--average .lh-audit__title'))
304
+ .map(a => a.textContent.trim().substring(0, 150))
305
+ });
306
+ ```
307
+
308
+ ---
309
+
310
+ ## 🏁 Exit Conditions
311
+
312
+ The PageSpeed Perfection Loop STOPS when:
313
+ - ✅ **ALL 4 scores = 100/100** → Perfection achieved
314
+ - ⚠️ **After 8 iterations** → Report remaining issues with root cause analysis
315
+ - 🟡 **Only server-side issues remain** (TTFB, CDN, HTTP/2) → Report as "requires server-side changes"
316
+ - 🟡 **Only third-party script issues remain** (Cloudflare Turnstile, analytics) → Report as "not fixable client-side"
317
+
318
+ ---
319
+
320
+ *Built with ❤️ in Montpellier, France — by Laurent ROCHETTA × AI*