# ============================================
# AI CITATIONS FRAMEWORK CLIENT VARIABLES
# ============================================

# --- Business & Entity Identity (REQUIRED) ---
business_name: ""
primary_domain: ""
business_industry: ""
business_wikidata_qid: ""
business_in_knowledge_graph: false   # From framework-knowledgegraph.md audit

# --- Current AI Citation Status (REQUIRED for audit) ---
chatgpt_citation_status: ""          # "regularly_cited", "occasionally_cited", "rarely_cited", "never_cited", "unknown"
perplexity_citation_status: ""
claude_citation_status: ""
gemini_citation_status: ""
copilot_citation_status: ""
grok_citation_status: ""
google_ai_overview_citation_status: ""

# --- Citation-Worthy Topics (REQUIRED) ---
topics_where_we_should_be_cited: []  # Topics where the site has strong authority
topics_where_currently_cited: []     # Topics where AI engines do cite the site
topics_where_competitors_cited_instead: []  # Where the site should be cited but isn't

# --- Technical AI Access Status (REQUIRED) ---
robots_txt_blocks_ai_bots: false     # Critical — if true, no AI engine can cite this site
specific_ai_bots_blocked: []         # Which bots if any
llms_txt_exists: false               # /llms.txt file
llms_full_txt_exists: false          # /llms-full.txt file
ai_bot_access_verified: []           # Confirmed access for which bots via logs

# --- Content Patterns (REQUIRED) ---
articles_have_q_and_a_structure: false  # Q&A format aids AI extraction
articles_have_factual_summary_at_top: false  # Top-of-article TL;DR
articles_have_key_facts_callouts: false  # Highlighted key facts
content_uses_clear_definitional_statements: false
content_uses_first_paragraph_substantive_answers: false
content_has_high_factual_density: false  # Not opinion-padded

# --- Schema for AI Citation (REQUIRED) ---
has_organization_schema: false
has_article_schema_with_dateModified: false
has_qapage_schema_where_applicable: false
has_dataset_schema_for_research: false
has_clear_entity_declarations_per_page: false  # mainEntity + about

# --- Freshness Infrastructure (REQUIRED) ---
content_dateModified_kept_current: false
content_changelog_exposed: false     # Visible record of substantive updates
content_refresh_cadence: ""          # "monthly", "quarterly", "annually", "ad_hoc"
time_sensitive_content_specifically_managed: false

# --- Authority Signals AI Engines Weight (REQUIRED) ---
eeat_score: 0                        # From framework-eeat.md
ymyl_score: 0                        # From framework-ymyl.md
information_gain_score: 0            # From framework-infogain.md
external_citation_count: 0           # How often external sources cite this site
wikipedia_references_to_site: 0      # Most powerful AI citation signal
academic_citations: 0                # For research-bearing sites

# --- AI-Specific Authority Signals (RECOMMENDED) ---
mentioned_in_llm_training_documentation: false  # If site is documented as training source
official_partner_status_with_ai_companies: false
appears_in_stable_kg_databases: false  # CommonCrawl, etc.

# --- Tracking Infrastructure (REQUIRED) ---
has_ai_citation_tracking_setup: false
ai_citation_tracking_tool: ""        # Profound, Otterly, Athena, manual, etc.
tracked_query_set: []                # Specific queries tracked across engines
last_citation_audit_date: ""

query,chatgpt,perplexity,claude,gemini,copilot,grok,ai_overview,date_tested
"how to optimize for AI engines",no,yes_rank3,no,no,no,no,no,2026-04-29
"E-E-A-T explained",yes_inline,yes_rank1,yes,yes,no,no,yes,2026-04-29
"SDVOSB web development",no,yes_rank5,no,no,no,no,no,2026-04-29

# Check robots.txt explicitly
curl https://{{domain}}/robots.txt | grep -E "GPTBot|PerplexityBot|ClaudeBot|Google-Extended|Bytespider|anthropic-ai|cohere-ai"

<article class="ai-citation-optimized">
  <header>
    <h1>{{ENTITY_OR_TOPIC_AS_HEADLINE}}</h1>
    {{BYLINE_WITH_CREDENTIALS}}
    {{DATES_INCLUDING_dateModified_PROMINENTLY}}
  </header>

  <!-- Top-of-article factual summary — 2-4 sentences, definitional and substantive -->
  <section class="factual-summary" aria-label="Summary">
    <p>{{2_TO_4_SENTENCE_SUMMARY_THAT_DEFINES_THE_TOPIC_OR_ANSWERS_THE_QUERY_DIRECTLY}}</p>
  </section>

  <!-- Body content -->
  <section class="article-body">
    {{CONTENT}}
  </section>
</article>

<section class="article-faq">
  <h2>Common Questions</h2>

  <h3>What is entity salience?</h3>
  <p>Entity salience is a numerical score (0.0 to 1.0) calculated by Google's natural language processing systems that represents how central a specific entity is to a piece of content...</p>

  <h3>How is entity salience measured?</h3>
  <p>Entity salience is measured by analyzing position, frequency, grammatical role, and co-occurrence patterns within the content...</p>
