budauthority.com
apex_qa_protocol.sh // bud_authority // v5.0.2
[ SCANNING · ALL SYSTEMS NOMINAL ]
MODULE_APEX :: QUALITY ASSURANCE PROTOCOL :: ACTIVE

APEX QUALITY ASSURANCE/PROTOCOL

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.

11
Quality Gates
35
Audit Pillars
6
Exec Phases
5
Max Iterations
95+
Elite Floor
0
Issues @ Ship
Powered by Bud Authority
// Quality Engineered By
Bud Authority Operating Standard
Section 01 / Protocol Overview

Two disciplines.
One unbroken chain of quality.

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.

LAYER_SYSTEM :: Preventive / Corrective Fusion OPERATIONAL
[ LAYER_01 · PREVENTIVE ]

Web Brain v5.0 Quality Gates

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.

  • Build integrity & link graph validation
  • Mobile-first responsive discipline
  • Content, schema, and compliance checks
  • Performance budget enforcement
  • AI readability & zero-click structuring
  • Internal linking architecture audit
  • Design Intelligence — tokens, archetype, UX
[+]
[ LAYER_02 · CORRECTIVE ]

Apex QA Auditor v2 35-Pillar Matrix

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.

  • Content, copy & E-E-A-T verification [ P01-P06 ]
  • SEO optimization surface [ P07-P14 ]
  • Technical SEO & schema [ P15-P22 ]
  • UX & Core Web Vitals [ P23-P28 ]
  • AI Search Readiness — AEO/GEO/Voice [ P29-P32 ]
  • Site architecture & consistency [ P33-P35 ]
  • Cross-site intelligence & cannibalization
Section 02 / Execution Sequence

Six phases.
One self-verifying loop.

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.

PHASE_PIPELINE :: Recon → Discovery → Remediation → Verify → Loop → Certify DEPLOYED
0
PHASE_00 // RECON

Map The Terrain

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.

1
PHASE_01 // DISCOVERY

Audit Everything

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.

2
PHASE_02 // REMEDIATE

Fix In Priority Order

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.

3
PHASE_03 // VERIFY

Prove The Fixes

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.

4
PHASE_04 // LOOP

Iterate To Elite

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.

LOOPS 2 → 3 → 4
5
PHASE_05 // CERTIFY

Ship The Evidence

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.

Section 03 / Layer 01 — Quality Gates

The eleven build-time checkpoints.

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.

MODULE_GATES :: Web Brain v5.0 Build-Time Enforcement ACTIVE
GATE_01ACTIVE

Build Integrity

npx next build completes with zero errors after every batch. Non-negotiable compile gate before any deploy.

GATE_02ACTIVE

Link Graph

Every href cross-checked against routes. Zero broken links. Zero dead anchors. Zero 404 surprises post-deploy.

GATE_03ACTIVE

Mobile Discipline

Grids start cols-1. 44px+ touch targets. Zero overflow at 320px. clamp() on all headings.

GATE_04ACTIVE

Content Coherence

Phone, address, hours consistent everywhere. 21+ language. License on every page. Compliance disclaimers. Delivery copy matches reality.

GATE_05ACTIVE

Schema Coverage

Every page: BreadcrumbList + page-specific. Root: Organization, LocalBusiness, WebSite. High-value: Speakable, QAPage, HowTo, ItemList, DefinedTerm.

GATE_06ACTIVE

Image Integrity

Zero duplicate hero imagery across pages. Descriptive alt text on every non-decorative image. WebP. Explicit dimensions. Lazy below fold.

GATE_07ACTIVE

Performance Budget

Client JS < 90KB first load. All content pages SSG. Lazy images below fold. LCP < 1.8s mobile. Lighthouse 95+.

GATE_08ACTIVE

AI Readability

Entity-first sentences open every page. Answer content in initial HTML (no JS-gated content). Structured Q&A visible, never hidden in accordions.

GATE_09ACTIVE

Internal Linking

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.

