@growthub/cli 0.3.52 → 0.3.53

package/assets/worker-kits/growthub-geo-seo-v1/templates/citability-analysis.md

@@ -0,0 +1,131 @@
+# Citability Analysis
+
+> Template: `templates/citability-analysis.md`
+> Save output to: `output/<client-slug>/<project-slug>/CitabilityAnalysis_v<N>_<YYYYMMDD>.md`
+
+---
+
+## URL Audited
+
+| Field | Value |
+|---|---|
+| Target URL | <!-- https://... --> |
+| Client | <!-- client_name --> |
+| Analysis Date | <!-- YYYY-MM-DD --> |
+| Execution Mode | <!-- local-fork / agent-only --> |
+| Script Used | <!-- scripts/citability_scorer.py / manual --> |
+
+---
+
+## Citability Score
+
+| Metric | Value |
+|---|---|
+| Raw Score | <!-- 0–100 --> |
+| Letter Grade | <!-- A / B / C / D / F --> |
+| Percentile Estimate | <!-- e.g., "Top 28% of audited pages" --> |
+| Score Date | <!-- YYYY-MM-DD --> |
+| Previous Score | <!-- N/A or previous score + date --> |
+
+---
+
+## Component Breakdown
+
+| Metric | Raw Score (0–100) | Weight | Weighted Score | Status |
+|---|---|---|---|---|
+| Answer Block Quality | <!-- score --> | 30% | <!-- score × 0.30 --> | <!-- strong / adequate / weak --> |
+| Self-Containment | <!-- score --> | 25% | <!-- score × 0.25 --> | <!-- strong / adequate / weak --> |
+| Structural Readability | <!-- score --> | 20% | <!-- score × 0.20 --> | <!-- strong / adequate / weak --> |
+| Statistical Density | <!-- score --> | 15% | <!-- score × 0.15 --> | <!-- strong / adequate / weak --> |
+| Uniqueness Signals | <!-- score --> | 10% | <!-- score × 0.10 --> | <!-- strong / adequate / weak --> |
+| **TOTAL** | | **100%** | <!-- sum --> | |
+
+---
+
+## Answer Block Quality Detail
+
+**Score: <!-- N/A → fill -->**
+
+Paragraphs evaluated: <!-- count -->
+
+| Paragraph # | Subject Clear | Evidence Present | No Unresolved Pronouns | Score |
+|---|---|---|---|---|
+| 1 | <!-- yes/no --> | <!-- yes/no --> | <!-- yes/no --> | <!-- 0–10 --> |
+| 2 | <!-- yes/no --> | <!-- yes/no --> | <!-- yes/no --> | <!-- 0–10 --> |
+| 3 | <!-- yes/no --> | <!-- yes/no --> | <!-- yes/no --> | <!-- 0–10 --> |
+
+**Best answerable paragraph:**
+> <!-- quote the strongest paragraph verbatim -->
+
+**Weakest paragraph (needs rewrite):**
+> <!-- quote the weakest paragraph verbatim -->
+
+---
+
+## Self-Containment Check
+
+| Signal | Value | Status |
+|---|---|---|
+| Total word count | <!-- N --> | <!-- good (>800) / low (<300) --> |
+| Pronoun count | <!-- N --> | |
+| Noun count | <!-- N --> | |
+| Pronoun-to-noun ratio | <!-- N:N --> | <!-- good (<0.3) / moderate / poor (>0.6) --> |
+| Optimal word count range | 800–2,500 words | |
+| Contextual dependency score | <!-- 0–100 --> | <!-- lower is better --> |
+
+---
+
+## Structural Readability Check
+
+| Signal | Status | Notes |
+|---|---|---|
+| H1 present | <!-- yes / no --> | <!-- H1 text if present --> |
+| H2 count | <!-- N --> | <!-- ≥2 recommended --> |
+| H3 count | <!-- N --> | |
+| Numbered lists | <!-- yes / no --> | <!-- count --> |
+| Bulleted lists | <!-- yes / no --> | <!-- count --> |
+| Average paragraph length | <!-- N words --> | <!-- ≤150 recommended --> |
+| Wall-of-text sections | <!-- yes / no --> | <!-- describe if yes --> |
+
+---
+
+## Statistical Density Check
+
+| Signal | Value | Status |
+|---|---|---|
+| Percentage references | <!-- N --> | |
+| Numbered data points | <!-- N --> | |
+| Dollar/currency figures | <!-- N --> | |
+| Year/date references | <!-- N --> | |
+| Data points per 1,000 words | <!-- N.N --> | <!-- optimal: 8–15 --> |
+| Statistical density score | <!-- 0–100 --> | |
+
+---
+
+## Uniqueness Signals Check
+
+| Signal | Present | Example |
+|---|---|---|
+| First-party study or research | <!-- yes / no --> | <!-- excerpt --> |
+| Proprietary data references | <!-- yes / no --> | <!-- excerpt --> |
+| Original methodology | <!-- yes / no --> | <!-- excerpt --> |
+| Unique terminology | <!-- yes / no --> | <!-- excerpt --> |
+| Non-generic claims | <!-- yes / no --> | <!-- excerpt --> |
+
+---
+
+## Key Findings
+
+1. <!-- Most impactful finding — what is driving the score up or down most -->
+2. <!-- Second finding -->
+3. <!-- Third finding -->
+
+---
+
+## Top 3 Improvements
+
+| Priority | Action | Expected Score Gain | Effort |
+|---|---|---|---|
+| 1 | <!-- Specific action, e.g., "Rewrite intro paragraph to remove 4 unresolved pronouns" --> | +<!-- N --> points | <!-- Low / Medium / High --> |
+| 2 | <!-- Specific action --> | +<!-- N --> points | <!-- Low / Medium / High --> |
+| 3 | <!-- Specific action --> | +<!-- N --> points | <!-- Low / Medium / High --> |