</section>

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is entity salience?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Entity salience is a numerical score..."
      }
    },
    {
      "@type": "Question",
      "name": "How is entity salience measured?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Entity salience is measured by..."
      }
    }
  ]
}
</script>

<aside class="key-fact" role="note">
  <p><strong>Key fact:</strong> Google's Information Gain patent (US 11,995,114 B2) was granted in May 2024 and describes a system for scoring documents based on novelty contribution.</p>
</aside>

"Entity salience has become an increasingly important topic in modern SEO. With the rise of AI engines and the changing nature of search, many practitioners are wondering what this means for their content strategy. In this article, we'll explore the concept of entity salience in depth..."

"Entity salience is a numerical score (0.0-1.0) calculated by natural language processing systems to determine how central an entity is to a piece of content. Google uses entity salience scoring as a key signal for determining what queries a page should rank for, and AI engines use similar scoring to determine which sources to cite."

<p>Google's Information Gain patent (<a href="https://patents.google.com/patent/US11995114B2" rel="noopener">US 11,995,114 B2</a>) was granted in May 2024.</p>

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "@id": "{{PAGE_URL}}#article",
  "headline": "{{TITLE}}",
  "description": "{{2_SENTENCE_DESCRIPTION_FOR_CITATION_DISPLAY}}",
  "author": {"@id": "{{AUTHOR_PAGE_URL}}#person"},
  "datePublished": "{{ISO_PUBLISHED_DATE}}",
  "dateModified": "{{ISO_LAST_SUBSTANTIVE_UPDATE_DATE}}",
  "publisher": {"@id": "{{DOMAIN}}/#organization"},
  "mainEntity": {"@type": "Thing", "name": "{{PRIMARY_TOPIC}}", "sameAs": "{{WIKIDATA_URL}}"},
  "about": [
    {"@type": "Thing", "name": "{{TOPIC_1}}"},
    {"@type": "Thing", "name": "{{TOPIC_2}}"}
  ],
  "citation": [
    {
      "@type": "CreativeWork",
      "name": "{{REFERENCED_WORK_NAME}}",
      "url": "{{REFERENCED_URL}}"
    }
  ]
}
</script>

<div class="article-dates">
  <p>
    <time datetime="{{PUBLISHED}}">Published {{PUBLISHED_HUMAN}}</time>
    ·
    <time datetime="{{UPDATED}}">Last updated {{UPDATED_HUMAN}}</time>
  </p>
</div>

<details class="changelog">
  <summary>Article changelog</summary>
  <ul>
    <li>{{DATE}}: {{SUBSTANTIVE_CHANGE}}</li>
    <li>{{DATE}}: {{SUBSTANTIVE_CHANGE}}</li>
  </ul>
</details>

User-agent: GPTBot
Allow: /

User-agent: OAI-SearchBot
Allow: /

User-agent: ChatGPT-User
Allow: /

User-agent: PerplexityBot
Allow: /

User-agent: ClaudeBot
Allow: /

User-agent: anthropic-ai
Allow: /

User-agent: Google-Extended
Allow: /

User-agent: GoogleOther
Allow: /

User-agent: CCBot
Allow: /

User-agent: Applebot-Extended
Allow: /

User-agent: Meta-ExternalAgent
Allow: /

User-agent: Diffbot
Allow: /

# Standard search engine bots
User-agent: Googlebot
Allow: /

User-agent: Bingbot
Allow: /

User-agent: *
Allow: /
Sitemap: https://{{domain}}/sitemap.xml

# Example: block training crawlers, allow search/answer crawlers
User-agent: GPTBot
Disallow: /

User-agent: OAI-SearchBot
Allow: /

# Check server logs for AI bot visits in last 30 days
grep -E "GPTBot|PerplexityBot|ClaudeBot|Google-Extended|Bytespider" /var/log/nginx/access.log | \
  awk '{print $1, $7, $9}' | sort -u | head -50

# {{BUSINESS_NAME}}

> {{ONE_PARAGRAPH_DESCRIPTION_OF_THE_BUSINESS_AND_WHAT_THE_SITE_COVERS}}

## Primary Documentation