GATE_10ACTIVE

Zero-Click Surface

FAQ content structured for featured snippets. Tables and lists formatted for position zero. Key facts in extractable blocks. Direct answers above fold.

GATE_11ACTIVE

Design Intelligence

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.

Section 04 / Layer 02 — Audit Matrix

Thirty-five pillars.
No blind spots.

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.

MODULE_MATRIX :: 35-Pillar Page-by-Page Audit SCANNING
01–06
// Category I

Content & Copy

The words, their quality, their compliance.
WEIGHT 20%
01
Spelling & Grammar

Zero tolerance for typos. Every word. Cannabis terminology validated. Proper nouns verified against authoritative sources.

02
Punctuation & Formatting

Consistent quote styles. Proper apostrophes. Zero em dashes (absolute BA rule). No double spaces. Whitespace anomalies caught.

03
Content Quality & Depth

Word count per page type. Information density. Topic completeness. No thin content. Content DNA uniqueness — no two pages share >2/8 components.

04
E-E-A-T Signal Verification

Experience proof points counted per page (floor: 13 total). Experience signals in first 30%. Expertise, Authoritativeness, Trustworthiness present.

05
Content Freshness

Temporal markers present and current. No stale dates. Data references verified. Seasonal relevance. Content decay flags.

06
Cannabis Compliance

State-specific rules enforced. Required disclaimers present. Prohibited health claims absent. Age-gate compliance. Zero GBP posting references.

07–14
// Category II

SEO Optimization

The surface Google sees first.
WEIGHT 25%
07
Title Tags

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.

08
Meta Descriptions

150-160 chars. Primary keyword included. Compelling CTA. Unique per page. CTR-optimized phrasing.

09
Heading Hierarchy

Exactly one H1. Logical H2-H6 nesting. No level skips. H2s as conversational questions. AEO 40-60 word answer paragraph under each H2.

10
On-Page Keyword Optimization

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.

11
Image SEO

Alt text on every image. Descriptive filenames. Width/height set. WebP/AVIF. Lazy (except LCP). Compressed. Responsive srcset.

12
URL Structure & Slugs

Clean, keyword-rich, 3-5 words. Lowercase. Hyphens. No stop words. No parameters. Logical hierarchy matching site architecture.

13
Canonical Tags

Self-referencing on every page. HTTPS. No conflicts. No 404 canonicals.

14
Robots & Indexing

robots.txt correct. Sitemap.xml valid. No important pages blocked. No accidental noindex. Crawl budget managed.

15–22
// Category III

Technical SEO

The infrastructure beneath the words.
WEIGHT 20%
15
Schema Markup — JSON-LD

Per-page schema matching type. Valid syntax. Cannabis-specific schema. Organization on homepage. Breadcrumb on all pages. FAQ & Product where applicable.

16
Open Graph Tags

og:title, og:description, og:image (1200x630+), og:url, og:type, og:site_name. Present and unique per page.

17
Twitter Cards

summary_large_image card. twitter:title, twitter:description, twitter:image all present and tuned per page.

18
Internal Link Architecture

Hub-spoke model verified. Zero orphans. Minimum 3 internal links per page. Optimized anchor text. Link equity flowing to money pages.

19
External Link Validation

All links resolve. New tab opening. Correct rel attributes. Authority sources linked. No competitor links. No penalized domains.

20
404 & Broken Link Detection

Zero broken links. Redirect chains max 2 hops. Custom 404 exists. No soft 404s. No redirect loops.

21
Security & Headers

HTTPS everywhere. No mixed content. HSTS, X-Content-Type-Options, X-Frame-Options, CSP, Referrer-Policy all present.

22
Sitemap & Crawlability

XML sitemap valid and matches live pages. HTML sitemap for users. Proper lastmod dates. No stale URLs.

23–28
// Category IV

UX & Performance

What real users actually feel.
WEIGHT 15%
23
Mobile Responsiveness