package/assets/worker-kits/growthub-geo-seo-v1/templates/client-proposal.md

@@ -0,0 +1,172 @@
+# Client Proposal — GEO + SEO Audit Engagement
+
+> Template: `templates/client-proposal.md`
+> Save output to: `output/<client-slug>/<project-slug>/ClientProposal_v<N>_<YYYYMMDD>.md`
+
+---
+
+## Prospect
+
+| Field | Value |
+|---|---|
+| Company | <!-- company_name --> |
+| Website | <!-- https://domain.com --> |
+| Industry | <!-- industry --> |
+| Contact | <!-- contact_name, title --> |
+| Proposal Date | <!-- YYYY-MM-DD --> |
+| Prepared By | <!-- account_owner --> |
+| Proposal Valid Until | <!-- YYYY-MM-DD (30 days) --> |
+
+---
+
+## GEO Audit Summary
+
+We ran a preliminary GEO (Generative Engine Optimization) scan on `<!-- domain.com -->`. Here is what we found at a glance:
+
+| Metric | Score | Grade | Benchmark Average |
+|---|---|---|---|
+| Overall GEO Score | <!-- N / 100 --> | <!-- A/B/C/D/F --> | 58 / 100 |
+| AI Citability | <!-- N / 100 --> | <!-- grade --> | 54 / 100 |
+| Crawler Access | <!-- N / 14 crawlers --> | | 9 / 14 |
+| Schema Coverage | <!-- N types found --> | | 3 types |
+| llms.txt Present | <!-- yes / no --> | | 22% of sites |
+
+---
+
+## Why GEO Matters Now
+
+AI search is changing where traffic comes from.
+
+- **70%+ of zero-click searches** now end in an AI-generated answer — no site visit required unless your content is cited.
+- **ChatGPT has 200M+ weekly active users** using Browse mode to research products, services, and vendors.
+- **Perplexity AI** now drives measurable referral traffic for sites it cites — and its citations are determined by citability score, not traditional backlinks.
+- **Google AI Overviews** appear in 30–40% of searches across informational and commercial queries.
+- Sites with a GEO Score above 75 receive **3–5× more AI-referred traffic** than sites scoring below 55 (geo-seo-claude audit data, Q1 2026).
+
+If your site is not optimized for AI search visibility today, you are leaving your competitors to capture that traffic instead.
+
+---
+
+## Current Visibility Gap
+
+Based on our preliminary scan of `<!-- domain.com -->`:
+
+**What AI systems can access:**
+- <!-- e.g., "8 of 14 AI crawlers have explicit access — GPTBot and ClaudeBot are currently blocked" -->
+
+**What AI systems can cite:**
+- <!-- e.g., "Citability score of 41/100 — most pages contain unresolved pronoun references and lack statistical density" -->
+
+**Structured data gaps:**
+- <!-- e.g., "No FAQPage, Article, or Organization schema detected — Google AI Overviews cannot surface structured answers" -->
+
+---
+
+## What We Found — 3 Critical Issues
+
+### Issue 1: <!-- Title of Critical Issue -->
+<!-- 2–3 sentence description of the issue, why it matters, what it is costing the client in AI search visibility -->
+
+**Impact:** AI systems that encounter this issue will <!-- skip / deprioritize / misrepresent --> your content.
+
+### Issue 2: <!-- Title of Critical Issue -->
+<!-- 2–3 sentence description -->
+
+**Impact:** <!-- specific impact statement -->
+
+### Issue 3: <!-- Title of Critical Issue -->
+<!-- 2–3 sentence description -->
+
+**Impact:** <!-- specific impact statement -->
+
+---
+
+## Recommended Engagement
+
+### Option A — Quick GEO Audit
+**Best for:** Initial discovery, prospect qualification, or proof-of-concept before a larger engagement.
+
+| Deliverable | Details |
+|---|---|
+| GEO Score Snapshot | Composite score with all 6 components |
+| Top 3 Critical Gaps | Prioritized issues with fix instructions |
+| Quick Wins Checklist | Under-2-hour fixes to unblock crawlers |
+| Delivery Format | Markdown report |
+| Turnaround | 48 hours |
+
+**Investment:** $<!-- X,XXX -->
+
+---
+
+### Option B — Full GEO + SEO Audit
+**Best for:** Clients ready to act on AI search visibility with a complete remediation plan.
+
+| Deliverable | Details |
+|---|---|
+| Full GEO Score Report | All 6 components, all 14 crawlers |
+| Citability Analysis | 5-metric breakdown with specific page rewrites |
+| Crawler Access Report | Full robots.txt + llms.txt review and plan |
+| Brand Visibility Report | 8-platform scan |
+| Schema Validation | Full structured data review with code snippets |
+| Technical Foundations | Server headers, Core Web Vitals signals |
+| llms.txt Plan | Custom llms.txt and llms-full.txt files ready to deploy |
+| Remediation Roadmap | 4-week sprint with owner assignments |
+| PDF Report | Branded deliverable for stakeholder presentation |
+| Turnaround | 5–7 business days |
+
+**Investment:** $<!-- X,XXX -->
+
+---
+
+### Option C — Monthly GEO Monitoring + Remediation Retainer
+**Best for:** Clients who want ongoing AI search visibility management and continuous improvement.
+
+| Included Monthly | Details |
+|---|---|
+| GEO Rescore | Full audit run each month — track score changes |
+| Remediation Sprint | Up to N hours of implementation support |
+| Content Citability Reviews | Up to N pages reviewed and improved per month |
+| Brand Authority Tasks | Platform seeding, mention monitoring |
+| Monthly Report | Score trend, wins, next month plan |
+| Slack / Email Access | Async support during business hours |
+
+**Investment:** $<!-- X,XXX --> / month
+**Minimum term:** 3 months
+
+---
+
+## ROI Projection
+
+Based on the current GEO Score and the identified gaps, here is the projected traffic impact of completing the Full Audit remediation roadmap:
+
+| Metric | Current State | After Remediation | Change |
+|---|---|---|---|
+| GEO Score | <!-- N --> | <!-- N --> | +<!-- N --> points |
+| AI-referred traffic (est.) | <!-- baseline % of total --> | <!-- projected % --> | +<!-- N -->% |
+| Pages citable by AI systems | <!-- N pages --> | <!-- N pages --> | +<!-- N --> pages |
+| Crawlers with full access | <!-- N / 14 --> | <!-- N / 14 --> | +<!-- N --> crawlers |
+
+> Projection based on geo-seo-claude audit data across comparable sites. Actual results depend on implementation quality and content volume.
+
+---
+
+## Next Steps
+
+1. **Review and sign** the proposal by <!-- YYYY-MM-DD -->
+2. **Kickoff call** (30 min) — we confirm the target URL, scope, and delivery format
+3. **Audit begins** — operator initiates `/geo audit` with your domain
+4. **Delivery** — all artifacts delivered to your inbox within the agreed turnaround
+
+To proceed, reply to this proposal or email <!-- account_owner@thegrowthub.com -->.
+
+---
+
+## Guarantee / Risk Reversal
+
+If we complete the Full GEO Audit and you don't receive a remediation roadmap with at least 10 actionable items grounded in real page data, we will refund your investment in full.
+
+We do not produce generic SEO advice. Every finding is backed by data from your actual pages, your robots.txt, and your live site structure.
+
+---
+
+*Prepared by <!-- account_owner --> · Growthub · <!-- YYYY-MM-DD -->*

