A unified, self-verifying perfection engine that fuses 11 build-time Quality Gates with a 35-pillar post-build Audit Matrix. Every Bud Authority site is engineered, audited, remediated, and re-audited until it ships at ELITE_95+ grade — or it doesn't ship.
The Web Brain enforces quality during the build. The Apex Auditor verifies, perfects, and re-audits after the build. Nothing ships that hasn't passed both — they function as one integrated protocol, not two systems.
Enforced automatically during every build. Eleven checkpoints that run after each page batch, each deployment, each code change. Failures are fixed silently before progress continues. Prevention beats remediation.
Runs page-by-page after the build is structurally complete. Audits every conceivable dimension, grades by severity, fixes systematically, then re-audits to verify. Loops until every page scores ELITE.
Every audit session flows through a deterministic sequence. State is persisted in audit-session.json so each phase reads what the last one found. The loop exits only when perfection criteria clear.
Site URL & mode confirmed. SearchAtlas MCP pulls domain metrics, backlinks, rankings, crawl issues. Complete page inventory from sitemap + nav + filesystem. Every page classified by type. Orphans & ghost pages flagged. Competitor baseline captured.
Money pages first, then hubs, geo, spokes, blog. All 35 pillars run on every page. Per-page records written. Cross-site analysis: cannibalization, DNA collisions, link equity flow, topic gaps, duplicate detection, template-level patterns.
CRITICAL → HIGH → MEDIUM → LOW → COSMETIC. Template fixes before single-page fixes. Technical before content. Every fix triggers a regression check against adjacent pillars. Before/after state logged.
Re-run all 35 pillars on every fixed page. Re-run cross-site analysis. Compare scores to Phase 1 baseline. Identify remaining issues, regressions, and fixes that didn't actually resolve. Update session state.
Check exit criteria. Any failure returns to Phase 2 with a fresh approach for stubborn issues. Maximum 5 iterations (safety valve). Score progression tracked per iteration. No fix fails twice the same way.
One last clean audit. Final Certification Report: before/after scores per page & pillar, total issues found, total fixes applied, competitive position, AI search readiness. Full audit trail archived.
Every gate runs automatically after batched work. Failures are caught and repaired before the next step begins. The gates are the reason no Bud Authority site launches broken.
npx next build completes with zero errors after every batch. Non-negotiable compile gate before any deploy.
Every href cross-checked against routes. Zero broken links. Zero dead anchors. Zero 404 surprises post-deploy.
Grids start cols-1. 44px+ touch targets. Zero overflow at 320px. clamp() on all headings.
Phone, address, hours consistent everywhere. 21+ language. License on every page. Compliance disclaimers. Delivery copy matches reality.
Every page: BreadcrumbList + page-specific. Root: Organization, LocalBusiness, WebSite. High-value: Speakable, QAPage, HowTo, ItemList, DefinedTerm.
Zero duplicate hero imagery across pages. Descriptive alt text on every non-decorative image. WebP. Explicit dimensions. Lazy below fold.
Client JS < 90KB first load. All content pages SSG. Lazy images below fold. LCP < 1.8s mobile. Lighthouse 95+.
Entity-first sentences open every page. Answer content in initial HTML (no JS-gated content). Structured Q&A visible, never hidden in accordions.
Every page links to 3+ related pages. Zero orphan pages. Hubs link to all spokes; spokes link back to hub + adjacent spokes. Programmatic, never manual.
FAQ content structured for featured snippets. Tables and lists formatted for position zero. Key facts in extractable blocks. Direct answers above fold.
Archetype documented. 3-layer token system present. Zero raw hex in component files. Tailwind extends CSS vars. Dark tokens defined. Font pairing matches archetype. UX priorities 1-5 pass. SVG only, no emojis.
Each page runs the full pillar matrix in a deterministic sequence. Each pillar produces a 0-100 score. Weighted averages produce the page grade. The site grade is the average of all pages. Weights rebalance emphasis per cannabis dispensary context.
Zero tolerance for typos. Every word. Cannabis terminology validated. Proper nouns verified against authoritative sources.
Consistent quote styles. Proper apostrophes. Zero em dashes (absolute BA rule). No double spaces. Whitespace anomalies caught.
Word count per page type. Information density. Topic completeness. No thin content. Content DNA uniqueness — no two pages share >2/8 components.
Experience proof points counted per page (floor: 13 total). Experience signals in first 30%. Expertise, Authoritativeness, Trustworthiness present.
Temporal markers present and current. No stale dates. Data references verified. Seasonal relevance. Content decay flags.
State-specific rules enforced. Required disclaimers present. Prohibited health claims absent. Age-gate compliance. Zero GBP posting references.
Primary keyword front-loaded within 40 chars. Length 50-80. No duplicates site-wide. No em dashes. Entity density 10-15. Benchmarked vs SERP top 5.
150-160 chars. Primary keyword included. Compelling CTA. Unique per page. CTR-optimized phrasing.
Exactly one H1. Logical H2-H6 nesting. No level skips. H2s as conversational questions. AEO 40-60 word answer paragraph under each H2.
Primary keyword in first 100 words. Density 1-2%. LSI/semantic variants. 15+ unique entities per page, 5+ in first 200 words. Cannabis synonym rotation.
Alt text on every image. Descriptive filenames. Width/height set. WebP/AVIF. Lazy (except LCP). Compressed. Responsive srcset.
Clean, keyword-rich, 3-5 words. Lowercase. Hyphens. No stop words. No parameters. Logical hierarchy matching site architecture.
Self-referencing on every page. HTTPS. No conflicts. No 404 canonicals.
robots.txt correct. Sitemap.xml valid. No important pages blocked. No accidental noindex. Crawl budget managed.
Per-page schema matching type. Valid syntax. Cannabis-specific schema. Organization on homepage. Breadcrumb on all pages. FAQ & Product where applicable.
og:title, og:description, og:image (1200x630+), og:url, og:type, og:site_name. Present and unique per page.
summary_large_image card. twitter:title, twitter:description, twitter:image all present and tuned per page.
Hub-spoke model verified. Zero orphans. Minimum 3 internal links per page. Optimized anchor text. Link equity flowing to money pages.
All links resolve. New tab opening. Correct rel attributes. Authority sources linked. No competitor links. No penalized domains.
Zero broken links. Redirect chains max 2 hops. Custom 404 exists. No soft 404s. No redirect loops.
HTTPS everywhere. No mixed content. HSTS, X-Content-Type-Options, X-Frame-Options, CSP, Referrer-Policy all present.
XML sitemap valid and matches live pages. HTML sitemap for users. Proper lastmod dates. No stale URLs.
Tested at 375, 768, 1024, 1440. Zero horizontal scroll. 48x48px touch targets. Readable without zoom. Mobile menu functional. Forms usable.
LCP < 2.5s. INP < 200ms. CLS < 0.1. LCP element identified and optimized. JS execution analyzed. Layout shift sources eliminated.
Smooth throughout. No layout jumps. No sticky collisions. Lazy-load doesn't cause jumps. Parallax smooth. Back-to-top works. 60fps target.
Visual hierarchy clear. Whitespace appropriate. Palette cohesive. Typography readable. CTAs prominent. Above-fold compelling. Consistent components.
Body 16px minimum. Line height 1.5-1.8. Contrast 4.5:1+ (WCAG AA). No text on busy backgrounds. Paragraphs max 4-5 sentences. 45-75 chars per line.
Nav links functional. Footer complete. Contact info present. Legal pages linked. Social links working. Consistent across pages.
40-60 word answer paragraph under every H2. FAQ schema where applicable. Direct-answer formatting. PAA coverage. Zero-click optimization.
3-5 citation blocks per page (134-167 words). Data-rich statistics. Authoritative sourcing. Entity-rich passages. LLM-preferred depth.
Conversational H2s matching spoken queries. Near-me optimization on local pages. Featured snippet targeting. Speakable schema property.
Brand Radar MCP verification of AI appearance. Citation signals present. Entity alignment with Knowledge Graph. Definition-lead paragraphs.
Max 7 primary nav items. Breadcrumbs on all pages. 3-click rule enforced. Search functional. Active states visible. Mobile nav mirrors desktop.
GSC CTR data reviewed per page. Below-average CTR flagged. Title/description rewrite recommendations. Rich result eligibility maximized.
Branding, CTA styling, heading treatment, image treatment, spacing, responsive behavior all consistent across every page.
After every page is individually audited, a second analytical sweep runs against the site as a whole. This is where cannibalization, duplication, link-equity leaks, and topic gaps get surfaced.
For every keyword, identify which page SHOULD rank (highest intent match + most authority). Flag all others as cannibals needing differentiation or consolidation.
8-component DNA fingerprint for every page. Any pair sharing >2 components flagged with specific differentiation instructions. Prevents accidental duplicates.
Full link graph mapped. Approximate PageRank calculated. Money pages without enough inbound links flagged. Orphans identified. Equity-trapped pages surfaced.
For each hub, verify all spokes exist, are internally linked, and cover full topic scope. Identify gaps where competitors have coverage and this site doesn't.
Keywords competitors rank for but this site doesn't. Content types they have that we lack. Authority gaps. AI visibility gaps. Gaps become the next content roadmap.
Same issue on 10+ pages is a template bug, not a page bug. Fixed once at the source. One edit repairs every instance. Mass-fix leverage.
Issues sort into five severity tiers and drive the fix order. Pages grade on a five-band scale. ELITE_95+ is the only band that ships.
Blocks launch. Search failure. User can't complete a task. Fixed first, always.
Material ranking, UX, or conversion loss. Fixed before any optimization work begins.
Fix before campaign optimization. Moves the needle, doesn't stop the launch.
Incremental gain. Batch-fixed during polish passes.
No functional impact. Reduces polish. Caught anyway because standards.
The loop is the self-verifying core of the protocol. Every iteration reads the previous iteration's state. Fixes that don't resolve get flagged. Regressions get reverted and retried. The loop exits only when five strict criteria clear simultaneously.
The loop cannot end until every criterion below is true. Any single failure sends it back to Phase 2 with a fresh approach for that issue class.
A change to one element almost always touches adjacent pillars. When any fix is applied, the protocol automatically re-checks every pillar that could have been affected. If a regression is detected the fix is reverted and an alternative is attempted.
The audit doesn't rely on static inspection alone. Live domain intelligence streams from the SearchAtlas MCP at two stages — site-wide before auditing begins, and per-page during individual inspections. Every score references real-world data.
Apex QA is the final gate in the Bud Authority production pipeline. Content is produced, technical tags are optimized, then everything passes through Apex to be verified and perfected. Nothing reaches production unverified.
Produces content: geo pages, hubs, spokes, learn articles, FAQs.
Optimizes technical tags: titles, metas, schema, entity alignment.
Audits, remediates, re-audits. Certifies the site at ELITE grade before launch.
The Apex Quality Assurance Protocol is why every Bud Authority dispensary site outperforms its local WordPress competition on every measurable axis — Core Web Vitals, schema coverage, AI citation rate, organic visibility, conversion surface. Not by accident. By engineering.