Tested at 375, 768, 1024, 1440. Zero horizontal scroll. 48x48px touch targets. Readable without zoom. Mobile menu functional. Forms usable.

24
Core Web Vitals

LCP < 2.5s. INP < 200ms. CLS < 0.1. LCP element identified and optimized. JS execution analyzed. Layout shift sources eliminated.

25
Scroll Behavior & Jank

Smooth throughout. No layout jumps. No sticky collisions. Lazy-load doesn't cause jumps. Parallax smooth. Back-to-top works. 60fps target.

26
Design & Layout Critique

Visual hierarchy clear. Whitespace appropriate. Palette cohesive. Typography readable. CTAs prominent. Above-fold compelling. Consistent components.

27
Text Readability & Visibility

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.

28
Header & Footer Optimization

Nav links functional. Footer complete. Contact info present. Legal pages linked. Social links working. Consistent across pages.

29–32
// Category V

AI Search Readiness

How LLMs find, cite, and quote this site.
WEIGHT 12%
29
AEO — Answer Engine

40-60 word answer paragraph under every H2. FAQ schema where applicable. Direct-answer formatting. PAA coverage. Zero-click optimization.

30
GEO — Generative Engine

3-5 citation blocks per page (134-167 words). Data-rich statistics. Authoritative sourcing. Entity-rich passages. LLM-preferred depth.

31
Voice Search Optimization

Conversational H2s matching spoken queries. Near-me optimization on local pages. Featured snippet targeting. Speakable schema property.

32
AI Visibility & Citations

Brand Radar MCP verification of AI appearance. Citation signals present. Entity alignment with Knowledge Graph. Definition-lead paragraphs.

33–35
// Category VI

Site Architecture

The bones holding everything together.
WEIGHT 8%
33
Navigation Architecture

Max 7 primary nav items. Breadcrumbs on all pages. 3-click rule enforced. Search functional. Active states visible. Mobile nav mirrors desktop.

34
CTR Verification

GSC CTR data reviewed per page. Below-average CTR flagged. Title/description rewrite recommendations. Rich result eligibility maximized.

35
Site-Wide Consistency

Branding, CTA styling, heading treatment, image treatment, spacing, responsive behavior all consistent across every page.

Section 05 / Cross-Site Intelligence

Problems between pages,
not just within them.

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.

MODULE_XSITE :: Site-Wide Pattern Detection OPERATIONAL
XSITE_01ACTIVE

Keyword Cannibalization

For every keyword, identify which page SHOULD rank (highest intent match + most authority). Flag all others as cannibals needing differentiation or consolidation.

XSITE_02ACTIVE

Content DNA Collisions

8-component DNA fingerprint for every page. Any pair sharing >2 components flagged with specific differentiation instructions. Prevents accidental duplicates.

XSITE_03ACTIVE

Link Equity Flow

Full link graph mapped. Approximate PageRank calculated. Money pages without enough inbound links flagged. Orphans identified. Equity-trapped pages surfaced.

XSITE_04ACTIVE

Topic Cluster Completeness

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.

XSITE_05ACTIVE

Competitor Gap Analysis

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.

XSITE_06ACTIVE

Template Pattern Detection

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.

Section 06 / Severity & Grading

Every finding classified.
Every page graded.

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.

MODULE_SEVERITY :: 5-Tier Issue Classification ENGAGED
Critical
Ship-Blocker

Blocks launch. Search failure. User can't complete a task. Fixed first, always.

High
Significant Impact

Material ranking, UX, or conversion loss. Fixed before any optimization work begins.

Medium
Noticeable Impact

Fix before campaign optimization. Moves the needle, doesn't stop the launch.

Low
Minor Opportunity

Incremental gain. Batch-fixed during polish passes.

Cosmetic
Polish

No functional impact. Reduces polish. Caught anyway because standards.

