@growthub/cli 0.3.50 → 0.3.53

package/assets/worker-kits/growthub-geo-seo-v1/templates/geo-score-summary.md

@@ -0,0 +1,113 @@
+# GEO Score Summary
+
+> Template: `templates/geo-score-summary.md`
+> Save output to: `output/<client-slug>/<project-slug>/GeoScoreSummary_v<N>_<YYYYMMDD>.md`
+
+---
+
+## URL Audited
+
+| Field | Value |
+|---|---|
+| Target URL | <!-- https://... --> |
+| Client | <!-- client_name --> |
+| Audit Date | <!-- YYYY-MM-DD --> |
+| Execution Mode | <!-- local-fork / agent-only --> |
+| Audit Scope | <!-- full / quick / specific --> |
+
+---
+
+## Overall GEO Score
+
+```
+╔══════════════════════════════╗
+║   GEO SCORE: ── / 100        ║
+║   GRADE: ─                   ║
+╚══════════════════════════════╝
+```
+
+| Field | Value |
+|---|---|
+| Composite Score | <!-- N / 100 --> |
+| Letter Grade | <!-- A / B / C / D / F --> |
+| Previous Score | <!-- N/A or previous score + date --> |
+| Score Change | <!-- +N / -N / no change --> |
+
+---
+
+## Component Scores
+
+| Component | Raw Score (0–100) | Weight | Weighted Contribution | Grade | Status |
+|---|---|---|---|---|---|
+| AI Citability & Visibility | <!-- N --> | 25% | <!-- N × 0.25 = N --> | <!-- A/B/C/D/F --> | <!-- strong / adequate / weak / data-gap --> |
+| Brand Authority | <!-- N --> | 20% | <!-- N × 0.20 = N --> | <!-- A/B/C/D/F --> | <!-- strong / adequate / weak / data-gap --> |
+| Content Quality & E-E-A-T | <!-- N --> | 20% | <!-- N × 0.20 = N --> | <!-- A/B/C/D/F --> | <!-- strong / adequate / weak / data-gap --> |
+| Technical Foundations | <!-- N --> | 15% | <!-- N × 0.15 = N --> | <!-- A/B/C/D/F --> | <!-- strong / adequate / weak / data-gap --> |
+| Structured Data | <!-- N --> | 10% | <!-- N × 0.10 = N --> | <!-- A/B/C/D/F --> | <!-- strong / adequate / weak / data-gap --> |
+| Platform Optimization | <!-- N --> | 10% | <!-- N × 0.10 = N --> | <!-- A/B/C/D/F --> | <!-- strong / adequate / weak / data-gap --> |
+| **COMPOSITE TOTAL** | | **100%** | **<!-- sum -->** | **<!-- grade -->** | |
+
+---
+
+## Score Narrative
+
+<!-- 3–5 sentence summary grounding the score in actual findings.
+
+Example: "thegrowthub.com scores 68/100 (C) on the GEO Score. The site's strongest component is Technical Foundations (82/100) — HTTPS is enforced, robots.txt is valid, and Core Web Vitals signals are healthy. The primary drag is AI Citability & Visibility (51/100), driven by a missing llms.txt and blanket GPTBot block in robots.txt. Brand Authority is moderate (66/100) — LinkedIn and Twitter/X presence is established, but Wikipedia and GitHub presence is missing. Fixing the crawler access issues alone is projected to add 8–12 points to the composite score." -->
+
+---
+
+## Component Score Visualization
+
+```
+AI Citability & Visibility   [██████████░░░░░░░░░░] <!-- N -->%
+Brand Authority              [████████████░░░░░░░░] <!-- N -->%
+Content Quality & E-E-A-T    [██████████████░░░░░░] <!-- N -->%
+Technical Foundations        [████████████████░░░░] <!-- N -->%
+Structured Data              [████████░░░░░░░░░░░░] <!-- N -->%
+Platform Optimization        [██████████░░░░░░░░░░] <!-- N -->%
+```
+
+---
+
+## Benchmark Comparison
+
+| Metric | This Site | Category Average | Top Quartile |
+|---|---|---|---|
+| Overall GEO Score | <!-- N --> | 58 | 81 |
+| AI Citability | <!-- N --> | 54 | 78 |
+| Crawler Access (of 14) | <!-- N / 14 --> | 9 / 14 | 13 / 14 |
+| Schema Types Present | <!-- N --> | 3 | 7 |
+| llms.txt Present | <!-- yes / no --> | 22% of sites | 100% |
+
+> Benchmark figures are based on geo-seo-claude audit data across audited sites. Category average represents the operator's current client portfolio baseline.
+
+---
+
+## Priority Recommendations
+
+These are the top 3 actions ranked by expected GEO Score impact:
+
+| Rank | Action | Affected Component | Expected Score Gain |
+|---|---|---|---|
+| 1 | <!-- Specific action grounded in findings --> | <!-- Component --> | +<!-- N --> points |
+| 2 | <!-- Specific action grounded in findings --> | <!-- Component --> | +<!-- N --> points |
+| 3 | <!-- Specific action grounded in findings --> | <!-- Component --> | +<!-- N --> points |
+
+**Projected score after top 3 actions:** <!-- N --> / 100 (<!-- grade -->)
+
+---
+
+## What This Score Means
+
+<!-- Paste the appropriate interpretation from docs/scoring-methodology.md based on grade.
+For grade C: "Moderate visibility. You are not capturing significant AI-referred traffic yet. A full remediation roadmap is recommended." -->
+
+---
+
+## Next Steps
+
+- [ ] Review full Remediation Roadmap: `output/<client-slug>/<project-slug>/RemediationRoadmap_v<N>_<YYYYMMDD>.md`
+- [ ] Review Crawler Access Report for specific crawler fixes
+- [ ] Review llms.txt Plan for implementation instructions
+- [ ] Schedule rescore after remediation sprint (recommended: 30 days)

