bmad-plus 0.7.5 → 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.
- package/CHANGELOG.md +450 -425
- package/LICENSE +21 -21
- package/README.md +555 -447
- package/osint-agent-package/README.md +88 -88
- package/osint-agent-package/SETUP_KEYS.md +108 -108
- package/osint-agent-package/agents/osint-investigator.md +80 -80
- package/osint-agent-package/install.ps1 +87 -87
- package/osint-agent-package/install.sh +76 -76
- package/osint-agent-package/skills/bmad-osint-investigate/SKILL.md +147 -147
- package/osint-agent-package/skills/bmad-osint-investigate/osint/SKILL.md +452 -452
- package/osint-agent-package/skills/bmad-osint-investigate/osint/assets/dossier-template.md +116 -116
- package/osint-agent-package/skills/bmad-osint-investigate/osint/references/content-extraction.md +100 -100
- package/osint-agent-package/skills/bmad-osint-investigate/osint/references/enrichment-databases-fr.md +148 -148
- package/osint-agent-package/skills/bmad-osint-investigate/osint/references/platforms.md +130 -130
- package/osint-agent-package/skills/bmad-osint-investigate/osint/references/psychoprofile.md +69 -69
- package/osint-agent-package/skills/bmad-osint-investigate/osint/references/tools.md +281 -281
- package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/_http.py +101 -101
- package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/apify.py +266 -260
- package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/brightdata.py +101 -101
- package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/diagnose.py +141 -141
- package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/exa.py +79 -79
- package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/jina.py +71 -71
- package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/mcp-client.py +136 -136
- package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/parallel.py +85 -85
- package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/perplexity.py +102 -102
- package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/tavily.py +72 -72
- package/osint-agent-package/skills/bmad-osint-investigate/osint/scripts/volley.py +208 -208
- package/osint-agent-package/skills/bmad-osint-investigator/SKILL.md +15 -15
- package/package.json +62 -57
- package/readme-international/README.de.md +576 -426
- package/readme-international/README.es.md +578 -518
- package/readme-international/README.fr.md +576 -516
- package/src/bmad-plus/agents/agent-architect-dev/SKILL.md +96 -96
- package/src/bmad-plus/agents/agent-architect-dev/bmad-skill-manifest.yaml +13 -13
- package/src/bmad-plus/agents/agent-maker/SKILL.md +201 -201
- package/src/bmad-plus/agents/agent-maker/bmad-skill-manifest.yaml +13 -13
- package/src/bmad-plus/agents/agent-orchestrator/SKILL.md +137 -137
- package/src/bmad-plus/agents/agent-orchestrator/bmad-skill-manifest.yaml +13 -13
- package/src/bmad-plus/agents/agent-quality/SKILL.md +83 -83
- package/src/bmad-plus/agents/agent-quality/bmad-skill-manifest.yaml +13 -13
- package/src/bmad-plus/agents/agent-shadow/SKILL.md +71 -71
- package/src/bmad-plus/agents/agent-shadow/bmad-skill-manifest.yaml +13 -13
- package/src/bmad-plus/agents/agent-strategist/SKILL.md +80 -80
- package/src/bmad-plus/agents/agent-strategist/bmad-skill-manifest.yaml +13 -13
- package/src/bmad-plus/agents/pack-animated/animated-website-agent.md +325 -325
- package/src/bmad-plus/agents/pack-animated/templates/animated-website-workflow.md +55 -55
- package/src/bmad-plus/agents/pack-backup/backup-agent.md +71 -71
- package/src/bmad-plus/agents/pack-backup/templates/backup-workflow.md +51 -51
- package/src/bmad-plus/agents/pack-seo/SKILL.md +171 -171
- package/src/bmad-plus/agents/pack-seo/checklist.md +140 -140
- package/src/bmad-plus/agents/pack-seo/pagespeed-playbook.md +320 -320
- package/src/bmad-plus/agents/pack-seo/ref/audit-schema.json +187 -187
- package/src/bmad-plus/agents/pack-seo/ref/cwv-thresholds.md +87 -87
- package/src/bmad-plus/agents/pack-seo/ref/eeat-criteria.md +123 -123
- package/src/bmad-plus/agents/pack-seo/ref/geo-signals.md +167 -167
- package/src/bmad-plus/agents/pack-seo/ref/hreflang-rules.md +153 -153
- package/src/bmad-plus/agents/pack-seo/ref/quality-gates.md +133 -133
- package/src/bmad-plus/agents/pack-seo/ref/schema-catalog.md +91 -91
- package/src/bmad-plus/agents/pack-seo/ref/schema-templates.json +356 -356
- package/src/bmad-plus/agents/pack-seo/seo-chief.md +294 -294
- package/src/bmad-plus/agents/pack-seo/seo-judge.md +241 -241
- package/src/bmad-plus/agents/pack-seo/seo-scout.md +171 -171
- package/src/bmad-plus/agents/pack-seo/templates/seo-audit-workflow.md +241 -241
- package/src/bmad-plus/data/role-triggers.yaml +209 -209
- package/src/bmad-plus/module-help.csv +10 -10
- package/src/bmad-plus/module.yaml +283 -280
- package/src/bmad-plus/packs/pack-animated/animated-website-agent.md +325 -0
- package/src/bmad-plus/packs/pack-animated/templates/animated-website-workflow.md +55 -0
- package/src/bmad-plus/packs/pack-backup/backup-agent.md +71 -0
- package/src/bmad-plus/packs/pack-backup/templates/backup-workflow.md +51 -0
- package/src/bmad-plus/packs/pack-dev-studio/README.md +162 -162
- package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/analyst-agent.md +73 -73
- package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/document-project.md +61 -61
- package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/domain-research.md +95 -95
- package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/market-research.md +95 -95
- package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/prfaq.md +134 -134
- package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/product-brief.md +80 -80
- package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/tech-writer-agent.md +73 -73
- package/src/bmad-plus/packs/pack-dev-studio/categories/analysis/technical-research.md +95 -95
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/architect-agent.md +73 -73
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-architecture.md +73 -73
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/create-epics-stories.md +92 -92
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/generate-project-context.md +80 -80
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/implementation-readiness.md +90 -90
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01-init.md +153 -153
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-01b-continue.md +173 -173
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-02-context.md +224 -224
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-03-starter.md +329 -329
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-04-decisions.md +318 -318
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-05-patterns.md +359 -359
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-06-structure.md +379 -379
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-07-validation.md +361 -361
- package/src/bmad-plus/packs/pack-dev-studio/categories/architecture/steps/step-08-complete.md +81 -81
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/checkpoint-preview.md +67 -67
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-01-gather-context.md +85 -85
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-02-review.md +35 -35
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-03-triage.md +49 -49
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review-steps/step-04-present.md +131 -131
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/code-review.md +89 -89
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/correct-course.md +300 -300
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/create-story.md +428 -428
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-agent.md +73 -73
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story-checklist.md +80 -80
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/dev-story.md +484 -484
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/investigate.md +193 -193
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/qa-e2e-tests.md +175 -175
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/quick-dev.md +110 -110
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/retrospective.md +1511 -1511
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-planning.md +298 -298
- package/src/bmad-plus/packs/pack-dev-studio/categories/implementation/sprint-status.md +296 -296
- package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-prd.md +29 -29
- package/src/bmad-plus/packs/pack-dev-studio/categories/planning/create-ux-design.md +74 -74
- package/src/bmad-plus/packs/pack-dev-studio/categories/planning/edit-prd.md +29 -29
- package/src/bmad-plus/packs/pack-dev-studio/categories/planning/pm-agent.md +73 -73
- package/src/bmad-plus/packs/pack-dev-studio/categories/planning/prd.md +89 -89
- package/src/bmad-plus/packs/pack-dev-studio/categories/planning/ux-designer-agent.md +73 -73
- package/src/bmad-plus/packs/pack-dev-studio/categories/planning/validate-prd.md +29 -29
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/advanced-elicitation.md +141 -141
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/adversarial-review.md +37 -37
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/bmad-help.md +75 -75
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/brainstorming.md +6 -6
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/customize.md +110 -110
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/distillator.md +176 -176
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/edge-case-hunter.md +67 -67
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-prose.md +86 -86
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/editorial-review-structure.md +179 -179
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/index-docs.md +66 -66
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/party-mode.md +127 -127
- package/src/bmad-plus/packs/pack-dev-studio/categories/utilities/shard-doc.md +105 -105
- package/src/bmad-plus/packs/pack-dev-studio/dev-studio-orchestrator.md +120 -120
- package/src/bmad-plus/packs/pack-dev-studio/shared/architecture-decision-template.md +12 -12
- package/src/bmad-plus/packs/pack-dev-studio/shared/bwml-spec.md +328 -328
- package/src/bmad-plus/packs/pack-dev-studio/shared/module-help.csv +32 -32
- package/src/bmad-plus/packs/pack-dev-studio/upstream-sync.yaml +81 -81
- package/src/bmad-plus/packs/pack-memory/README.md +106 -106
- package/src/bmad-plus/packs/pack-memory/memory-orchestrator.md +79 -79
- package/src/bmad-plus/packs/pack-memory/shared/karpathy-guardrails.md +86 -86
- package/src/bmad-plus/packs/pack-memory/shared/memory-protocol.md +143 -143
- package/src/bmad-plus/packs/pack-memory/templates/context.md +39 -39
- package/src/bmad-plus/packs/pack-memory/templates/decisions.md +25 -25
- package/src/bmad-plus/packs/pack-memory/templates/identity.yaml +39 -39
- package/src/bmad-plus/packs/pack-memory/templates/lessons.md +31 -31
- package/src/bmad-plus/packs/pack-memory/templates/patterns.md +24 -24
- package/src/bmad-plus/packs/pack-memory/templates/session-handoff.md +25 -25
- package/src/bmad-plus/packs/pack-memory/zecher-agent.md +157 -157
- package/src/bmad-plus/packs/pack-seo/SKILL.md +171 -0
- package/src/bmad-plus/packs/pack-seo/checklist.md +140 -0
- package/src/bmad-plus/packs/pack-seo/pagespeed-playbook.md +320 -0
- package/src/bmad-plus/packs/pack-seo/ref/audit-schema.json +187 -0
- package/src/bmad-plus/packs/pack-seo/ref/cwv-thresholds.md +87 -0
- package/src/bmad-plus/packs/pack-seo/ref/eeat-criteria.md +123 -0
- package/src/bmad-plus/packs/pack-seo/ref/geo-signals.md +167 -0
- package/src/bmad-plus/packs/pack-seo/ref/hreflang-rules.md +153 -0
- package/src/bmad-plus/packs/pack-seo/ref/quality-gates.md +133 -0
- package/src/bmad-plus/packs/pack-seo/ref/schema-catalog.md +91 -0
- package/src/bmad-plus/packs/pack-seo/ref/schema-templates.json +356 -0
- package/src/bmad-plus/packs/pack-seo/seo-chief.md +294 -0
- package/src/bmad-plus/packs/pack-seo/seo-judge.md +241 -0
- package/src/bmad-plus/packs/pack-seo/seo-scout.md +171 -0
- package/src/bmad-plus/packs/pack-seo/templates/seo-audit-workflow.md +241 -0
- package/src/bmad-plus/packs/pack-shield/README.md +110 -110
- package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/csrd-agent.md +262 -262
- package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/section508-agent.md +179 -179
- package/src/bmad-plus/packs/pack-shield/categories/accessibility-esg/wcag-agent.md +201 -201
- package/src/bmad-plus/packs/pack-shield/categories/ai-governance/eu-ai-act-agent.md +97 -97
- package/src/bmad-plus/packs/pack-shield/categories/ai-governance/iso42001-agent.md +251 -251
- package/src/bmad-plus/packs/pack-shield/categories/ai-governance/nist-ai-rmf-agent.md +133 -133
- package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/cis-controls-agent.md +221 -221
- package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/ism-agent.md +150 -150
- package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/iso27001-agent.md +167 -167
- package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nis2-agent.md +83 -83
- package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-800-53-agent.md +250 -250
- package/src/bmad-plus/packs/pack-shield/categories/cybersecurity/nist-csf-agent.md +218 -218
- package/src/bmad-plus/packs/pack-shield/categories/data-privacy/ccpa-agent.md +94 -94
- package/src/bmad-plus/packs/pack-shield/categories/data-privacy/dpdpa-agent.md +136 -136
- package/src/bmad-plus/packs/pack-shield/categories/data-privacy/gdpr-agent.md +296 -296
- package/src/bmad-plus/packs/pack-shield/categories/data-privacy/iso27701-agent.md +134 -134
- package/src/bmad-plus/packs/pack-shield/categories/data-privacy/lgpd-agent.md +129 -129
- package/src/bmad-plus/packs/pack-shield/categories/defense-export/cmmc-agent.md +127 -127
- package/src/bmad-plus/packs/pack-shield/categories/defense-export/ear-agent.md +272 -272
- package/src/bmad-plus/packs/pack-shield/categories/defense-export/itar-agent.md +202 -202
- package/src/bmad-plus/packs/pack-shield/categories/defense-export/tsa-agent.md +367 -367
- package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/dora-agent.md +510 -510
- package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/fedramp-agent.md +247 -247
- package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/hipaa-agent.md +173 -173
- package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/pci-dss-agent.md +239 -239
- package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/soc2-agent.md +266 -266
- package/src/bmad-plus/packs/pack-shield/categories/industry-compliance/swift-csp-agent.md +164 -164
- package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-classifier.md +131 -131
- package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-fria.md +155 -155
- package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-incidents.md +187 -187
- package/src/bmad-plus/packs/pack-shield/categories/workflows/ai-act-roles.md +113 -113
- package/src/bmad-plus/packs/pack-shield/categories/workflows/breach-sentinel.md +197 -197
- package/src/bmad-plus/packs/pack-shield/categories/workflows/cookie-policy-gen.md +180 -180
- package/src/bmad-plus/packs/pack-shield/categories/workflows/dpia-sentinel.md +235 -235
- package/src/bmad-plus/packs/pack-shield/categories/workflows/legitimate-interest.md +159 -159
- package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-advisor.md +133 -133
- package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-notice-gen.md +160 -160
- package/src/bmad-plus/packs/pack-shield/categories/workflows/privacy-policy-gen.md +135 -135
- package/src/bmad-plus/packs/pack-shield/references/ccpa/ccpa-gdpr-comparison.md +117 -117
- package/src/bmad-plus/packs/pack-shield/references/ccpa/consumer-rights-workflows.md +177 -177
- package/src/bmad-plus/packs/pack-shield/references/cis-controls/framework-mappings.md +162 -162
- package/src/bmad-plus/packs/pack-shield/references/cis-controls/implementation-guidance.md +235 -235
- package/src/bmad-plus/packs/pack-shield/references/cis-controls/safeguards-detail.md +252 -252
- package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-assessment.md +170 -170
- package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-levels.md +113 -113
- package/src/bmad-plus/packs/pack-shield/references/cmmc/cmmc-practices.md +211 -211
- package/src/bmad-plus/packs/pack-shield/references/csrd/compliance-program.md +281 -281
- package/src/bmad-plus/packs/pack-shield/references/csrd/double-materiality.md +253 -253
- package/src/bmad-plus/packs/pack-shield/references/csrd/esrs-standards.md +401 -401
- package/src/bmad-plus/packs/pack-shield/references/dora/article-reference.md +441 -441
- package/src/bmad-plus/packs/pack-shield/references/dora/incident-classification.md +297 -297
- package/src/bmad-plus/packs/pack-shield/references/dora/rts-its-guide.md +306 -306
- package/src/bmad-plus/packs/pack-shield/references/dora/third-party-risk.md +349 -349
- package/src/bmad-plus/packs/pack-shield/references/dpdpa/gdpr-comparison.md +173 -173
- package/src/bmad-plus/packs/pack-shield/references/dpdpa/rights-and-obligations.md +426 -426
- package/src/bmad-plus/packs/pack-shield/references/dpdpa/rules-2025.md +599 -599
- package/src/bmad-plus/packs/pack-shield/references/dpdpa/sections-reference.md +319 -319
- package/src/bmad-plus/packs/pack-shield/references/ear/ccl-eccn-guide.md +250 -250
- package/src/bmad-plus/packs/pack-shield/references/ear/compliance-program.md +280 -280
- package/src/bmad-plus/packs/pack-shield/references/ear/license-exceptions.md +207 -207
- package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/gpai-governance.md +267 -267
- package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/obligations-high-risk.md +287 -287
- package/src/bmad-plus/packs/pack-shield/references/eu-ai-act/risk-classification.md +182 -182
- package/src/bmad-plus/packs/pack-shield/references/fedramp/appendices-guide.md +209 -209
- package/src/bmad-plus/packs/pack-shield/references/fedramp/control-families.md +281 -281
- package/src/bmad-plus/packs/pack-shield/references/fedramp/poam-guide.md +93 -93
- package/src/bmad-plus/packs/pack-shield/references/fedramp/readiness-checklist.md +134 -134
- package/src/bmad-plus/packs/pack-shield/references/fedramp/sap-sar-guide.md +86 -86
- package/src/bmad-plus/packs/pack-shield/references/fedramp/ssp-guide.md +129 -129
- package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/documents.md +192 -192
- package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/dpa-template.md +121 -121
- package/src/bmad-plus/packs/pack-shield/references/gdpr-compliance/privacy-notice.md +87 -87
- package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/breach-notification.md +293 -293
- package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/privacy-rule.md +276 -276
- package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/security-rule.md +299 -299
- package/src/bmad-plus/packs/pack-shield/references/hipaa-compliance/templates.md +568 -568
- package/src/bmad-plus/packs/pack-shield/references/ism/control-applicability.md +181 -181
- package/src/bmad-plus/packs/pack-shield/references/ism/guidelines-overview.md +183 -183
- package/src/bmad-plus/packs/pack-shield/references/iso27001/annex-a-2013.md +203 -203
- package/src/bmad-plus/packs/pack-shield/references/iso27001/annex-a-2022.md +132 -132
- package/src/bmad-plus/packs/pack-shield/references/iso27001/control-mapping.md +153 -153
- package/src/bmad-plus/packs/pack-shield/references/iso27701/annex-a-controls.md +195 -195
- package/src/bmad-plus/packs/pack-shield/references/iso27701/regulatory-mapping.md +229 -229
- package/src/bmad-plus/packs/pack-shield/references/iso27701/transition-guide.md +219 -219
- package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-ai-risk-assessment.md +258 -258
- package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-clauses-requirements.md +279 -279
- package/src/bmad-plus/packs/pack-shield/references/iso42001/iso42001-controls-annex-a.md +155 -155
- package/src/bmad-plus/packs/pack-shield/references/itar/compliance-program.md +174 -174
- package/src/bmad-plus/packs/pack-shield/references/itar/licensing-guide.md +146 -146
- package/src/bmad-plus/packs/pack-shield/references/itar/usml-categories.md +93 -93
- package/src/bmad-plus/packs/pack-shield/references/lgpd/anpd-enforcement.md +147 -147
- package/src/bmad-plus/packs/pack-shield/references/lgpd/compliance-program.md +272 -272
- package/src/bmad-plus/packs/pack-shield/references/lgpd/lgpd-articles.md +271 -271
- package/src/bmad-plus/packs/pack-shield/references/nis2/article-21-measures.md +153 -153
- package/src/bmad-plus/packs/pack-shield/references/nis2/iso27001-nis2-mapping.md +68 -68
- package/src/bmad-plus/packs/pack-shield/references/nist-800-53/assessment-rmf.md +349 -349
- package/src/bmad-plus/packs/pack-shield/references/nist-800-53/baselines-tailoring.md +277 -277
- package/src/bmad-plus/packs/pack-shield/references/nist-800-53/control-families.md +450 -450
- package/src/bmad-plus/packs/pack-shield/references/nist-ai-rmf/rmf-core.md +361 -361
- package/src/bmad-plus/packs/pack-shield/references/nist-ai-rmf/rmf-profiles.md +192 -192
- package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-10-to-20-mapping.md +143 -143
- package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-20-functions-categories.md +278 -278
- package/src/bmad-plus/packs/pack-shield/references/nist-csf/csf-implementation-tiers.md +135 -135
- package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-requirements.md +366 -366
- package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-saq-guide.md +217 -217
- package/src/bmad-plus/packs/pack-shield/references/pci-compliance/pci-dss-v4-changes.md +190 -190
- package/src/bmad-plus/packs/pack-shield/references/section-508/wcag-mapping.md +160 -160
- package/src/bmad-plus/packs/pack-shield/references/soc2/controls.md +241 -241
- package/src/bmad-plus/packs/pack-shield/references/soc2/evidence.md +236 -236
- package/src/bmad-plus/packs/pack-shield/references/soc2/policies.md +254 -254
- package/src/bmad-plus/packs/pack-shield/references/soc2/vendor.md +276 -276
- package/src/bmad-plus/packs/pack-shield/references/swift-csp/swift-assessment.md +202 -202
- package/src/bmad-plus/packs/pack-shield/references/swift-csp/swift-controls.md +545 -545
- package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-crmp-requirements.md +359 -359
- package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-directives-overview.md +187 -187
- package/src/bmad-plus/packs/pack-shield/references/tsa-compliance/tsa-incident-reporting.md +187 -187
- package/src/bmad-plus/packs/pack-shield/references/wcag/criteria-detail.md +510 -510
- package/src/bmad-plus/packs/pack-shield/shared/audit-report-template.md +103 -103
- package/src/bmad-plus/packs/pack-shield/shared/cross-framework-mapper.md +103 -103
- package/src/bmad-plus/packs/pack-shield/shared/gap-analysis-template.md +83 -83
- package/src/bmad-plus/packs/pack-shield/shield-orchestrator.md +229 -229
- package/src/bmad-plus/packs/pack-shield/upstream-sync.yaml +68 -68
- package/src/bmad-plus/skills/bmad-plus-autopilot/SKILL.md +99 -99
- package/src/bmad-plus/skills/bmad-plus-parallel/SKILL.md +93 -93
- package/src/bmad-plus/skills/bmad-plus-sync/SKILL.md +69 -69
- package/tools/cli/commands/autoconfig.js +498 -489
- package/tools/cli/commands/doctor.js +222 -222
- package/tools/cli/commands/install.js +739 -739
- package/tools/cli/commands/memory.js +194 -194
- package/tools/cli/commands/scan.js +360 -350
- package/tools/cli/commands/uninstall.js +96 -96
- package/tools/cli/commands/update.js +174 -174
- 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*
|