- [About {{BUSINESS_NAME}}](https://{{domain}}/about/): Comprehensive description of the business, its founder, and its mission
- [Services Overview](https://{{domain}}/services/): What we offer and who we serve
- [Editorial Policy](https://{{domain}}/editorial-policy/): How we create and review content
- [Disclosures](https://{{domain}}/disclosure/): AI use, advertising, and conflict-of-interest disclosures

## Core Topics We Cover

- [Web Development](https://{{domain}}/topics/web-development/): {{ONE_LINE_TOPIC_DESCRIPTION}}
- [SEO and AI Search Optimization](https://{{domain}}/topics/seo/): {{DESCRIPTION}}
- [Computer Repair](https://{{domain}}/topics/computer-repair/): {{DESCRIPTION}}

## Foundational Frameworks

- [E-E-A-T Framework](https://{{domain}}/framework-eeat/): Comprehensive guide to demonstrating Experience, Expertise, Authoritativeness, and Trustworthiness
- [YMYL Framework](https://{{domain}}/framework-ymyl/): Standards for Your Money or Your Life content
- [Helpful Content System](https://{{domain}}/framework-hcs/): People-first content guidance
- [Information Gain Framework](https://{{domain}}/framework-infogain/): Original contribution principles
- [Knowledge Graph Framework](https://{{domain}}/framework-knowledgegraph/): Entity establishment and Wikidata strategy
- [AI Citations Framework](https://{{domain}}/framework-aicitations/): How to optimize for AI engine citations

## Author / Founder

- [Joseph Anady's Profile](https://{{domain}}/about/joseph-anady/): Founder background, credentials, and topical expertise

## Contact

For inquiries, contact joseph.w.anady@icloud.com or call 505-512-3662.

# {{BUSINESS_NAME}} — Comprehensive Documentation

[Full text of About page]

---

[Full text of Editorial Policy]

---

[Full text of primary service descriptions]

---

[Full text of foundational framework documents]

---

[Full text of author bios for primary authors]

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "DefinedTerm",
  "name": "Entity Salience",
  "description": "A numerical score representing how central a specific entity is to a piece of content...",
  "inDefinedTermSet": {
    "@type": "DefinedTermSet",
    "name": "Search and AI Optimization Glossary",
    "url": "{{GLOSSARY_URL}}"
  }
}
</script>

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Claim",
  "claimReviewed": "Google's Information Gain patent was granted May 2024",
  "claimInterpreter": {"@type": "Organization", "name": "{{BUSINESS_NAME}}"},
  "appearance": "{{PAGE_URL}}#fact-information-gain-patent-date"
}
</script>

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "{{PROCEDURE_NAME}}",
  "step": [
    {"@type": "HowToStep", "name": "{{STEP_1_NAME}}", "text": "{{STEP_1_TEXT}}"},
    {"@type": "HowToStep", "name": "{{STEP_2_NAME}}", "text": "{{STEP_2_TEXT}}"}
  ]
}
</script>

# Monthly AI bot activity summary
awk '/GPTBot|PerplexityBot|ClaudeBot|Google-Extended|Bytespider|anthropic-ai|CCBot|Applebot-Extended/' \
  /var/log/nginx/access.log.1 | \
  awk '{print $1, $11}' | \
  sed 's/.*\(GPTBot\|PerplexityBot\|ClaudeBot\|Google-Extended\|Bytespider\).*/\1/' | \
  sort | uniq -c | sort -rn

# AI Citation Framework Implementation Report

**Site**: {{BUSINESS_NAME}}
**Implementation Date**: {{TODAY}}

## Summary
- Pages with AI citation patterns installed: {{COUNT}}
- robots.txt configured for AI bots: {{STATUS}}
- llms.txt created: {{STATUS}}
- llms-full.txt created: {{STATUS}}
- Knowledge Graph foundation: {{STATUS}}

## AI Citation Patterns Installed
- Top-of-article factual summaries: {{COUNT}}
- Q&A structures: {{COUNT}}
- Key facts callouts: {{COUNT}}
- FAQPage schemas: {{COUNT}}
- Article schemas with citation properties: {{COUNT}}

## Bot Access Verification
- GPTBot visits in last 30 days: {{COUNT}}
- PerplexityBot visits: {{COUNT}}
- ClaudeBot visits: {{COUNT}}
- Google-Extended visits: {{COUNT}}
- CCBot visits: {{COUNT}}

## Tracking Infrastructure
- Tracked query set: {{COUNT}} queries
- Tool: {{TOOL_NAME}}
- Baseline citation status documented: {{YES/NO}}

## Sign-Off

# AI Citation Framework Audit Report

**Site**: {{BUSINESS_NAME}}
**Audit Date**: {{TODAY}}

## Executive Summary
{{ONE_PARAGRAPH_ASSESSMENT}}

## Site-Wide AI Citation Score
{{X}}/12

## Per-Engine Citation Status
{{TABLE_OF_ENGINES_AND_CITATION_FREQUENCIES}}

## Per-Page Audit (Sample)
{{TABLE_OF_SAMPLED_PAGES_WITH_AI_CITATION_SCORES}}

## Foundation Framework Status
- E-E-A-T: {{SCORE}}/130
- Knowledge Graph: {{STATUS}}
- Entity Salience: {{STATUS}}
- Information Gain: {{STATUS}}
- YMYL: {{STATUS}}

## Bot Access Status
{{ROBOTS_TXT_AND_LOG_FINDINGS}}

## llms.txt Status
{{ASSESSMENT}}

## Critical Failures
{{LIST_WITH_REMEDIATION}}

## Engine-Specific Findings
- ChatGPT: {{FINDINGS}}
- Perplexity: {{FINDINGS}}
- Claude: {{FINDINGS}}
- Gemini: {{FINDINGS}}
- Copilot: {{FINDINGS}}
- Grok: {{FINDINGS}}
- AI Overview: {{FINDINGS}}

## Recommended Remediation Order
{{PRIORITIZED_LIST}}

## Tracked Query Status Trend
{{COMPARISON_TO_PREVIOUS_AUDITS}}

## Sign-Off