package/assets/worker-kits/growthub-geo-seo-v1/templates/content-analysis.md

@@ -0,0 +1,136 @@
+# Content Analysis
+
+> Template: `templates/content-analysis.md`
+> Save output to: `output/<client-slug>/<project-slug>/ContentAnalysis_v<N>_<YYYYMMDD>.md`
+
+---
+
+## URL Analyzed
+
+| Field | Value |
+|---|---|
+| Target URL | <!-- https://... --> |
+| Client | <!-- client_name --> |
+| Page Type | <!-- homepage / blog post / service page / landing page / other --> |
+| Analysis Date | <!-- YYYY-MM-DD --> |
+| Execution Mode | <!-- local-fork / agent-only --> |
+| Word Count | <!-- N words --> |
+
+---
+
+## E-E-A-T Assessment
+
+| Signal | Signals Found | Score (0–10) | Notes |
+|---|---|---|---|
+| **Experience** | <!-- first-person examples, case studies, original data points --> | <!-- N --> | <!-- what was found / what is missing --> |
+| **Expertise** | <!-- author byline, credentials, About page depth, domain expertise signals --> | <!-- N --> | <!-- what was found / what is missing --> |
+| **Authoritativeness** | <!-- external citations, backlinks from authority domains, Wikipedia mentions, industry recognition --> | <!-- N --> | <!-- what was found / what is missing --> |
+| **Trustworthiness** | <!-- HTTPS, contact info, privacy policy, review count, schema Trust signals --> | <!-- N --> | <!-- what was found / what is missing --> |
+
+**E-E-A-T Composite Score:** <!-- N / 40 → normalize to N / 100 --> / 100
+
+---
+
+## Experience Signals Detail
+
+| Signal | Present | Example / Location |
+|---|---|---|
+| First-person case study | <!-- yes / no --> | <!-- URL or excerpt --> |
+| Original data or research | <!-- yes / no --> | <!-- URL or excerpt --> |
+| Personal experience narrative | <!-- yes / no --> | <!-- URL or excerpt --> |
+| Before/after examples | <!-- yes / no --> | <!-- URL or excerpt --> |
+| Named results with specifics | <!-- yes / no --> | <!-- URL or excerpt --> |
+
+---
+
+## Expertise Signals Detail
+
+| Signal | Present | Example / Location |
+|---|---|---|
+| Author byline with name | <!-- yes / no --> | <!-- name found --> |
+| Author credentials visible | <!-- yes / no --> | <!-- title, bio, link --> |
+| Deep domain terminology | <!-- yes / no --> | <!-- examples --> |
+| Source citations (external) | <!-- yes / no --> | <!-- N citations found --> |
+| Expert quotes (attributed) | <!-- yes / no --> | <!-- N quotes found --> |
+
+---
+
+## Answer Block Analysis
+
+**Total paragraphs evaluated:** <!-- N -->
+
+**Answer-block eligible paragraphs:** <!-- N --> (paragraphs that AI can quote verbatim)
+
+| Block | First 20 Words | Self-Contained | Has Data | AI-Quotable |
+|---|---|---|---|---|
+| Block 1 | <!-- excerpt --> | <!-- yes / no --> | <!-- yes / no --> | <!-- yes / no --> |
+| Block 2 | <!-- excerpt --> | <!-- yes / no --> | <!-- yes / no --> | <!-- yes / no --> |
+| Block 3 | <!-- excerpt --> | <!-- yes / no --> | <!-- yes / no --> | <!-- yes / no --> |
+| Block 4 | <!-- excerpt --> | <!-- yes / no --> | <!-- yes / no --> | <!-- yes / no --> |
+
+**Most citable paragraph:**
+> <!-- Quote the strongest answer block verbatim -->
+
+---
+
+## Self-Containment Check
+
+| Metric | Value | Target | Status |
+|---|---|---|---|
+| Total word count | <!-- N --> | 800–2,500 | <!-- on target / below / above --> |
+| Pronouns (it, they, this, that, these) | <!-- N instances --> | | |
+| Nouns (named entities + common) | <!-- N instances --> | | |
+| Pronoun-to-noun ratio | <!-- N:N --> | <0.3 for good citability | <!-- good / moderate / poor --> |
+| Self-containment score | <!-- 0–100 --> | | |
+
+---
+
+## Statistical Density
+
+| Metric | Value | Target Range | Status |
+|---|---|---|---|
+| Percentage figures | <!-- N instances --> | | |
+| Specific numbers / measurements | <!-- N instances --> | | |
+| Dollar / currency figures | <!-- N instances --> | | |
+| Year / date references | <!-- N instances --> | | |
+| Named statistics | <!-- N instances --> | | |
+| **Data points per 1,000 words** | <!-- N.N --> | **8–15** | <!-- below / optimal / above --> |
+| Statistical density score | <!-- 0–100 --> | | |
+
+---
+
+## Uniqueness Signals
+
+| Signal | Present | Strength | Example |
+|---|---|---|---|
+| First-party research | <!-- yes / no --> | <!-- strong / weak --> | <!-- excerpt --> |
+| Proprietary methodology | <!-- yes / no --> | <!-- strong / weak --> | <!-- excerpt --> |
+| Non-generic claims | <!-- yes / no --> | <!-- strong / weak --> | <!-- excerpt --> |
+| Original terminology | <!-- yes / no --> | <!-- strong / weak --> | <!-- excerpt --> |
+| Competitive differentiation statement | <!-- yes / no --> | <!-- strong / weak --> | <!-- excerpt --> |
+
+**Uniqueness score:** <!-- 0–100 -->
+
+---
+
+## Content Quality Score
+
+| Component | Score (0–100) | Weight | Weighted Score |
+|---|---|---|---|
+| E-E-A-T composite | <!-- N --> | 35% | <!-- N × 0.35 --> |
+| Answer block quality | <!-- N --> | 25% | <!-- N × 0.25 --> |
+| Statistical density | <!-- N --> | 20% | <!-- N × 0.20 --> |
+| Uniqueness signals | <!-- N --> | 20% | <!-- N × 0.20 --> |
+| **TOTAL** | | **100%** | <!-- sum --> |
+
+---
+
+## Top 5 Content Gaps
+
+| Gap | Impact | Recommended Fix | Effort |
+|---|---|---|---|
+| <!-- gap description --> | <!-- High / Medium / Low --> | <!-- specific action --> | <!-- Low / Medium / High --> |
+| <!-- gap description --> | <!-- High / Medium / Low --> | <!-- specific action --> | <!-- Low / Medium / High --> |
+| <!-- gap description --> | <!-- High / Medium / Low --> | <!-- specific action --> | <!-- Low / Medium / High --> |
+| <!-- gap description --> | <!-- High / Medium / Low --> | <!-- specific action --> | <!-- Low / Medium / High --> |
+| <!-- gap description --> | <!-- High / Medium / Low --> | <!-- specific action --> | <!-- Low / Medium / High --> |