package/assets/worker-kits/growthub-geo-seo-v1/templates/llmstxt-plan.md

@@ -0,0 +1,173 @@
+# llms.txt Plan
+
+> Template: `templates/llmstxt-plan.md`
+> Save output to: `output/<client-slug>/<project-slug>/LlmstxtPlan_v<N>_<YYYYMMDD>.md`
+
+---
+
+## Domain
+
+| Field | Value |
+|---|---|
+| Domain | <!-- https://domain.com --> |
+| Client | <!-- client_name --> |
+| Plan Date | <!-- YYYY-MM-DD --> |
+| Execution Mode | <!-- local-fork / agent-only --> |
+| Auto-generation available | <!-- yes (use scripts/llmstxt_generator.py) / no (manual) --> |
+
+---
+
+## Current Status
+
+| File | Status | URL Checked | Notes |
+|---|---|---|---|
+| `llms.txt` | <!-- exists / missing / malformed --> | `https://domain.com/llms.txt` | <!-- contents summary if exists --> |
+| `llms-full.txt` | <!-- exists / missing --> | `https://domain.com/llms-full.txt` | <!-- contents summary if exists --> |
+
+**Current llms.txt contents (if present):**
+
+```
+<!-- Paste current llms.txt here, or mark as "File not found" -->
+```
+
+---
+
+## Why llms.txt Matters
+
+`llms.txt` is a plain-text file that signals to AI language model crawlers which content on your site is intended to be read, indexed, and cited by AI systems. It follows the pattern of `robots.txt` but is specifically designed for LLM training and retrieval systems.
+
+Sites without `llms.txt` rely on AI crawlers interpreting `robots.txt` rules only — missing an opportunity to explicitly surface high-quality content for AI citation.
+
+---
+
+## Proposed llms.txt
+
+```
+# llms.txt for <!-- domain.com -->
+# Generated: <!-- YYYY-MM-DD -->
+# Documentation: https://llmstxt.org
+
+# === Allowed for all AI systems ===
+User-agent: *
+
+# Primary content for AI training and citation
+Allow: /blog/
+Allow: /resources/
+Allow: /case-studies/
+Allow: /documentation/
+Allow: /about/
+Allow: /services/
+
+# === Explicitly disallow private or non-content paths ===
+Disallow: /admin/
+Disallow: /checkout/
+Disallow: /account/
+Disallow: /api/
+Disallow: /wp-admin/
+Disallow: /search/
+
+# === Content description ===
+# Site-name: <!-- Client Name -->
+# Site-description: <!-- One sentence describing what the site is about -->
+# Primary-language: en
+# Content-types: articles, guides, case studies, product documentation
+# Last-updated: <!-- YYYY-MM-DD -->
+```
+
+---
+
+## Proposed llms-full.txt
+
+`llms-full.txt` is an extended version that provides AI systems with a structured content index — similar to a sitemap but optimized for LLM retrieval.
+
+```
+# llms-full.txt for <!-- domain.com -->
+# Generated: <!-- YYYY-MM-DD -->
+# Full content index for AI language model retrieval
+
+## Site Overview
+- Name: <!-- Client Name -->
+- Domain: <!-- https://domain.com -->
+- Primary Service: <!-- one-line description -->
+- Industry: <!-- industry category -->
+- Language: English
+
+## Primary Content Categories
+
+### Blog / Articles
+- <!-- https://domain.com/blog/ --> — All blog posts and articles
+- <!-- https://domain.com/blog/category-1/ --> — <!-- Category description -->
+- <!-- https://domain.com/blog/category-2/ --> — <!-- Category description -->
+
+### Resources
+- <!-- https://domain.com/resources/ --> — Guides, whitepapers, tools
+- <!-- https://domain.com/resources/guide-1/ --> — <!-- Guide title and description -->
+
+### Services / Products
+- <!-- https://domain.com/services/ --> — Service overview
+- <!-- https://domain.com/services/service-1/ --> — <!-- Service name and description -->
+- <!-- https://domain.com/services/service-2/ --> — <!-- Service name and description -->
+
+### About / Trust
+- <!-- https://domain.com/about/ --> — Company background and team
+- <!-- https://domain.com/case-studies/ --> — Client case studies and results
+
+## Contact
+- <!-- support@domain.com -->
+
+## Sitemap
+- <!-- https://domain.com/sitemap.xml -->
+```
+
+---
+
+## Implementation Steps
+
+| Step | Action | Owner | Tool | Estimated Time |
+|---|---|---|---|---|
+| 1 | Create `llms.txt` file at domain root | <!-- Dev / Content --> | Text editor | 15 min |
+| 2 | Verify file is accessible at `https://domain.com/llms.txt` | <!-- Dev --> | curl or browser | 5 min |
+| 3 | Create `llms-full.txt` with content index | <!-- Content --> | Text editor / generator | 30 min |
+| 4 | Verify `llms-full.txt` accessible | <!-- Dev --> | curl or browser | 5 min |
+| 5 | Add `llms.txt` reference in robots.txt | <!-- Dev --> | Text editor | 5 min |
+| 6 | Re-run crawler access check to confirm access | <!-- Operator --> | `/geo crawlers` | 10 min |
+| 7 | Set calendar reminder to update llms-full.txt monthly | <!-- Owner --> | Calendar | 2 min |
+
+---
+
+## robots.txt Addition
+
+Add this line to `robots.txt` to surface `llms.txt` to AI crawlers:
+
+```
+# AI Content Access
+LLMs-txt: https://<!-- domain.com -->/llms.txt
+```
+
+---
+
+## Auto-generation Command Reference
+
+If the geo-seo-claude fork is available, generate `llms.txt` automatically:
+
+```bash
+# Generate llms.txt from sitemap
+python scripts/llmstxt_generator.py --domain https://domain.com --from-sitemap
+
+# Generate llms-full.txt with content index
+python scripts/llmstxt_generator.py --domain https://domain.com --full
+
+# Preview without writing files
+python scripts/llmstxt_generator.py --domain https://domain.com --dry-run
+```
+
+---
+
+## Maintenance Schedule
+
+| Task | Frequency | Trigger |
+|---|---|---|
+| Update `llms-full.txt` content index | Monthly | New content published |
+| Verify `llms.txt` is still accessible | Weekly (automated) | robots.txt or server change |
+| Review disallow rules | Quarterly | New product areas or pages |
+| Re-run `/geo crawlers` after any change | On change | Any robots.txt or llms.txt edit |