MODULE_GRADES :: 5-Band Page Scoring — Only ELITE Ships ENFORCED
[ < 50 ]
Critical
Rebuild territory
[ 50 – 69 ]
Needs Work
Major remediation
[ 70 – 84 ]
Good
Substantial lifts required
[ 85 – 94 ]
Excellent
One iteration from elite
[ 95 – 100 ]
Elite
Ship-ready
Section 07 / Perfection Loop

Audit → Fix → Re-Audit.
Repeat until flawless.

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.

MODULE_LOOP :: Self-Verifying Perfection Engine LOOPING
LOOP // ITERATE MAX 05 PHASE_01 AUDIT PHASE_02 FIX PHASE_03 VERIFY PHASE_04 LOOP

Exit criteria — all must clear.

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.

Every page scores 95+ overall.No exceptions. Site-wide average is a byproduct, not a target.
Zero CRITICAL issues on any page.Hard floor.
Zero HIGH issues on any page.Hard floor.
No single pillar below 85 on any page.Prevents a strong average hiding a weak dimension.
Zero regressions from fixes.Every fix improves without breaking anything adjacent.
!
Safety valve — max 5 iterations.If still failing, exit with a detailed remaining-issues report for manual review.
Section 08 / Regression Detection Framework

Every fix triggers ripple checks.

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.

MODULE_REGRESSION :: Automatic Ripple Detection MONITORING
// Fix Type // Automatic Ripple Checks Triggered
text_content_changed
Re-check spelling, keyword density, entity count, word count, compliance, E-E-A-T proof-point count.
heading_changed
Re-validate hierarchy, H1 uniqueness, keyword distribution, AEO answer paragraphs under each H2.
link_added_removed
Re-check internal link count, orphan status, anchor text, external link validation.
schema_changed
Re-validate JSON-LD, required properties, page type alignment, Rich Results eligibility.
image_changed
Re-check alt text, dimensions, format, lazy loading behavior, LCP element identity.
css_layout_changed
Re-test mobile responsiveness at all breakpoints, contrast ratios, font sizes, scroll behavior, CLS.
url_changed
Verify 301 redirect in place, canonical updated, sitemap updated, all internal links pointing to new URL.
meta_tags_changed
Re-check title length, description length, OG tags, Twitter Cards, canonical self-reference.
Section 09 / Live Data Integration

SearchAtlas MCP — real data, not guesses.

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.

MODULE_MCP :: SearchAtlas Live Telemetry STREAMING
[ PRE-AUDIT // SITE-WIDE ]

Domain Intelligence

Domain health & authoritysite-explorer-metrics
Backlink profilesite-explorer-backlinks-stats
Broken backlinkssite-explorer-broken-backlinks
Internal link distributionpages-by-internal-links
Rankings & GSC keywordsgsc-keywords
Site audit crawl issuessite-audit-issues
AI visibility & citationsbrand-radar-ai-responses
Competitor landscapeorganic-competitors
[ PER-PAGE // URL-SCOPED ]

Page-Level Intelligence

Keyword rankings for URLgsc-keywords (filtered)
CTR vs position peersgsc-ctr-by-position
Page-level backlinkssite-explorer-all-backlinks
Organic traffic valuepages-by-traffic
AI mentions of pagebrand-radar-ai-responses
SERP overview & intentserp-overview
Organic keywords historykeywords-history
Crawl data per pagesite-audit-page-explorer
Section 10 / Pipeline Position

The last station before live traffic.

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.

[ STAGE_01 // UPSTREAM ]

SEO Content Machine

Produces content: geo pages, hubs, spokes, learn articles, FAQs.

[ STAGE_02 // MIDSTREAM ]

SEO Automation v3

Optimizes technical tags: titles, metas, schema, entity alignment.

[ STAGE_03 // APEX ]

Apex Quality Assurance

Audits, remediates, re-audits. Certifies the site at ELITE grade before launch.

Section 11 / The Deliverable

Sites that are structurally untouchable in their market.

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.

< 1.8s
LCP Mobile Target
95+
Lighthouse Mobile
0
Issues At Ship