package/assets/worker-kits/growthub-geo-seo-v1/templates/crawler-access-report.md

@@ -0,0 +1,115 @@
+# Crawler Access Report
+
+> Template: `templates/crawler-access-report.md`
+> Save output to: `output/<client-slug>/<project-slug>/CrawlerAccessReport_v<N>_<YYYYMMDD>.md`
+
+---
+
+## URL Audited
+
+| Field | Value |
+|---|---|
+| Target Domain | <!-- https://domain.com --> |
+| robots.txt URL | <!-- https://domain.com/robots.txt --> |
+| robots.txt Found | <!-- yes / no / error --> |
+| llms.txt URL | <!-- https://domain.com/llms.txt --> |
+| llms.txt Found | <!-- yes / no --> |
+| Client | <!-- client_name --> |
+| Analysis Date | <!-- YYYY-MM-DD --> |
+| Execution Mode | <!-- local-fork / agent-only --> |
+
+---
+
+## robots.txt Raw Excerpt
+
+```
+<!-- Paste the full contents of robots.txt here, or mark as "Not found" -->
+```
+
+---
+
+## Crawler Permission Matrix
+
+| AI Crawler | User-Agent String | robots.txt Status | Access Level | Notes |
+|---|---|---|---|---|
+| GPTBot | `GPTBot` | <!-- Allowed / Blocked / Not mentioned --> | <!-- Full / Partial / None --> | <!-- any specific Disallow paths --> |
+| ClaudeBot | `ClaudeBot` | <!-- Allowed / Blocked / Not mentioned --> | <!-- Full / Partial / None --> | <!-- notes --> |
+| PerplexityBot | `PerplexityBot` | <!-- Allowed / Blocked / Not mentioned --> | <!-- Full / Partial / None --> | <!-- notes --> |
+| Google-Extended | `Google-Extended` | <!-- Allowed / Blocked / Not mentioned --> | <!-- Full / Partial / None --> | <!-- notes --> |
+| Bingbot | `Bingbot` | <!-- Allowed / Blocked / Not mentioned --> | <!-- Full / Partial / None --> | <!-- notes --> |
+| Applebot-Extended | `Applebot-Extended` | <!-- Allowed / Blocked / Not mentioned --> | <!-- Full / Partial / None --> | <!-- notes --> |
+| Anthropic-AI | `anthropic-ai` | <!-- Allowed / Blocked / Not mentioned --> | <!-- Full / Partial / None --> | <!-- notes --> |
+| cohere-ai | `cohere-ai` | <!-- Allowed / Blocked / Not mentioned --> | <!-- Full / Partial / None --> | <!-- notes --> |
+| Meta-ExternalFetcher | `meta-externalagent` | <!-- Allowed / Blocked / Not mentioned --> | <!-- Full / Partial / None --> | <!-- notes --> |
+| YouBot | `YouBot` | <!-- Allowed / Blocked / Not mentioned --> | <!-- Full / Partial / None --> | <!-- notes --> |
+| DuckAssistBot | `DuckAssistBot` | <!-- Allowed / Blocked / Not mentioned --> | <!-- Full / Partial / None --> | <!-- notes --> |
+| Scrapy | `Scrapy` | <!-- Allowed / Blocked / Not mentioned --> | <!-- Full / Partial / None --> | <!-- notes --> |
+| CCBot | `CCBot` | <!-- Allowed / Blocked / Not mentioned --> | <!-- Full / Partial / None --> | <!-- notes --> |
+| ia_archiver | `ia_archiver` | <!-- Allowed / Blocked / Not mentioned --> | <!-- Full / Partial / None --> | <!-- notes --> |
+
+---
+
+## Access Level Summary
+
+| Access Level | Count | Crawlers |
+|---|---|---|
+| Full access | <!-- N --> | <!-- list --> |
+| Partial access (some paths blocked) | <!-- N --> | <!-- list --> |
+| Blocked | <!-- N --> | <!-- list --> |
+| Not mentioned (defaults to allowed) | <!-- N --> | <!-- list --> |
+
+---
+
+## llms.txt Status
+
+| Item | Status | Notes |
+|---|---|---|
+| `llms.txt` present | <!-- yes / no --> | |
+| `llms-full.txt` present | <!-- yes / no --> | |
+| Format valid | <!-- yes / no / n/a --> | <!-- describe any issues --> |
+| AI model sections defined | <!-- yes / no / n/a --> | <!-- which models listed --> |
+| Disallow entries present | <!-- yes / no / n/a --> | <!-- what is blocked --> |
+| Last modified (if detectable) | <!-- date or unknown --> | |
+
+---
+
+## llms.txt Contents (if present)
+
+```
+<!-- Paste full llms.txt contents here, or mark as "File not found" -->
+```
+
+---
+
+## X-Robots-Tag Header
+
+| Header | Value | Impact |
+|---|---|---|
+| `X-Robots-Tag` | <!-- value or "not set" --> | <!-- none / blocks indexing / noai --> |
+| `noai` directive present | <!-- yes / no --> | <!-- blocks AI crawlers if yes --> |
+| `noimageai` directive present | <!-- yes / no --> | <!-- blocks AI image training if yes --> |
+
+---
+
+## Summary
+
+**Crawler access score:** <!-- N / 14 crawlers with full access --> (<!-- % -->)
+
+**Critical issues:**
+- <!-- any blocked crawlers that matter most, e.g., GPTBot or ClaudeBot -->
+- <!-- any blanket wildcard blocks: "User-agent: * Disallow: /" -->
+
+**Positive signals:**
+- <!-- any correct explicit Allow rules for AI crawlers -->
+- <!-- llms.txt present and valid -->
+
+---
+
+## Recommended Actions
+
+| Priority | Action | Effort | Impact |
+|---|---|---|---|
+| P0 | <!-- e.g., "Remove blanket Disallow for GPTBot" --> | Low | Critical |
+| P1 | <!-- e.g., "Create llms.txt at domain root" --> | Medium | High |
+| P2 | <!-- e.g., "Verify Bingbot access after robots.txt update" --> | Low | Medium |
+| P3 | <!-- e.g., "Add llms-full.txt with content index" --> | Medium | Low |

