Knowledge · Guidelines · architecture
Web Performance
Operational Core Web Vitals rules — image delivery, CSS/JS critical path, composited animation, DOM budget, caching. Operationalises the CWV NFR (nfr-platform-matrix) into enforceable, reusable pass/fail rules for every web product.
Metadata
architecture
Description
Concrete, machine-checkable performance rules that turn the Core Web Vitals NFR
(nfr-platform-matrix: "Core Web Vitals are mandatory") into actionable governance.
Derived from a real Lighthouse audit (shredbx.com homepage, 2026-07-01) and written
to apply to EVERY web product in the workspace — shredbx now, BR and all future
configurations on adoption. Fixing the generator/component once fixes every consumer.
Complements (does NOT duplicate):
- nfr-platform-matrix.yml — declares CWV as a mandatory NFR (the WHAT)
- typography-visual-quality-audit.yml — TYPA-012 font loading, CLRA-* contrast (own those)
- web-crawlability.yml — robots/sitemap/llms.txt (SEO delivery)
- seo-specialist.yml (role) — strategic SEO; this guideline is the operational checklist
- component-animation-taxonomy.yml — animation TECHNIQUES; PERF-ANIM here is the COST budget
Audit with: Lighthouse / PageSpeed Insights (mobile AND desktop), Chrome DevTools
Performance panel, WebPageTest. Run on the deployed URL, not localhost.