# Master Production & Site-Build Quality System (2026 Edition)

> Context-aware, zero-defect production engineering blueprint for modern websites, programmatic SEO platforms, and high-ticket local lead generation funnels. Built for human developers and AI coding agents.

## Core Directives & Standards
- Full Specification JSON: https://site-build-checklist.pages.dev/checklist.json
- Web Application: https://site-build-checklist.pages.dev/

---

## 🔀 Decision Engine 1: Form vs. Survey Selection Matrix
Never blindly deploy a multi-step survey or a static form without evaluating project archetype:

1. **High-Ticket Lead Gen & Custom Quotes (ADU, Remodel, Demolition, Commercial Cleaning):**
   - *Choice:* 4-Step Interactive Card Survey (Scope -> Condition -> Urgency -> Contact).
   - *Why:* High-ticket buyers require qualification; multi-step cards reduce cognitive fatigue and filter low-intent inquiries. Auto-advance (300ms) on slides 1-3.
2. **Emergency & Urgent Dispatch (Tree on House/Car, Water Leaks, Locksmith, Towing):**
   - *Choice:* One-Tap Phone Dialer + Ultra-Short 1-2 Field Emergency Form (Phone + Address/Problem).
   - *Why:* Customers are in acute distress. Surveys cause immediate bounce. Never ask for email in emergency flows (pure friction).
3. **B2B, Agency Consultations & SaaS Demos:**
   - *Choice:* 2-3 Field Work Email Form OR Direct Calendly Embed.
   - *Why:* B2B buyers prefer direct scheduling. Collect Name, Work Email, Company Name, and route to calendar booking.
4. **Local SMB / Brick-and-Mortar Inquiries:**
   - *Choice:* Clean 3-Field Contact Form (Name, Phone/Email, Message).
   - *Why:* Routine questions (hours, pricing) expect standard forms; complex surveys feel unnatural.
5. **Lead Magnet & Gated Content (PDF Guides, Calculators):**
   - *Choice:* 1-Field Single Input (Email Only).
   - *Why:* Value-to-effort balance. Asking 5 questions for a PDF drops conversion by 70%.

---

## 🛠️ Decision Engine 2: Tech Stack Selection Matrix
Choose the tech stack based on scale, update velocity, and client needs:

1. **Astro SSG + Cloudflare Pages (Recommended for 100+ Multi-Location Platforms):**
   - *Best For:* Programmatic Local SEO (100–5,000+ pages), multi-city networks, high-traffic lead gen.
   - *Benefits:* 0kb runtime JS by default, sub-50ms TTFB worldwide, zero server crashes, 5,000 pages build in <90s.
2. **Next.js App Router (SSR/ISR) + Vercel / Cloudflare:**
   - *Best For:* Dynamic web apps, user authentication, customer portals, interactive calculators, Headless WordPress.
   - *Watch-Outs:* Next.js 2MB incremental cache limit; prevent edge worker sitemap timeouts via static pre-generation.
3. **Vite + React Router / SPA:**
   - *Best For:* Client-side tools, dashboards, fast interactive MVPs.
   - *Watch-Outs:* Requires SSR or prerender plugins if search engine ranking is required.
4. **Clean Static HTML / Tailwind / Alpine.js:**
   - *Best For:* 1-3 page micro-sites, emergency squeeze funnels, portfolio landing pages.
   - *Benefits:* Zero dependencies, deploys in 2 seconds, 100/100 Lighthouse out of the box.
5. **WordPress / Webflow / Shopify:**
   - *Best For:* Non-technical client teams requiring daily drag-and-drop page editing or ecommerce cart management.

---

## 📋 Universal Non-Negotiable Directives (All Archetypes)
- Core Web Vitals 2026: LCP <= 2.5s (preloaded WebP/AVIF), INP <= 200ms (zero blocking JS), CLS <= 0.1.
- Cloudflare Security Headers: HSTS preload, X-Content-Type-Options: nosniff, X-Frame-Options: SAMEORIGIN, CSP frame-src whitelisting.
- Email Obfuscation Guard: Wrap all mailto: links in <!--email_off--> to avoid Cloudflare JS decoder 404 crawl bugs.
- Schema.org Strict Syntax: Zero aggregateRating on LocalBusiness (fixes <parent_node> errors); explicit @type on all graph references; hasMap entity grounding.
- Mobile Sticky Dual-Action Bar: Persistent Click-to-Call + Jump to Form/Survey with iOS env(safe-area-inset-bottom) support.
- Anti-Doorway Threshold: Pairwise 3-gram Jaccard shingle similarity strictly < 50% across municipal location pages.