package/assets/worker-kits/growthub-geo-seo-v1/templates/remediation-roadmap.md

@@ -0,0 +1,150 @@
+# Remediation Roadmap
+
+> Template: `templates/remediation-roadmap.md`
+> Save output to: `output/<client-slug>/<project-slug>/RemediationRoadmap_v<N>_<YYYYMMDD>.md`
+
+---
+
+## Client / URL
+
+| Field | Value |
+|---|---|
+| Client | <!-- client_name --> |
+| Target URL | <!-- https://... --> |
+| Roadmap Date | <!-- YYYY-MM-DD --> |
+| Roadmap Owner | <!-- account_owner --> |
+| Overall GEO Score Before | <!-- N / 100 (Grade) --> |
+| Target GEO Score | <!-- N / 100 (Grade) --> |
+| Timeline | <!-- 4-week sprint starting YYYY-MM-DD --> |
+
+---
+
+## Current vs. Target Score
+
+| Component | Current Score | Target Score | Gap |
+|---|---|---|---|
+| AI Citability & Visibility | <!-- N --> | <!-- N --> | <!-- +N --> |
+| Brand Authority | <!-- N --> | <!-- N --> | <!-- +N --> |
+| Content Quality & E-E-A-T | <!-- N --> | <!-- N --> | <!-- +N --> |
+| Technical Foundations | <!-- N --> | <!-- N --> | <!-- +N --> |
+| Structured Data | <!-- N --> | <!-- N --> | <!-- +N --> |
+| Platform Optimization | <!-- N --> | <!-- N --> | <!-- +N --> |
+| **Composite GEO Score** | **<!-- N -->** | **<!-- N -->** | **<!-- +N -->** |
+
+---
+
+## Priority Matrix
+
+Issues are ranked by Impact × Urgency:
+
+| ID | Issue | Component | Impact | Urgency | Priority |
+|---|---|---|---|---|---|
+| R01 | <!-- issue description --> | <!-- component --> | <!-- High / Med / Low --> | <!-- Immediate / Sprint / Backlog --> | P0 |
+| R02 | <!-- issue description --> | <!-- component --> | <!-- High / Med / Low --> | <!-- Immediate / Sprint / Backlog --> | P0 |
+| R03 | <!-- issue description --> | <!-- component --> | <!-- High / Med / Low --> | <!-- Immediate / Sprint / Backlog --> | P1 |
+| R04 | <!-- issue description --> | <!-- component --> | <!-- High / Med / Low --> | <!-- Immediate / Sprint / Backlog --> | P1 |
+| R05 | <!-- issue description --> | <!-- component --> | <!-- High / Med / Low --> | <!-- Immediate / Sprint / Backlog --> | P2 |
+| R06 | <!-- issue description --> | <!-- component --> | <!-- High / Med / Low --> | <!-- Immediate / Sprint / Backlog --> | P2 |
+| R07 | <!-- issue description --> | <!-- component --> | <!-- High / Med / Low --> | <!-- Immediate / Sprint / Backlog --> | P3 |
+
+---
+
+## 4-Week Sprint Plan
+
+### Week 1 — Technical Unblocking and Crawler Access
+
+| # | Action | Issue ID | Owner | Expected Score Impact | Priority |
+|---|---|---|---|---|---|
+| 1.1 | <!-- e.g., Remove GPTBot block from robots.txt --> | R01 | <!-- Dev --> | +<!-- N --> pts (AI Citability) | P0 |
+| 1.2 | <!-- e.g., Create llms.txt at domain root --> | R02 | <!-- Dev / Content --> | +<!-- N --> pts (AI Citability) | P0 |
+| 1.3 | <!-- e.g., Add Sitemap directive to robots.txt --> | R03 | <!-- Dev --> | +<!-- N --> pts (Technical) | P1 |
+| 1.4 | <!-- e.g., Enforce HTTPS redirect from HTTP --> | R04 | <!-- Dev --> | +<!-- N --> pts (Technical) | P1 |
+| 1.5 | <!-- e.g., Add Organization schema to homepage --> | R05 | <!-- Dev --> | +<!-- N --> pts (Structured Data) | P1 |
+
+**Week 1 projected score gain:** +<!-- N --> points (<!-- current → new -->)
+
+---
+
+### Week 2 — Schema and Content Infrastructure
+
+| # | Action | Issue ID | Owner | Expected Score Impact | Priority |
+|---|---|---|---|---|---|
+| 2.1 | <!-- e.g., Add FAQPage schema to top 3 service pages --> | R06 | <!-- Dev --> | +<!-- N --> pts (Structured Data) | P1 |
+| 2.2 | <!-- e.g., Add Article schema to all blog posts --> | R07 | <!-- Dev --> | +<!-- N --> pts (Structured Data) | P2 |
+| 2.3 | <!-- e.g., Rewrite top 5 pages' intro paragraphs for answer-block quality --> | R08 | <!-- Content --> | +<!-- N --> pts (Content) | P2 |
+| 2.4 | <!-- e.g., Add statistical data to 3 thin service pages --> | R09 | <!-- Content --> | +<!-- N --> pts (Content) | P2 |
+| 2.5 | <!-- e.g., Add author byline and bio to all blog posts --> | R10 | <!-- Content --> | +<!-- N --> pts (E-E-A-T) | P2 |
+
+**Week 2 projected score gain:** +<!-- N --> points
+
+---
+
+### Week 3 — E-E-A-T Depth and Citability Optimization
+
+| # | Action | Issue ID | Owner | Expected Score Impact | Priority |
+|---|---|---|---|---|---|
+| 3.1 | <!-- e.g., Publish original research study or data report --> | R11 | <!-- Content --> | +<!-- N --> pts (E-E-A-T) | P2 |
+| 3.2 | <!-- e.g., Add llms-full.txt with content index --> | R12 | <!-- Content / Dev --> | +<!-- N --> pts (AI Citability) | P2 |
+| 3.3 | <!-- e.g., Reduce pronoun-to-noun ratio on 5 key pages --> | R13 | <!-- Content --> | +<!-- N --> pts (Citability) | P2 |
+| 3.4 | <!-- e.g., Add 3 external authority citations per blog post --> | R14 | <!-- Content --> | +<!-- N --> pts (E-E-A-T) | P2 |
+| 3.5 | <!-- e.g., Implement BreadcrumbList schema site-wide --> | R15 | <!-- Dev --> | +<!-- N --> pts (Structured Data) | P2 |
+
+**Week 3 projected score gain:** +<!-- N --> points
+
+---
+
+### Week 4 — Brand Authority and Platform Seeding
+
+| # | Action | Issue ID | Owner | Expected Score Impact | Priority |
+|---|---|---|---|---|---|
+| 4.1 | <!-- e.g., Create and optimize LinkedIn company page --> | R16 | <!-- Marketing --> | +<!-- N --> pts (Brand Authority) | P3 |
+| 4.2 | <!-- e.g., Answer 5 Quora questions in target niche --> | R17 | <!-- Marketing --> | +<!-- N --> pts (Brand Authority) | P3 |
+| 4.3 | <!-- e.g., Post original thread on HackerNews or Reddit --> | R18 | <!-- Marketing --> | +<!-- N --> pts (Brand Authority) | P3 |
+| 4.4 | <!-- e.g., Set up monthly GEO rescore monitoring --> | R19 | <!-- Operator --> | Baseline maintenance | P3 |
+| 4.5 | <!-- e.g., Run /geo audit rescore and compare to baseline --> | R20 | <!-- Operator --> | Measurement | P3 |
+
+**Week 4 projected score gain:** +<!-- N --> points
+
+---
+
+## Quick Wins (This Week — Under 2 Hours Each)
+
+These items require minimal effort and have immediate score impact:
+
+- [ ] **Remove GPTBot block from robots.txt** — unblocks ChatGPT indexing immediately
+- [ ] **Add Sitemap directive to robots.txt** — 5-minute fix, improves Technical score
+- [ ] **Create a basic llms.txt** — 15-minute task, signals AI-crawler intent
+- [ ] **Add Organization JSON-LD to homepage** — copy from Schema Validation report code snippet
+- [ ] **Verify llms.txt is accessible** — `curl https://domain.com/llms.txt`
+
+---
+
+## Medium-Term Actions (Weeks 2–3)
+
+- Schema deployment across all primary page types
+- Content rewrites targeting citability metrics (answer blocks, statistical density)
+- E-E-A-T improvements: author bios, external citations, original data
+
+---
+
+## Strategic Actions (Week 4+)
+
+- Brand authority platform seeding (LinkedIn, Quora, Reddit, HackerNews)
+- Original research publication for uniqueness signals
+- Monthly rescore loop using `/geo audit` to track improvements
+
+---
+
+## Estimated Score After Full Roadmap
+
+| Component | Before | After | Change |
+|---|---|---|---|
+| AI Citability & Visibility | <!-- N --> | <!-- N --> | <!-- +N --> |
+| Brand Authority | <!-- N --> | <!-- N --> | <!-- +N --> |
+| Content Quality & E-E-A-T | <!-- N --> | <!-- N --> | <!-- +N --> |
+| Technical Foundations | <!-- N --> | <!-- N --> | <!-- +N --> |
+| Structured Data | <!-- N --> | <!-- N --> | <!-- +N --> |
+| Platform Optimization | <!-- N --> | <!-- N --> | <!-- +N --> |
+| **Composite GEO Score** | **<!-- N (Grade) -->** | **<!-- N (Grade) -->** | **<!-- +N -->** |
+
+**Rescore date:** <!-- YYYY-MM-DD (30 days from roadmap start) -->

