bmad-plus 0.7.5 → 0.9.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 (281) hide show
  1. package/CHANGELOG.md +479 -425
  2. package/LICENSE +21 -21
  3. package/README.md +557 -447
  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 +584 -426
  31. package/readme-international/README.es.md +601 -518
  32. package/readme-international/README.fr.md +599 -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/data/role-triggers.yaml +209 -209
  46. package/src/bmad-plus/module-help.csv +10 -10
  47. package/src/bmad-plus/module.yaml +283 -280
  48. package/src/bmad-plus/{agents → packs}/pack-animated/animated-website-agent.md +325 -325
  49. package/src/bmad-plus/{agents → packs}/pack-animated/templates/animated-website-workflow.md +55 -55
  50. package/src/bmad-plus/{agents → packs}/pack-backup/backup-agent.md +71 -71
  51. package/src/bmad-plus/{agents → packs}/pack-backup/templates/backup-workflow.md +51 -51
  52. package/src/bmad-plus/packs/pack-dev-studio/README.md +162 -162
  53. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/analyst-agent.md +73 -73
  54. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/document-project.md +61 -61
  55. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/domain-research.md +95 -95
  56. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/market-research.md +95 -95
  57. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/prfaq.md +134 -134
  58. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/product-brief.md +80 -80
  59. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/tech-writer-agent.md +73 -73
  60. package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/technical-research.md +95 -95
  61. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/architect-agent.md +73 -73
  62. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-architecture.md +73 -73
  63. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-epics-stories.md +92 -92
  64. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/generate-project-context.md +80 -80
  65. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/implementation-readiness.md +90 -90
  66. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01-init.md +153 -153
  67. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01b-continue.md +173 -173
  68. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-02-context.md +224 -224
  69. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-03-starter.md +329 -329
  70. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-04-decisions.md +318 -318
  71. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-05-patterns.md +359 -359
  72. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-06-structure.md +379 -379
  73. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-07-validation.md +361 -361
  74. package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-08-complete.md +81 -81
  75. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/checkpoint-preview.md +67 -67
  76. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-01-gather-context.md +85 -85
  77. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-02-review.md +35 -35
  78. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-03-triage.md +49 -49
  79. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-04-present.md +131 -131
  80. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review.md +89 -89
  81. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/correct-course.md +300 -300
  82. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/create-story.md +428 -428
  83. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-agent.md +73 -73
  84. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story-checklist.md +80 -80
  85. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story.md +484 -484
  86. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/investigate.md +193 -193
  87. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/qa-e2e-tests.md +175 -175
  88. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/quick-dev.md +110 -110
  89. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/retrospective.md +1511 -1511
  90. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-planning.md +298 -298
  91. package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-status.md +296 -296
  92. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-prd.md +29 -29
  93. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-ux-design.md +74 -74
  94. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/edit-prd.md +29 -29
  95. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/pm-agent.md +73 -73
  96. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/prd.md +89 -89
  97. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/ux-designer-agent.md +73 -73
  98. package/src/bmad-plus/packs/pack-dev-studio/categories/planning/validate-prd.md +29 -29
  99. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/advanced-elicitation.md +141 -141
  100. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/adversarial-review.md +37 -37
  101. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/bmad-help.md +75 -75
  102. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/brainstorming.md +6 -6
  103. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/customize.md +110 -110
  104. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/distillator.md +176 -176
  105. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/edge-case-hunter.md +67 -67
  106. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-prose.md +86 -86
  107. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-structure.md +179 -179
  108. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/index-docs.md +66 -66
  109. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/party-mode.md +127 -127
  110. package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/shard-doc.md +105 -105
  111. package/src/bmad-plus/packs/pack-dev-studio/dev-studio-orchestrator.md +120 -120
  112. package/src/bmad-plus/packs/pack-dev-studio/shared/architecture-decision-template.md +12 -12
  113. package/src/bmad-plus/packs/pack-dev-studio/shared/bwml-spec.md +328 -328
  114. package/src/bmad-plus/packs/pack-dev-studio/shared/module-help.csv +32 -32
  115. package/src/bmad-plus/packs/pack-dev-studio/upstream-sync.yaml +81 -81
  116. package/src/bmad-plus/packs/pack-memory/README.md +106 -106
  117. package/src/bmad-plus/packs/pack-memory/memory-orchestrator.md +79 -79
  118. package/src/bmad-plus/packs/pack-memory/shared/karpathy-guardrails.md +86 -86
  119. package/src/bmad-plus/packs/pack-memory/shared/memory-protocol.md +143 -143
  120. package/src/bmad-plus/packs/pack-memory/templates/context.md +39 -39
  121. package/src/bmad-plus/packs/pack-memory/templates/decisions.md +25 -25
  122. package/src/bmad-plus/packs/pack-memory/templates/identity.yaml +39 -39
  123. package/src/bmad-plus/packs/pack-memory/templates/lessons.md +31 -31
  124. package/src/bmad-plus/packs/pack-memory/templates/patterns.md +24 -24
  125. package/src/bmad-plus/packs/pack-memory/templates/session-handoff.md +25 -25
  126. package/src/bmad-plus/packs/pack-memory/zecher-agent.md +157 -157
  127. package/src/bmad-plus/{agents → packs}/pack-seo/SKILL.md +171 -171
  128. package/src/bmad-plus/packs/pack-seo/bmad-skill-manifest.yaml +13 -0
  129. package/src/bmad-plus/{agents → packs}/pack-seo/checklist.md +140 -140
  130. package/src/bmad-plus/{agents → packs}/pack-seo/pagespeed-playbook.md +320 -320
  131. package/src/bmad-plus/{agents → packs}/pack-seo/ref/audit-schema.json +187 -187
  132. package/src/bmad-plus/{agents → packs}/pack-seo/ref/cwv-thresholds.md +87 -87
  133. package/src/bmad-plus/{agents → packs}/pack-seo/ref/eeat-criteria.md +123 -123
  134. package/src/bmad-plus/{agents → packs}/pack-seo/ref/geo-signals.md +167 -167
  135. package/src/bmad-plus/{agents → packs}/pack-seo/ref/hreflang-rules.md +153 -153
  136. package/src/bmad-plus/{agents → packs}/pack-seo/ref/quality-gates.md +133 -133
  137. package/src/bmad-plus/{agents → packs}/pack-seo/ref/schema-catalog.md +91 -91
  138. package/src/bmad-plus/{agents → packs}/pack-seo/ref/schema-templates.json +356 -356
  139. package/src/bmad-plus/{agents → packs}/pack-seo/seo-chief.md +294 -294
  140. package/src/bmad-plus/{agents → packs}/pack-seo/seo-judge.md +241 -241
  141. package/src/bmad-plus/{agents → packs}/pack-seo/seo-scout.md +171 -171
  142. package/src/bmad-plus/{agents → packs}/pack-seo/templates/seo-audit-workflow.md +241 -241
  143. package/src/bmad-plus/packs/pack-shield/README.md +110 -110
  144. package/src/bmad-plus/packs/pack-shield/SKILL.md +82 -0
  145. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/csrd-agent.md +262 -262
  146. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/section508-agent.md +179 -179
  147. package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/wcag-agent.md +201 -201
  148. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/eu-ai-act-agent.md +97 -97
  149. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/iso42001-agent.md +251 -251
  150. package/src/bmad-plus/packs/pack-shield/categories/ai-governance/nist-ai-rmf-agent.md +133 -133
  151. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/cis-controls-agent.md +221 -221
  152. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/ism-agent.md +150 -150
  153. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/iso27001-agent.md +167 -167
  154. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nis2-agent.md +83 -83
  155. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-800-53-agent.md +250 -250
  156. package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-csf-agent.md +218 -218
  157. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/ccpa-agent.md +94 -94
  158. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/dpdpa-agent.md +136 -136
  159. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/gdpr-agent.md +296 -296
  160. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/iso27701-agent.md +134 -134
  161. package/src/bmad-plus/packs/pack-shield/categories/data-privacy/lgpd-agent.md +129 -129
  162. package/src/bmad-plus/packs/pack-shield/categories/defense-export/cmmc-agent.md +127 -127
  163. package/src/bmad-plus/packs/pack-shield/categories/defense-export/ear-agent.md +272 -272
  164. package/src/bmad-plus/packs/pack-shield/categories/defense-export/itar-agent.md +202 -202
  165. package/src/bmad-plus/packs/pack-shield/categories/defense-export/tsa-agent.md +367 -367
  166. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/dora-agent.md +510 -510
  167. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/fedramp-agent.md +247 -247
  168. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/hipaa-agent.md +173 -173
  169. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/pci-dss-agent.md +239 -239
  170. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/soc2-agent.md +266 -266
  171. package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/swift-csp-agent.md +164 -164
  172. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-classifier.md +131 -131
  173. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-fria.md +155 -155
  174. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-incidents.md +187 -187
  175. package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-roles.md +113 -113
  176. package/src/bmad-plus/packs/pack-shield/categories/workflows/breach-sentinel.md +197 -197
  177. package/src/bmad-plus/packs/pack-shield/categories/workflows/cookie-policy-gen.md +180 -180
  178. package/src/bmad-plus/packs/pack-shield/categories/workflows/dpia-sentinel.md +235 -235
  179. package/src/bmad-plus/packs/pack-shield/categories/workflows/legitimate-interest.md +159 -159
  180. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-advisor.md +133 -133
  181. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-notice-gen.md +160 -160
  182. package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-policy-gen.md +135 -135
  183. package/src/bmad-plus/packs/pack-shield/references/ccpa/ccpa-gdpr-comparison.md +117 -117
  184. package/src/bmad-plus/packs/pack-shield/references/ccpa/consumer-rights-workflows.md +177 -177
  185. package/src/bmad-plus/packs/pack-shield/references/cis-controls/framework-mappings.md +162 -162
  186. package/src/bmad-plus/packs/pack-shield/references/cis-controls/implementation-guidance.md +235 -235
  187. package/src/bmad-plus/packs/pack-shield/references/cis-controls/safeguards-detail.md +252 -252
  188. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-assessment.md +170 -170
  189. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-levels.md +113 -113
  190. package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-practices.md +211 -211
  191. package/src/bmad-plus/packs/pack-shield/references/csrd/compliance-program.md +281 -281
  192. package/src/bmad-plus/packs/pack-shield/references/csrd/double-materiality.md +253 -253
  193. package/src/bmad-plus/packs/pack-shield/references/csrd/esrs-standards.md +401 -401
  194. package/src/bmad-plus/packs/pack-shield/references/dora/article-reference.md +441 -441
  195. package/src/bmad-plus/packs/pack-shield/references/dora/incident-classification.md +297 -297
  196. package/src/bmad-plus/packs/pack-shield/references/dora/rts-its-guide.md +306 -306
  197. package/src/bmad-plus/packs/pack-shield/references/dora/third-party-risk.md +349 -349
  198. package/src/bmad-plus/packs/pack-shield/references/dpdpa/gdpr-comparison.md +173 -173
  199. package/src/bmad-plus/packs/pack-shield/references/dpdpa/rights-and-obligations.md +426 -426
  200. package/src/bmad-plus/packs/pack-shield/references/dpdpa/rules-2025.md +599 -599
  201. package/src/bmad-plus/packs/pack-shield/references/dpdpa/sections-reference.md +319 -319
  202. package/src/bmad-plus/packs/pack-shield/references/ear/ccl-eccn-guide.md +250 -250
  203. package/src/bmad-plus/packs/pack-shield/references/ear/compliance-program.md +280 -280
  204. package/src/bmad-plus/packs/pack-shield/references/ear/license-exceptions.md +207 -207
  205. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/gpai-governance.md +267 -267
  206. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/obligations-high-risk.md +287 -287
  207. package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/risk-classification.md +182 -182
  208. package/src/bmad-plus/packs/pack-shield/references/fedramp/appendices-guide.md +209 -209
  209. package/src/bmad-plus/packs/pack-shield/references/fedramp/control-families.md +281 -281
  210. package/src/bmad-plus/packs/pack-shield/references/fedramp/poam-guide.md +93 -93
  211. package/src/bmad-plus/packs/pack-shield/references/fedramp/readiness-checklist.md +134 -134
  212. package/src/bmad-plus/packs/pack-shield/references/fedramp/sap-sar-guide.md +86 -86
  213. package/src/bmad-plus/packs/pack-shield/references/fedramp/ssp-guide.md +129 -129
  214. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/documents.md +192 -192
  215. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/dpa-template.md +121 -121
  216. package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/privacy-notice.md +87 -87
  217. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/breach-notification.md +293 -293
  218. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/privacy-rule.md +276 -276
  219. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/security-rule.md +299 -299
  220. package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/templates.md +568 -568
  221. package/src/bmad-plus/packs/pack-shield/references/ism/control-applicability.md +181 -181
  222. package/src/bmad-plus/packs/pack-shield/references/ism/guidelines-overview.md +183 -183
  223. package/src/bmad-plus/packs/pack-shield/references/iso27001/annex-a-2013.md +203 -203
  224. package/src/bmad-plus/packs/pack-shield/references/iso27001/annex-a-2022.md +132 -132
  225. package/src/bmad-plus/packs/pack-shield/references/iso27001/control-mapping.md +153 -153
  226. package/src/bmad-plus/packs/pack-shield/references/iso27701/annex-a-controls.md +195 -195
  227. package/src/bmad-plus/packs/pack-shield/references/iso27701/regulatory-mapping.md +229 -229
  228. package/src/bmad-plus/packs/pack-shield/references/iso27701/transition-guide.md +219 -219
  229. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-ai-risk-assessment.md +258 -258
  230. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-clauses-requirements.md +279 -279
  231. package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-controls-annex-a.md +155 -155
  232. package/src/bmad-plus/packs/pack-shield/references/itar/compliance-program.md +174 -174
  233. package/src/bmad-plus/packs/pack-shield/references/itar/licensing-guide.md +146 -146
  234. package/src/bmad-plus/packs/pack-shield/references/itar/usml-categories.md +93 -93
  235. package/src/bmad-plus/packs/pack-shield/references/lgpd/anpd-enforcement.md +147 -147
  236. package/src/bmad-plus/packs/pack-shield/references/lgpd/compliance-program.md +272 -272
  237. package/src/bmad-plus/packs/pack-shield/references/lgpd/lgpd-articles.md +271 -271
  238. package/src/bmad-plus/packs/pack-shield/references/nis2/article-21-measures.md +153 -153
  239. package/src/bmad-plus/packs/pack-shield/references/nis2/iso27001-nis2-mapping.md +68 -68
  240. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/assessment-rmf.md +349 -349
  241. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/baselines-tailoring.md +277 -277
  242. package/src/bmad-plus/packs/pack-shield/references/nist-800-53/control-families.md +450 -450
  243. package/src/bmad-plus/packs/pack-shield/references/nist-ai-rmf/rmf-core.md +361 -361
  244. package/src/bmad-plus/packs/pack-shield/references/nist-ai-rmf/rmf-profiles.md +192 -192
  245. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-10-to-20-mapping.md +143 -143
  246. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-20-functions-categories.md +278 -278
  247. package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-implementation-tiers.md +135 -135
  248. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-requirements.md +366 -366
  249. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-saq-guide.md +217 -217
  250. package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-v4-changes.md +190 -190
  251. package/src/bmad-plus/packs/pack-shield/references/section-508/wcag-mapping.md +160 -160
  252. package/src/bmad-plus/packs/pack-shield/references/soc2/controls.md +241 -241
  253. package/src/bmad-plus/packs/pack-shield/references/soc2/evidence.md +236 -236
  254. package/src/bmad-plus/packs/pack-shield/references/soc2/policies.md +254 -254
  255. package/src/bmad-plus/packs/pack-shield/references/soc2/vendor.md +276 -276
  256. package/src/bmad-plus/packs/pack-shield/references/swift-csp/swift-assessment.md +202 -202
  257. package/src/bmad-plus/packs/pack-shield/references/swift-csp/swift-controls.md +545 -545
  258. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-crmp-requirements.md +359 -359
  259. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-directives-overview.md +187 -187
  260. package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-incident-reporting.md +187 -187
  261. package/src/bmad-plus/packs/pack-shield/references/wcag/criteria-detail.md +510 -510
  262. package/src/bmad-plus/packs/pack-shield/shared/audit-report-template.md +103 -103
  263. package/src/bmad-plus/packs/pack-shield/shared/cross-framework-mapper.md +103 -103
  264. package/src/bmad-plus/packs/pack-shield/shared/gap-analysis-template.md +83 -83
  265. package/src/bmad-plus/packs/pack-shield/shield-orchestrator.md +229 -229
  266. package/src/bmad-plus/packs/pack-shield/upstream-sync.yaml +68 -68
  267. package/src/bmad-plus/skills/bmad-plus-autopilot/SKILL.md +99 -99
  268. package/src/bmad-plus/skills/bmad-plus-parallel/SKILL.md +93 -93
  269. package/src/bmad-plus/skills/bmad-plus-sync/SKILL.md +69 -69
  270. package/tools/bmad-plus-npx.js +3 -5
  271. package/tools/cli/commands/autoconfig.js +508 -489
  272. package/tools/cli/commands/doctor.js +219 -222
  273. package/tools/cli/commands/install.js +548 -739
  274. package/tools/cli/commands/memory.js +194 -194
  275. package/tools/cli/commands/scan.js +362 -350
  276. package/tools/cli/commands/uninstall.js +96 -96
  277. package/tools/cli/commands/update.js +116 -174
  278. package/tools/cli/i18n.js +845 -763
  279. package/tools/cli/lib/memory-init.js +114 -0
  280. package/tools/cli/lib/pack-copy.js +84 -0
  281. package/tools/cli/lib/packs.js +114 -0
@@ -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*