package/assets/worker-kits/growthub-geo-seo-v1/templates/geo-audit-brief.md

@@ -0,0 +1,114 @@
+# GEO Audit Brief
+
+> Template: `templates/geo-audit-brief.md`
+> Save output to: `output/<client-slug>/<project-slug>/GeoAuditBrief_v<N>_<YYYYMMDD>.md`
+
+---
+
+## Project Overview
+
+| Field | Value |
+|---|---|
+| Client | <!-- client_name from brand kit --> |
+| Target URL | <!-- target_url from brand kit --> |
+| Audit Scope | <!-- quick / citability-only / full / specific command --> |
+| Execution Mode | <!-- local-fork / agent-only / hybrid --> |
+| Primary Command | <!-- /geo audit / /geo quick / /geo citability / etc. --> |
+| Requested By | <!-- account_owner --> |
+| Date | <!-- YYYY-MM-DD --> |
+| Brand Kit | <!-- brands/<client-slug>/brand-kit.md --> |
+| Project Slug | <!-- <project-slug> --> |
+
+---
+
+## Audit Objective
+
+<!-- 2–4 sentences describing what this audit is intended to answer.
+Example: "Determine whether thegrowthub.com is discoverable and citable by major AI search platforms including ChatGPT, Perplexity, and Google AI Overviews. Identify the top 3 structural barriers to AI citability and produce a prioritized remediation roadmap." -->
+
+---
+
+## Current Visibility Context
+
+**Known strengths:**
+- <!-- any existing SEO wins, content depth, known rankings -->
+- <!-- schema types already implemented, if known -->
+
+**Known concerns:**
+- <!-- any reported traffic drops, AI search gaps, crawler warnings -->
+- <!-- previous audit findings, if any -->
+
+**Prior audit outputs:**
+| Date | Audit Type | Output Location |
+|---|---|---|
+| <!-- YYYY-MM-DD --> | <!-- type --> | <!-- output/path --> |
+
+---
+
+## Competitor Reference URLs
+
+| Competitor | URL | Notes |
+|---|---|---|
+| <!-- Competitor 1 --> | <!-- https://... --> | <!-- why included --> |
+| <!-- Competitor 2 --> | <!-- https://... --> | <!-- why included --> |
+| <!-- Competitor 3 --> | <!-- https://... --> | <!-- why included --> |
+
+---
+
+## Existing Assets
+
+| Asset | Status | Location |
+|---|---|---|
+| robots.txt | <!-- present / missing / check needed --> | <!-- URL --> |
+| sitemap.xml | <!-- present / missing / check needed --> | <!-- URL --> |
+| llms.txt | <!-- present / missing / check needed --> | <!-- URL --> |
+| llms-full.txt | <!-- present / missing / check needed --> | <!-- URL --> |
+| Existing schema markup | <!-- JSON-LD / Microdata / none --> | <!-- page(s) --> |
+| Previous GEO report | <!-- yes / no --> | <!-- output/path --> |
+
+---
+
+## Command Selection Plan
+
+**Primary command:** `<!-- /geo command -->`
+
+**Rationale:** <!-- why this command was selected over alternatives -->
+
+**Secondary commands (if full audit):**
+
+| Command | Purpose | Sequence |
+|---|---|---|
+| `/geo audit` | Full composite audit | 1 |
+| `/geo crawlers` | AI crawler permission check | 2 |
+| `/geo brands` | Brand authority scan | 3 |
+| `/geo schema` | Structured data validation | 4 |
+| `/geo technical` | Technical health check | 5 |
+| `/geo llmstxt` | llms.txt generation plan | 6 |
+| `/geo report` | Final Markdown report | 7 |
+
+---
+
+## Delivery Requirements
+
+| Requirement | Value |
+|---|---|
+| Delivery format | <!-- Markdown / PDF / both --> |
+| PDF report needed | <!-- yes / no --> |
+| Client-facing proposal | <!-- yes / no --> |
+| Output deadline | <!-- date or ASAP --> |
+| Stakeholder recipient | <!-- name / email --> |
+
+---
+
+## Success Criteria
+
+<!-- What does a successful audit look like for this client? -->
+
+- [ ] GEO Score composite produced with all 6 components scored
+- [ ] Crawler access status confirmed for all 14 AI crawlers
+- [ ] Citability analysis completed with letter grade assigned
+- [ ] At least 5 actionable remediation items identified and prioritized
+- [ ] llms.txt plan produced (even if existing file is valid)
+- [ ] Remediation roadmap covers 4-week sprint with owner assignments
+- [ ] All output files saved to `output/<client-slug>/<project-slug>/`
+- [ ] Brand kit DELIVERABLES LOG updated