package/assets/worker-kits/growthub-geo-seo-v1/templates/schema-validation.md

@@ -0,0 +1,177 @@
+# Schema Validation Report
+
+> Template: `templates/schema-validation.md`
+> Save output to: `output/<client-slug>/<project-slug>/SchemaValidation_v<N>_<YYYYMMDD>.md`
+
+---
+
+## URL Analyzed
+
+| Field | Value |
+|---|---|
+| Target URL | <!-- https://... --> |
+| Client | <!-- client_name --> |
+| Page Type | <!-- homepage / article / product / local business / other --> |
+| Analysis Date | <!-- YYYY-MM-DD --> |
+| Execution Mode | <!-- local-fork / agent-only --> |
+| Schema Format Found | <!-- JSON-LD / Microdata / RDFa / none --> |
+
+---
+
+## Schema Types Found
+
+| Schema Type | Format | Count | Location | Complete? |
+|---|---|---|---|---|
+| <!-- e.g., Organization --> | <!-- JSON-LD --> | <!-- N --> | <!-- <head> / inline --> | <!-- yes / partial / no --> |
+| <!-- e.g., WebSite --> | <!-- JSON-LD --> | <!-- N --> | <!-- <head> / inline --> | <!-- yes / partial / no --> |
+| <!-- e.g., Article --> | <!-- JSON-LD --> | <!-- N --> | <!-- <head> / inline --> | <!-- yes / partial / no --> |
+| <!-- e.g., BreadcrumbList --> | <!-- JSON-LD --> | <!-- N --> | <!-- <head> / inline --> | <!-- yes / partial / no --> |
+| <!-- e.g., FAQPage --> | <!-- JSON-LD --> | <!-- N --> | <!-- <head> / inline --> | <!-- yes / partial / no --> |
+| <!-- e.g., HowTo --> | <!-- JSON-LD --> | <!-- N --> | <!-- <head> / inline --> | <!-- yes / partial / no --> |
+| <!-- e.g., Product --> | <!-- JSON-LD --> | <!-- N --> | <!-- <head> / inline --> | <!-- yes / partial / no --> |
+| <!-- e.g., LocalBusiness --> | <!-- JSON-LD --> | <!-- N --> | <!-- <head> / inline --> | <!-- yes / partial / no --> |
+
+**Total schema types found:** <!-- N -->
+
+---
+
+## Raw Schema Markup
+
+```json
+// Paste JSON-LD block(s) found on the page, or mark as "No JSON-LD found"
+```
+
+---
+
+## Validation Errors
+
+| Schema Type | Property | Error Type | Severity | Notes |
+|---|---|---|---|---|
+| <!-- e.g., Organization --> | <!-- e.g., `url` --> | <!-- Missing required / Incorrect type / Invalid value --> | <!-- Critical / Warning / Info --> | <!-- description of the error --> |
+| <!-- schema type --> | <!-- property --> | <!-- error type --> | <!-- severity --> | <!-- notes --> |
+| <!-- schema type --> | <!-- property --> | <!-- error type --> | <!-- severity --> | <!-- notes --> |
+
+**Total errors found:** <!-- N critical / N warnings / N info -->
+
+---
+
+## Missing Recommended Schema Types
+
+| Schema Type | Why It Matters | Page Type It Applies To | Priority |
+|---|---|---|---|
+| Organization | Required for brand entity graph — enables Knowledge Panel signals | Homepage | P0 |
+| WebSite | Enables Sitelinks search box in Google; signals site structure to AI | Homepage | P0 |
+| FAQPage | Directly feeds Google AI Overviews and Perplexity answer blocks | FAQ / Service pages | P1 |
+| Article | Required for Google News inclusion and AI content citation | Blog posts | P1 |
+| BreadcrumbList | Improves AI understanding of site hierarchy | All pages | P1 |
+| HowTo | Direct AI-citable structured content for how-to queries | Tutorial pages | P2 |
+| Product | Required for e-commerce AI visibility | Product pages | P2 |
+| LocalBusiness | Required for local AI search and map packs | Location pages | P2 |
+| SpeakableSpecification | Signals to Google which content is suitable for voice / AI reading | Articles | P3 |
+
+> Note: Only list types that apply to this site's actual page types. Remove rows that don't apply.
+
+---
+
+## Schema Coverage Score
+
+| Metric | Value | Notes |
+|---|---|---|
+| Schema types present | <!-- N --> | |
+| Schema types with no errors | <!-- N --> | |
+| Schema types with errors | <!-- N --> | |
+| Coverage completeness | <!-- N% --> | <!-- types complete / total types found --> |
+| Schema score | <!-- 0–100 --> | |
+
+---
+
+## Implementation Priority Table
+
+| Priority | Schema Type | Action | Effort | Expected Impact |
+|---|---|---|---|---|
+| P0 | <!-- type --> | <!-- Add / Fix / Remove --> | <!-- Low / Medium / High --> | <!-- Critical / High --> |
+| P0 | <!-- type --> | <!-- Add / Fix / Remove --> | <!-- Low / Medium / High --> | <!-- Critical / High --> |
+| P1 | <!-- type --> | <!-- Add / Fix / Remove --> | <!-- Low / Medium / High --> | <!-- High --> |
+| P1 | <!-- type --> | <!-- Add / Fix / Remove --> | <!-- Low / Medium / High --> | <!-- High --> |
+| P2 | <!-- type --> | <!-- Add / Fix / Remove --> | <!-- Low / Medium / High --> | <!-- Medium --> |
+| P3 | <!-- type --> | <!-- Add / Fix / Remove --> | <!-- Low / Medium / High --> | <!-- Low --> |
+
+---
+
+## Code Snippets: Recommended Additions
+
+### Organization (add to homepage `<head>`)
+
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "Organization",
+  "name": "<!-- Company Name -->",
+  "url": "<!-- https://domain.com -->",
+  "logo": "<!-- https://domain.com/logo.png -->",
+  "sameAs": [
+    "<!-- https://twitter.com/handle -->",
+    "<!-- https://linkedin.com/company/slug -->",
+    "<!-- https://github.com/org -->"
+  ],
+  "contactPoint": {
+    "@type": "ContactPoint",
+    "contactType": "customer support",
+    "email": "<!-- support@domain.com -->"
+  }
+}
+```
+
+### FAQPage (add to FAQ or service pages)
+
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "FAQPage",
+  "mainEntity": [
+    {
+      "@type": "Question",
+      "name": "<!-- Question 1? -->",
+      "acceptedAnswer": {
+        "@type": "Answer",
+        "text": "<!-- Answer 1. Be specific and self-contained. -->"
+      }
+    },
+    {
+      "@type": "Question",
+      "name": "<!-- Question 2? -->",
+      "acceptedAnswer": {
+        "@type": "Answer",
+        "text": "<!-- Answer 2. Be specific and self-contained. -->"
+      }
+    }
+  ]
+}
+```
+
+### Article (add to blog post pages)
+
+```json
+{
+  "@context": "https://schema.org",
+  "@type": "Article",
+  "headline": "<!-- Article title -->",
+  "author": {
+    "@type": "Person",
+    "name": "<!-- Author Name -->",
+    "url": "<!-- https://domain.com/author/slug -->"
+  },
+  "datePublished": "<!-- YYYY-MM-DD -->",
+  "dateModified": "<!-- YYYY-MM-DD -->",
+  "publisher": {
+    "@type": "Organization",
+    "name": "<!-- Company Name -->",
+    "logo": {
+      "@type": "ImageObject",
+      "url": "<!-- https://domain.com/logo.png -->"
+    }
+  },
+  "image": "<!-- https://domain.com/article-image.jpg -->",
+  "description": "<!-- 155-character description -->"
+}
+```